Date.prototype.setUTCFullYear()

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 setUTCFullYear() définit l'année complête pour la date, selon UTC.

Exemple interactif

Syntaxe

js
dateObj.setUTCFullYear(valeurAnnée[, valeurMois[, valeurJour]])

Paramètres

valeurAnnée

Un entier indiquant la valeur numérique d'une année, par exemple, 1995.

valeurMois

Paramètre optionnel, 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. Si le paramètre valeurJour est utilisé, il est également nécessaire d'indiquer valeurMois.

Valeur de retour

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

Description

Si les paramètres valeurMois et valeurJour ne sont pas utilisés, les valeurs renvoyées par les méthodes getUTCMonth() et getUTCDate() seront utilisées.

Si un des paramètres indiqué est en dehors des limites attendues, setUTCFullYear() tentera de mettre à jour la date en conséquence. Ainsi si on utilise la valeur 15 pour valeurMois, l'année sera incrémentée de 1 (année + 1), et 3 sera utilisé pour le mois.

Exemples

Utiliser setUTCFullYear()

js
var leGrandJour = new Date();
leGrandJour.setUTCFullYear(1997);

Spécifications

Specification
ECMAScript Language Specification
# sec-date.prototype.setutcfullyear

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi