Méthode setUTCFullYear() de JavaScript Date

Définition et utilisation

setUTCFullYear() La méthode définit et utilise la méthode setUTCFullYear() de JavaScript Date pour définir l'année de l'objet date (un chiffre à quatre chiffres entre 1000 et 9999).

Conseil :L'heure universelle coordinée (UTC) est l'heure définie par le standard de l'heure mondiale.

Remarque :L'heure universelle coordinée (UTC) est la même que l'heure Greenwich (GMT).

Exemple

Exemple 1

Définir l'année à 1992 :

var d = new Date();
d.setUTCFullYear(1992);

Essayer par vous-même

Exemple 2

Définir la date au 3 novembre 2020 :

var d = new Date();
d.setUTCFullYear(2020, 10, 3);

Essayer par vous-même

Exemple 3

Définir la date il y a six mois, en temps UTC :

var d = new Date();
d.setUTCFullYear(d.getUTCFullYear, d.getUTCMonth() - 6);

Essayer par vous-même

Syntaxe

Date.setUTCFullYear(year, month, day)

Valeur du paramètre

Paramètres Description
year Obligatoire. Valeur représentant l'année, autorise les valeurs négatives.
month

Optionnel. Entier représentant le mois.

La valeur attendue est de 0-11, mais d'autres valeurs sont autorisées :

  • -1 entraînera le dernier mois de l'année précédente
  • 12 entraînera le premier mois de l'année suivante
  • 13 entraînera le deuxième mois de l'année suivante
day

Obligatoire. Entier, représentant un jour dans un mois.

La valeur attendue est de 1-31, mais d'autres valeurs sont autorisées :

  • 0 entraînera le dernier jour du mois précédent
  • -1 entraînera le dernier jour du mois précédent précédent

Si un mois a 31 jours :

  • 32 entraînera le premier jour du mois suivant

Si un mois a 30 jours :

  • 32 entraînera le deuxième jour du mois suivant

Détails techniques

Valeur de retour : Nombre, objet date et nombre de millisecondes entre minuit du 1er janvier 1970.
Version JavaScript : ECMAScript 1

Support du navigateur

Méthode Chrome IE Firefox Safari Opera
setUTCFullYear() Support Support Support Support Support

Pages associées

Tutoriel :Date JavaScript

Tutoriel :Format des dates JavaScript

Tutoriel :Méthodes de mise en forme des dates JavaScript