CKTIS / JavaScript
Date.UTC: UTC компоненти към времеви печат
Date.UTC тълкува числови компоненти като UTC, нормализира ги и връща милисекунди от епохата без да създава Date.
Версия: ECMAScript 1 onward; example target: Node.js 24.22.2
Синтаксис
Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, milliseconds?)Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, ms?) връща Number милисекунди от епохата. monthIndex започва от нула; по подразбиране месецът е 0, денят 1, а времевите полета 0. Години 0–99 специално се преобразуват в 1900–1999. Обект се прави с new Date(Date.UTC(...)).
Стойности извън естествените диапазони се нормализират: месец 12 минава в януари на следващата година, а ден 0 в края на предишния месец. След ToNumber и TimeClip безкрайна стойност, липсваща задължителна година или резултат извън ±8.64e15 дава NaN. BigInt и Symbol хвърлят TypeError.
Като статичен метод Date.UTC не използва местната зона. Допълнителните аргументи се игнорират и функцията не е конструктор. Съществува от ECMAScript 1.
Примери
const timestamp = Date.UTC(2024, 1, 29, 12, 30);
console.log(timestamp, new Date(timestamp).toISOString());
console.log(Date.UTC(2024, 12, 1) === Date.UTC(2025, 0, 1));
console.log(new Date(Date.UTC(99, 0, 1)).toISOString());
console.log(Number.isNaN(Date.UTC()));Резултат
1709209800000 2024-02-29T12:30:00.000Z true 1999-01-01T00:00:00.000Z true