CKTIS / JavaScript
Date.UTC: složky UTC na časovou značku
Date.UTC vyloží číselné složky jako UTC, normalizuje je a vrátí milisekundy od epochy bez vytvoření Date.
Verze: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntaxe
Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, milliseconds?)Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, ms?) vrací Number milisekund od epochy. monthIndex začíná nulou; výchozí je měsíc 0, den 1 a časová pole 0. Roky 0–99 se zvlášť mapují na 1900–1999. Objekt vytvoříte přes new Date(Date.UTC(...)).
Hodnoty mimo přirozené rozsahy se normalizují: měsíc 12 přejde do ledna dalšího roku a den 0 na konec předchozího měsíce. Po ToNumber a TimeClip nekonečná hodnota, chybějící povinný rok nebo výsledek mimo ±8.64e15 dá NaN. BigInt a Symbol vyvolají TypeError.
Jako statická metoda Date.UTC nepoužívá místní pásmo. Další argumenty ignoruje a není konstruktorem. Existuje od ECMAScript 1.
Příklady
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()));Výsledek
1709209800000 2024-02-29T12:30:00.000Z true 1999-01-01T00:00:00.000Z true