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

js
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()

js
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 GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
setFullYear

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi