--- title: Date.UTC() slug: Web/JavaScript/Reference/Global_Objects/Date/UTC translation_of: Web/JavaScript/Reference/Global_Objects/Date/UTC ---
{{JSRef}}

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.

{{EmbedInteractiveExample("pages/js/date-utc.html")}}

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_inline}}
Opzionalel. Un integer tra 1 e 31 rappresentante il giorno del mese. Se omesso, è predefinito a 1.
hour {{optional_inline}}
Un integer tra  0 e 23 rappresentante le ore. Se omesso è predefinito a 0.
minute {{optional_inline}}
Un  integer tra 0 e 59 rappresentante i minuti.  Se omesso, è predefinito a 0.
second {{optional_inline}}
Un integer tra  0 e 59 rappresentante i secondi. Se omesso, è predefinito a 0.
millisecond {{optional_inline}}
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 {{jsxref("Date")}} in due modi.

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")}}.

Esempi

Utilizzando 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));

Specificazioni

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.

Browser compatibility

{{Compat("javascript.builtins.Date.UTC")}}

Note di compatibilità

Date.UTC con meno di due argomenti

Quando 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

Vedere anche