Questa traduzione è incompleta. Collabora alla traduzione di questo articolo dall’originale in lingua inglese.

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

Specification Status Comment
ECMAScript Latest Draft (ECMA-262)
The definition of 'Date.UTC' in that specification.
Draft  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Date.UTC' in that specification.
Standard  
ECMAScript 5.1 (ECMA-262)
The definition of 'Date.UTC' in that specification.
Standard  
ECMAScript 1st Edition (ECMA-262) Standard  Definizione iniziale. Implementata in JavaScript 1.0.

Browser compatibility

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
UTCChrome Full support YesEdge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support 4Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yesnodejs Full support Yes

Legend

Full support  
Full support

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

Tag del documento e collaboratori

Hanno collaborato alla realizzazione di questa pagina: Umberto81
Ultima modifica di: Umberto81,