Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Date.prototype.toISOString : texte UTC canonique

toISOString renvoie un texte date-time UTC canonique avec millisecondes et Z final.

Version : ECMAScript 5 (2009) onward; example target: Node.js 24.22.2

Syntaxe

date.toISOString()

date.toISOString() renvoie le format ISO 8601 simplifié en UTC : YYYY-MM-DDTHH:mm:ss.sssZ. Les années ordinaires donnent 24 caractères ; hors de 0000–9999, un signe et six chiffres en donnent 27. La méthode n’utilise pas le fuseau local et ne modifie pas l’objet.

Pour un Date invalide ou une année impossible à représenter dans le format requis, elle lève RangeError ; elle ne renvoie pas "Invalid Date". Un receiver sans état interne Date lève TypeError. La méthode ne prend aucun argument et ignore les arguments supplémentaires.

Le format convient aux échanges et peut être relu par Date.parse. Il ne conserve ni nom de fuseau ni décalage d’origine, seulement le même instant exprimé en UTC. La méthode est standard depuis ECMAScript 5 (2009).

Exemples

const date = new Date(Date.UTC(2024, 1, 29, 12, 34, 56, 789));
console.log(date.toISOString());
console.log(new Date(-1).toISOString());
try { new Date(NaN).toISOString(); } catch (error) { console.log(error instanceof RangeError); }

Résultat

2024-02-29T12:34:56.789Z
1969-12-31T23:59:59.999Z
true

Sources