--- title: Date.UTC() slug: Web/JavaScript/Reference/Global_Objects/Date/UTC translation_of: Web/JavaScript/Reference/Global_Objects/Date/UTC ---
Il metodo Date.UTC()
accetta gli stessi parametri del costruttore {{jsxref("Date")}}, ma li tratta come UTC. Restituisce il numero di millisecondi fin dal Gennaio 1, 1970, 00:00:00 UTC.
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]]]]])
year
month
month
era un parametro richiesto. Con ES2017, non lo è più.)day
{{optional_inline}}hour
{{optional_inline}}minute
{{optional_inline}}second
{{optional_inline}}millisecond
{{optional_inline}}Un numero rappresentante i umeri di millisecondi per la data fornita sin dal Gennaio 1, 1970, 00:00:00, UTC.
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 {{jsxref("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 {{jsxref("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 {{jsxref("Date")}}, per questo è chiamato come Date.UTC()
invece che come un metodo di istanza {{jsxref("Date")}}.
Date.UTC()
La seguente dichiarazione crea un oggetto {{jsxref("Date")}} con gli argomenti trattati come UTC invece di local:
var utcDate = new Date(Date.UTC(2018, 11, 1, 0, 0, 0));
Specification | Status | Comment |
---|---|---|
{{SpecName('ESDraft', '#sec-date.utc', 'Date.UTC')}} | {{Spec2('ESDraft')}} | |
{{SpecName('ES6', '#sec-date.utc', 'Date.UTC')}} | {{Spec2('ES6')}} | |
{{SpecName('ES5.1', '#sec-15.9.4.3', 'Date.UTC')}} | {{Spec2('ES5.1')}} | |
{{SpecName('ES1')}} | {{Spec2('ES1')}} | Definizione iniziale. Implementata in JavaScript 1.0. |
{{Compat("javascript.builtins.Date.UTC")}}
Date.UTC
con meno di due argomentiQuando si provvedono meno di due argomenti a Date.UTC
, ECMAScript 2017 richiede che {{jsxref("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