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

 

Il metodo getTimezoneOffset() restituisce la differenza di fuso orario, in minuti, da corrente locale (host system settings) a UTC.

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

Sintassi

dateObj.getTimezoneOffset()

Valore di ritorno

Un numero rappresentante  l'offset del fuso orario, in minuti, dalla data basata sul current host system settings a UTC.

Descrizione

Il time-zone offset è la differenza, in minuti, dall'ora locale a UTC. Nota che questo significa che l'offset è positivo se l'ora locale è indietro allo UTC e negativo se è avanti. Per esempio, per il fuso orario UTC+10:00 (Australian Eastern Standard Time, Vladivostok Time, Chamorro Standard Time), sarà restituito -600.

Current Locale UTC-8 UTC UTC+3
Return Value 480 0 -180

L'offset di fuso orario restituito è quello che si applica per la Data su cui è chiamato. Dove l'host system è configurato per l'ora legale, l'offset cambierà in base alla data e al tempo che la Data rappresenta e a cui si applica l'ora legale.

Esempi

Utilizzando getTimezoneOffset()

// Get current timezone offset for host device
var x = new Date();
var currentTimeZoneOffsetInHours = x.getTimezoneOffset() / 60;
// 1

// Get timezone offset for International Labour Day (May 1) in 2016
// Be careful, the Date() constructor uses 0-indexed month so May is
// represented with 4 (and not 5)
var labourDay = new Date(2016, 4, 1)
var labourDayOffset = labourDay.getTimezoneOffset() / 60;

Specificazioni

Specification Status Comment
{{SpecName('ES1')}} {{Spec2('ES1')}} Definizione iniziale. Implementata in JavaScript 1.0.
{{SpecName('ES5.1', '#sec-15.9.5.26', 'Date.prototype.getTimezoneOffset')}} {{Spec2('ES5.1')}}  
{{SpecName('ES6', '#sec-date.prototype.gettimezoneoffset', 'Date.prototype.getTimezoneOffset')}} {{Spec2('ES6')}}  
{{SpecName('ESDraft', '#sec-date.prototype.gettimezoneoffset', 'Date.prototype.getTimezoneOffset')}} {{Spec2('ESDraft')}}  

Browser compatibility

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