Date.prototype.setUTCFullYear()

La méthode setUTCFullYear() définit l'année complête pour la date, selon UTC.

Syntaxe

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

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

Spécifications

Spécification État Commentaires
ECMAScript 1st Edition (ECMA-262) Standard Définition initiale. Implémentée avec JavaScript 1.3.
ECMAScript 5.1 (ECMA-262)
La définition de 'Date.prototype.setUTCFullYear' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Date.prototype.setUTCFullYear' dans cette spécification.
Standard  
ECMAScript 2017 Draft (ECMA-262)
La définition de 'Date.prototype.setUTCFullYear' 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)

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, teoli, tregagnon
 Dernière mise à jour par : SphinxKnight,