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