Date : méthode getUTCFullYear()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode getUTCFullYear() des instances de Date retourne l'année de la date renseignée selon le temps universel (UTC).
Exemple interactif
const date1 = new Date("December 31, 1975, 23:15:30 GMT+11:00");
const date2 = new Date("December 31, 1975, 23:15:30 GMT-11:00");
console.log(date1.getUTCFullYear());
// Résultat attendu : 1975
console.log(date2.getUTCFullYear());
// Résultat attendu : 1976
Syntaxe
getUTCFullYear()
Paramètres
Aucun.
Valeur de retour
Un entier représentant l'année pour la date indiquée selon le temps universel. Retourne NaN si la date est invalide.
Description
Contrairement à getYear(), la valeur retournée par getUTCFullYear() est un nombre absolu. Pour les dates comprises entre les années 1000 et 9999, getFullYear() retourne un nombre à quatre chiffres, par exemple 1995. Utilisez cette fonction pour vous assurer qu'une année est conforme aux années postérieures à 2000.
Exemples
Utiliser la méthode getUTCFullYear()
L'exemple suivant assigne une valeur à 4 chiffres, l'année courante, à la variable annee.
const aujourdhui = new Date();
const annee = aujourdhui.getUTCFullYear();
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.getutcfullyear |
Compatibilité des navigateurs
Voir aussi
- La méthode
Date.prototype.getFullYear() - La méthode
Date.prototype.setFullYear()