CKTIS / JavaScript
Date.UTC: componenti UTC in timestamp
Date.UTC interpreta componenti numerici come UTC, li normalizza e restituisce millisecondi dall’epoca senza creare un Date.
Versione: ECMAScript 1 onward; example target: Node.js 24.22.2
Sintassi
Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, milliseconds?)Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, ms?) restituisce un Number di millisecondi dall’epoca. monthIndex parte da zero; i valori predefiniti sono mese 0, giorno 1 e campi orari 0. Gli anni 0–99 sono mappati appositamente su 1900–1999. Crea un oggetto con new Date(Date.UTC(...)).
Valori fuori dai loro intervalli naturali sono normalizzati: mese 12 diventa gennaio successivo e giorno 0 la fine del mese precedente. Dopo ToNumber e TimeClip, valore non finito, anno obbligatorio omesso o risultato fuori ±8.64e15 produce NaN. BigInt e Symbol generano TypeError.
Come metodo statico Date.UTC non usa il fuso locale. Gli argomenti aggiuntivi sono ignorati e la funzione non è un costruttore. Esiste da ECMAScript 1.
Esempi
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()));Risultato
1709209800000 2024-02-29T12:30:00.000Z true 1999-01-01T00:00:00.000Z true