База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Date.prototype.toISOString: каноничен UTC текст

toISOString връща каноничен UTC текст за дата и час с милисекунди и завършващо Z.

Версия: ECMAScript 5 (2009) onward; example target: Node.js 24.22.2

Синтаксис

date.toISOString()

date.toISOString() връща опростения формат ISO 8601 в UTC: YYYY-MM-DDTHH:mm:ss.sssZ. Обикновените години дават 24 знака; извън 0000–9999 се използват знак и шест цифри, общо 27. Методът не използва местната зона и не променя обекта.

За невалиден Date или година, непредставима в изисквания формат, хвърля RangeError; не връща "Invalid Date". Receiver без вътрешно състояние Date хвърля TypeError. Методът няма аргументи и игнорира допълнителните.

Форматът е подходящ за обмен на данни и Date.parse го прочита отново. Не запазва име на зона или първоначално отместване, а същия момент в UTC. Стандартен е от ECMAScript 5 (2009).

Примери

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

Резултат

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

Източници