Date.prototype.setUTCFullYear()
La méthode setUTCFullYear()
définit l'année complête pour la date, selon UTC.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
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'indiquervaleurMois
.
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 (ECMA-262) La définition de 'Date.prototype.setUTCFullYear' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser
Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.