We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

La méthode setMonth() définit le mois de la date, selon l'heure locale et l'année courante de l'objet Date

Syntaxe

dateObj.setMonth(valeurMois[, valeurJour])

Versions antérieures à JavaScript 1.3

dateObj.setMonth(valeurMois)

Paramètres

valeurMois
Un entier entre 0 et 11 (représentant les mois de janvier à décembre).
valeurJour
Paramètre optionnel, un entier entre 1 et 31, représentant le jour du mois.

Valeur de retour

Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.

Description

Si le paramètre valeurJour n'est pas utilisé, la valeur renvoyée par la méthode getDate() sera utilisée.

Si un paramètre que vous renseignez n'est pas dans les limites attendues, setMonth() tentera de mettre à jour la date en conséquence. Par exemple, si la valeur 15 est utilisée pour valeurMois, l'année sera incrémenté de 1 (année + 1), et 3 sera utilisé pour le mois.

Note : Attention aux jours du mois lorsqu'on utilise setMonth(). En effet, setMonth() cherchera à aboutir à une date correcte et on peut avoir des surprises pour les transitions entre les mois. Ainsi, en 2016 (où février a eu 29 jours), on aura le cas suivant :

var finDuMois = new Date(2016, 7, 31); // le 31 août 2016
finDuMois.setMonth(1);

console.log(finDuMois.toLocaleString()); // 02/03/2016 à 00:00:00

Exemples

Utiliser setMonth()

var leGrandJour = new Date();
leGrandJour.setMonth(6);

Spécifications

Spécification État Commentaires
ECMAScript 1st Edition (ECMA-262) Standard Définition initiale. Implémentée avec JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
La définition de 'Date.prototype.setMonth' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Date.prototype.setMonth' dans cette spécification.
Standard  
ECMAScript Latest Draft (ECMA-262)
La définition de 'Date.prototype.setMonth' dans cette spécification.
Projet  

Compatibilité des navigateurs

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple Oui Oui1 Oui Oui Oui
FonctionnalitéAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Support simple Oui Oui Oui4 Oui Oui Oui

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : SphinxKnight, teoli, tregagnon
Dernière mise à jour par : SphinxKnight,