Date.prototype.setFullYear()

La méthode setFullYear() définit l'année complête pour une date, d'après l'heure locale.

Syntaxe

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

Paramètres

valeurAnnée
Un entier indiquant la valeur numérique de l'année, par exemple, 1995.
valeurMois
Paramètre optionnel qui représente un entier entre 0 et 11, représentant les mois de janvier à décembre.
valeurJour
Paramètre optionnel qui représente un entier entre 1 et 31 représentant le jour du mois. Si vous indiquez une valeurJour, vous devez aussi 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 vous n'indiquez pas les paramètres valeurMois et valeurJour. Les valeurs renvoyées par les méthodes getMonth() et getDate() seront utilisées.

Si un des paramètres que vous indiquez est en dehors des limites attendues, setFullYear() tentera de mettre à jour la date en conséquence. Pa exemple, si vous indiquez 15 pour valeurMois, l'année sera incrémenté de 1 (année + 1), et 3 sera utilisé pour le mois.

Exemples

Utiliser setFullYear()

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

Spécifications

Spécification Statut 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.setFullYear' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Date.prototype.setFullYear' dans cette spécification.
Standard  
ECMAScript (ECMA-262)
La définition de 'Date.prototype.setFullYear' dans cette spécification.
Standard évolutif  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
setFullYearChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 4Opera Support complet 4Safari Support complet 1WebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 1Samsung Internet Android Support complet 1.0nodejs Support complet 0.1.100

Légende

Support complet  
Support complet

Voir aussi