CKTIS / JavaScript
Date.prototype.toISOString: kanoniczny tekst UTC
toISOString zwraca kanoniczny tekst date-time w UTC z milisekundami i końcowym Z.
Wersja: ECMAScript 5 (2009) onward; example target: Node.js 24.22.2
Składnia
date.toISOString()date.toISOString() zwraca uproszczony format ISO 8601 w UTC: YYYY-MM-DDTHH:mm:ss.sssZ. Zwykłe lata dają 24 znaki; lata poza 0000–9999 używają znaku i sześciu cyfr, więc wynik ma 27 znaków. Metoda nie używa lokalnej strefy i nie zmienia obiektu.
Dla niepoprawnego Date lub roku, którego nie da się zapisać w wymaganym formacie, rzuca RangeError; nie zwraca "Invalid Date". Receiver bez wewnętrznego stanu Date powoduje TypeError. Metoda nie przyjmuje argumentów, a dodatkowe są ignorowane.
Format jest bezpieczny do wymiany danych i może być ponownie odczytany przez Date.parse. Nie przechowuje nazwy strefy ani pierwotnego offsetu, tylko tę samą chwilę w UTC. Metoda jest standardowa od ECMAScript 5 (2009).
Przykłady
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); }Wynik
2024-02-29T12:34:56.789Z 1969-12-31T23:59:59.999Z true