CKTIS / JavaScript
Date.UTC: UTC-componenten naar tijdstempel
Date.UTC interpreteert numerieke componenten als UTC, normaliseert ze en geeft epochmilliseconden zonder een Date te maken.
Versie: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntax
Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, milliseconds?)Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, ms?) geeft een Number epochmilliseconden. monthIndex begint bij nul; standaard zijn maand 0, dag 1 en tijdvelden 0. Jaren 0–99 worden speciaal naar 1900–1999 vertaald. Maak een object met new Date(Date.UTC(...)).
Waarden buiten natuurlijke bereiken worden genormaliseerd: maand 12 wordt januari van het volgende jaar en dag 0 het einde van de vorige maand. Na ToNumber en TimeClip levert een niet-eindige waarde, ontbrekend verplicht jaar of resultaat buiten ±8.64e15 NaN op. BigInt en Symbol werpen TypeError.
Als statische methode gebruikt Date.UTC geen lokale tijdzone. Extra argumenten worden genegeerd en de functie is geen constructor. Ze bestaat sinds ECMAScript 1.
Voorbeelden
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()));Resultaat
1709209800000 2024-02-29T12:30:00.000Z true 1999-01-01T00:00:00.000Z true