Date : méthode setUTCMonth()

Exemple interactif

const event = new Date("December 31, 1975 23:15:30 GMT-3:00");

console.log(event.toUTCString());
// Résultat attendu : "Thu, 01 Jan 1976 02:15:30 GMT"

console.log(event.getUTCMonth());
// Résultat attendu : 0

event.setUTCMonth(11);

console.log(event.toUTCString());
// Résultat attendu : "Wed, 01 Dec 1976 02:15:30 GMT"

Syntaxe

setUTCMonth(monthValue)
setUTCMonth(monthValue, dateValue)

Paramètres

monthValue

Un entier représentant le mois : 0 pour janvier, 1 pour février, etc.

dateValue Facultatif

Un entier de 1 à 31 représentant le jour du mois.

Valeur de retour

Modifie l'objet Date en place et retourne son nouveau timestamp. Si un paramètre vaut NaN (ou d'autres valeurs qui sont contraintes en NaN, comme undefined), la date est définie sur Date invalide et NaN est retourné.

Description

Si vous ne définissez pas le paramètre dateValue, la valeur retournée par la méthode getUTCDate() est utilisée.

Si un paramètre que vous définissez est en dehors de la plage attendue, setUTCMonth() tente de mettre à jour les informations de date dans l'objet Date en conséquence. Par exemple, si vous utilisez 15 pour monthValue, l'année sera incrémentée de 1, et 3 sera utilisé pour le mois.

Exemples

Utiliser la méthode setUTCMonth()

const leGrandJour = new Date();
leGrandJour.setUTCMonth(11);

Spécifications

Compatibilité des navigateurs

Voir aussi

• La méthode Date.prototype.getUTCMonth()
• La méthode Date.prototype.setMonth()