KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Date.prototype.toISOString: canonieke UTC-tekst

toISOString geeft canonieke UTC-datum-tijdtekst met milliseconden en een afsluitende Z.

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

Syntax

date.toISOString()

date.toISOString() geeft het vereenvoudigde ISO-8601-formaat in UTC: YYYY-MM-DDTHH:mm:ss.sssZ. Gewone jaren leveren 24 tekens; buiten 0000–9999 worden teken en zes cijfers gebruikt, samen 27. De methode gebruikt geen lokale tijdzone en wijzigt het object niet.

Voor een ongeldige Date of een jaar dat niet in het vereiste formaat past, werpt ze RangeError; ze geeft niet "Invalid Date". Een receiver zonder interne Date-status werpt TypeError. De methode heeft geen argumenten en negeert extra argumenten.

Het formaat is geschikt voor gegevensuitwisseling en kan opnieuw door Date.parse worden gelezen. Het bewaart geen zonenaam of oorspronkelijke offset, alleen hetzelfde tijdstip in UTC. De methode is standaard sinds ECMAScript 5 (2009).

Voorbeelden

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); }

Resultaat

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

Bronnen