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
const event = new Date("December 31, 1975 23:15:30 GMT-3:00");
console.log(event.getUTCFullYear());
// Expected output: 1976
console.log(event.toUTCString());
// Expected output: "Thu, 01 Jan 1976 02:15:30 GMT"
event.setUTCFullYear(1975);
console.log(event.toUTCString());
// Expected output: "Wed, 01 Jan 1975 02:15:30 GMT"
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
Specification |
---|
ECMAScript® 2025 Language Specification # sec-date.prototype.setutcfullyear |
Compatibilité des navigateurs
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
setUTCFullYear |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support