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.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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 oggettoDate
.
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 (ECMA-262) The definition of 'Date.UTC' in that specification. |
Living Standard | |
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
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