Converte un'indicazione di data e ora UTC o GMT in ora locale come valore duale.
Sintassi:
ConvertToLocalTime(timestamp [, place [, ignore_dst=false]])
Restituisce il tipo di dati: duale
Argomenti:
| Argomento | Descrizione |
|---|---|
| timestamp | La data di valutazione di un'indicazione di data e ora o l'espressione che restituisce un indicazione di data e ora da convertire, ad esempio '2012-10-12'. |
| place |
Una località o un fuso orario contenuti nella tabella seguente relativa alle località e ai fusi orari. In alternativa, è possibile utilizzare GMT o UTC per definire l'ora locale. I valori e gli intervalli di differimento temporale seguenti sono validi:
Nota informaticaÈ possibile utilizzare differimenti temporali standard. Non è possibile utilizzare un differimento temporale arbitrario, ad esempio GMT-04:27.
|
| ignore_dst | Impostare su True per ignorare DST (ora legale). |
Il valore temporale risultante verrà adattato in funzione dell'ora legale, a meno ignore_dst non sia impostato su True.
Località e fusi orari
La funzione ConvertToLocalTime recupera le informazioni sulle località e i fusi orari mondiali dal registro di sistema di Windows. Ciò significa che la funzione restituisce i risultati attesi solo se il nome della località che si intende utilizzare corrisponde al nome utilizzato nel registro di sistema di Windows.
Il nome esatto con cui una località è memorizzata nel registro di sistema di Windows può inoltre cambiare a seconda delle impostazioni della lingua dell'installazione di Windows in uso. I nomi di alcune città e paesi presentano infatti differenze in lingue diverse.
Un elenco completo delle località e dei fusi orari si trova nel percorso seguente del registro di sistema di Windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones
In alternativa, l'elenco delle località e dei fusi orari è reperibile nel Pannello di controllo di Windows. Aprire il Pannello di controllo, fare clic sull'impostazione Data e ora e quindi su Modifica fuso orario. L'elenco completo delle città o dei paesi associati a ogni fuso orario è visibile nel menu a discesa.
Esempi e risultati:
| Esempio | Risultato |
|---|---|
| ConvertToLocalTime('2007-11-10 23:59:00','Paris') | Restituisce '2007-11-11 00:59:00' e la corrispondente rappresentazione interna dell'indicazione di data e ora. |
| ConvertToLocalTime(UTC(), 'GMT-05:00') | Restituisce l'ora della costa Orientale degli Stati Uniti, ad esempio l'ora di New York. |
| ConvertToLocalTime(UTC(), 'GMT-05:00', True) | Restituisce l'ora della costa Orientale degli Stati Uniti, ad esempio l'ora di New York, senza adattamento dell'ora legale. |
Utilizzo degli scostamenti GMT in combinazione con DST
In seguito all'implementazione delle librerie International Components for Unicode (ICU) in licenza November 2018, l'uso degli scostamenti GMT (Greenwich Mean Time) in combinazione con DST (Daylight Saving Time) richiede ulteriori informazioni sulla latitudine.
GMT rappresenta uno scostamento longitudinale (est-ovest), mentre DST è uno scostamento latitudinale (nord-sud). Ad esempio, Helsinki (Finlandia) e Johannesburg (Sudafrica) condividono lo stesso scostamento GMT+02:00, ma non lo stesso scostamento DST. Ciò significa che, oltre allo scostamento GMT, qualsiasi scostamento DST richiede informazioni sulla posizione latitudinale del fuso orario locale (input del fuso orario geografico) per avere informazioni complete sulle condizioni DST locali.
