Date.UTC()

Il metodo Date.UTC() accetta gli stessi parametri del costruttore Date, ma li tratta come UTC. Restituisce  il numero di millisecondi fin dal Gennaio 1, 1970, 00:00:00 UTC.

Sintassi

ECMAScript 2017 e successivi:

Date.UTC(year[, month[, day[, hour[, minute[, second[, millisecond]]]]]])

ECMAScript 2016 e anteriori: (utilizzo di month richiesto)

Date.UTC(year, month[, day[, hour[, minute[, second[, millisecond]]]]])

Parametri

year
Un anno intero.
month
Un integer tra 0 (Gennaio) e 11 (Dicembre) rappresentante il mese. (Fino a ECMAScript 2016, month era un parametro richiesto. Con ES2017, non lo è più.)
day Optional
Opzionalel. Un integer tra 1 e 31 rappresentante il giorno del mese. Se omesso, è predefinito a 1.
hour Optional
Un integer tra  0 e 23 rappresentante le ore. Se omesso è predefinito a 0.
minute Optional
Un  integer tra 0 e 59 rappresentante i minuti.  Se omesso, è predefinito a 0.
second Optional
Un integer tra  0 e 59 rappresentante i secondi. Se omesso, è predefinito a 0.
millisecond Optional
Un  integer tra 0 e 999 rappresentante i millisecondi. Se omesso, è predefinito a 0.

Valore di ritorno

Un numero rappresentante i umeri di millisecondi per la data fornita sin dal Gennaio 1, 1970, 00:00:00, UTC.

Descrizione

UTC() prende date delimitate da virgola e parametri tempo e restituisce il numero di millisecondi tra Gennaio 1, 1970, 00:00:00, tempo universale ed il tempo e la data specificata.

Gli anni tra 0 e 99 sono convertiti ad un anno nel 20mo secolo(1900 + year); per esempio, 95 è convertito  all'anno 1995.

Il metodo UTC() differisce dal costruttore Date in due modi.

  • Date.UTC() utilizza il tempo universale invece di quello locale.
  • Date.UTC() restituisce un valore di tempo come numero invece di creare un oggetto Date.

Se un parametro è fuori dal range previsto, il metodo UTC() aggiorna gli altri parametri per adattare il valore. Per esempio, se 15 è usato per il mese, l'anno sarà incrementato di 1 (year + 1) e 3 sarà usato per il mese.

UTC() è un metodo statico di Date, per questo è chiamato come Date.UTC() invece che come un metodo di istanza Date.

Esempi

Utilizzando Date.UTC()

La seguente dichiarazione crea un oggetto Date con gli argomenti trattati come  UTC invece di local:

var utcDate = new Date(Date.UTC(2018, 11, 1, 0, 0, 0));

Specificazioni

Browser compatibility

BCD tables only load in the browser

Note di compatibilità

Date.UTC con meno di due argomenti

Quando si provvedono meno di due argomenti a Date.UTC, ECMAScript 2017 richiede che  NaN sia restituito. Motori che non supportavano tale comportamento sono stati aggiornati (vedere bug 1050755, ecma-262 #642).

Date.UTC();
Date.UTC(1);

// Safari: NaN
// Chrome/Opera/V8: NaN

// Firefox <54: non-NaN
// Firefox 54+: NaN

// IE: non-NaN
// Edge: NaN

Vedere anche