Date : méthode setUTCFullYear()

Exemple interactif

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

console.log(event.getUTCFullYear());
// Résultat attendu : 1976

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

event.setUTCFullYear(1975);

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

Syntaxe

setUTCFullYear(yearValue)
setUTCFullYear(yearValue, monthValue)
setUTCFullYear(yearValue, monthValue, dateValue)

Paramètres

yearValue

Un entier représentant l'année. Par exemple, 1995.

monthValue Facultatif

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

dateValue Facultatif

Un entier compris entre 1 et 31 représentant le jour du mois. Si vous définissez dateValue, vous devez aussi définir monthValue.

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 les paramètres monthValue et dateValue, les valeurs retournées par les méthodes getUTCMonth() et getUTCDate() sont utilisées.

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

Exemples

Utiliser le module setUTCFullYear()

const leGrandJour = new Date();
leGrandJour.setUTCFullYear(1997);

Spécifications

Compatibilité des navigateurs

Voir aussi

• Le module Date.prototype.getUTCFullYear()
• Le module Date.prototype.setFullYear()