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

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

Източници