TimeZone.ToLocalTime(DateTime) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce l'ora locale che corrisponde a un valore di data e ora specificato.
public:
virtual DateTime ToLocalTime(DateTime time);public virtual DateTime ToLocalTime(DateTime time);abstract member ToLocalTime : DateTime -> DateTime
override this.ToLocalTime : DateTime -> DateTimePublic Overridable Function ToLocalTime (time As DateTime) As DateTimeParametri
- time
- DateTime
Ora UTC (Coordinated Universal Time).
Valori restituiti
Oggetto DateTime il cui valore è l'ora locale che corrisponde a time.
Commenti
Nella tabella seguente viene illustrata la relazione tra il time parametro e il DateTime valore restituito da questo metodo.
parametro time |
Behavior | Valore restituito |
|---|---|---|
| Ora UTC (Coordinated Universal Time) (DateTimeKind.Utc). | Converte l'ora dall'ora UTC all'ora locale. | Oggetto DateTime il cui valore è l'ora locale che corrisponde a time. |
| Ora locale (DateTimeKind.Local). | Nessuna conversione necessaria. | Lo stesso DateTime valore rappresentato dal time parametro . |
| Ora non specificata (DateTimeKind.Unspecified). | Si presuppone che l'ora sia UTC e la converta dall'ora UTC all'ora locale. | Oggetto DateTime il cui valore è l'ora locale che corrisponde a time. |
Se il fuso orario locale osserva l'ora legale, ToLocalTime applica la regola di regolazione corrente a quando time esegue la conversione.
Note
Il ToLocalTime metodo riconosce solo la regola di regolazione dell'ora legale corrente per il fuso orario locale. Di conseguenza, è garantito che restituisca in modo accurato l'ora locale corrispondente a una determinata ora UTC solo durante il periodo in cui è attiva la regola di rettifica più recente. Può restituire risultati imprecisi se time è un valore di data e ora cronologico soggetto a una regola di rettifica precedente.
Il ToLocalTime metodo corrisponde al metodo con il TimeZoneInfo.ConvertTimeFromUtc relativo destinationTimeZone parametro impostato su TimeZoneInfo.Local. Quando possibile, usare il TimeZoneInfo.ConvertTimeFromUtc metodo .
Note per gli eredi
Anche se non è obbligatorio, nella maggior parte dei casi le classi derivate devono eseguire l'override dell'implementazione predefinita di questo metodo. Il comportamento dell'implementazione predefinita dipende dalla Kind proprietà del time parametro . Se il valore è Local, questo metodo restituisce time invariato. Se il valore è Utc o Unspecified, questo metodo presuppone time che sia UTC e lo converta nell'ora di sistema locale senza chiamare il GetUtcOffset(DateTime) metodo .
