--- 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]]]]])
yearmonthmonth 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