Date.prototype.setFullYear()
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 setFullYear()
définit l'année complête pour une date, d'après l'heure locale.
Exemple interactif
const event = new Date("August 19, 1975 23:15:30");
event.setFullYear(1969);
console.log(event.getFullYear());
// Expected output: 1969
event.setFullYear(0);
console.log(event.getFullYear());
// Expected output: 0
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 indiquervaleurMois
.
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
Specification |
---|
ECMAScript® 2025 Language Specification # sec-date.prototype.setfullyear |
Compatibilité des navigateurs
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
setFullYear |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support