Date.prototype.setFullYear()
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 <code>setFullYear()</code>
var leGrandJour = new Date();
leGrandJour.setFullYear(1997);