Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Date.UTC: komponente UTC v časovni žig

Date.UTC razume številske komponente kot UTC, jih normalizira in vrne milisekunde od epohe brez ustvarjanja Date.

Različica: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintaksa

Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, milliseconds?)

Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, ms?) vrne Number milisekund od epohe. monthIndex se začne z nič; privzeti so mesec 0, dan 1 in časovna polja 0. Leta 0–99 se posebej preslikajo v 1900–1999. Objekt ustvarite z new Date(Date.UTC(...)).

Vrednosti zunaj naravnih obsegov se normalizirajo: mesec 12 preide v januar naslednjega leta in dan 0 na konec prejšnjega meseca. Po ToNumber in TimeClip neskončna vrednost, manjkajoče obvezno leto ali rezultat zunaj ±8.64e15 da NaN. BigInt in Symbol sprožita TypeError.

Kot statična metoda Date.UTC ne uporablja krajevnega pasu. Dodatni argumenti se prezrejo in funkcija ni konstruktor. Obstaja od ECMAScript 1.

Primeri

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

Rezultat

1709209800000 2024-02-29T12:30:00.000Z
true
1999-01-01T00:00:00.000Z
true

Viri