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 2017 Draft (ECMA-262) La définition de 'Date.prototype.setMonth' dans cette spécification. |
Projet |
Compatibilité des navigateurs
Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Support simple | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) |
Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Support simple | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) |