Date.prototype.setMonth()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

Exemple interactif

const event = new Date("August 19, 1975 23:15:30");

event.setMonth(3);

console.log(event.getMonth());
// Expected output: 3

console.log(event);
// Expected output: "Sat Apr 19 1975 23:15:30 GMT+0100 (CET)"
// Note: your timezone may vary

Syntaxe

js
dateObj.setMonth(valeurMois[, valeurJour])

Versions antérieures à JavaScript 1.3

js
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 :

js
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()

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

Spécifications

Specification
ECMAScript® 2025 Language Specification
# sec-date.prototype.setmonth

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
setMonth

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi