Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła