TimeZone.ToLocalTime(DateTime) Metodo

Definizione

Restituisce l'ora locale corrispondente a un valore di data e ora specificato.Returns the local time that corresponds to a specified date and time value.

public:
 virtual DateTime ToLocalTime(DateTime time);
public virtual DateTime ToLocalTime (DateTime time);
abstract member ToLocalTime : DateTime -> DateTime
override this.ToLocalTime : DateTime -> DateTime
Public Overridable Function ToLocalTime (time As DateTime) As DateTime

Parametri

time
DateTime

Ora UTC (Coordinated Universal Time).A Coordinated Universal Time (UTC) time.

Restituisce

DateTime

Oggetto DateTime il cui valore è l'ora locale corrispondente a time.A DateTime object whose value is the local time that corresponds to time.

Commenti

Nella tabella seguente viene illustrata la relazione tra il time parametro e il DateTime valore restituito da questo metodo.The following table shows the relationship between the time parameter and the DateTime value returned by this method.

Parametro time.time parameter ComportamentoBehavior Valore restituitoReturn value
Ora UTC (Coordinated Universal Time) ( DateTimeKind.Utc ).A Coordinated Universal Time (UTC) time (DateTimeKind.Utc). Converte l'ora UTC nell'ora locale.Converts the time from UTC to the local time. Oggetto DateTime il cui valore è l'ora locale corrispondente a time.A DateTime object whose value is the local time that corresponds to time.
Ora locale ( DateTimeKind.Local ).A local time (DateTimeKind.Local). Non è necessaria alcuna conversione.No conversion necessary. Lo stesso DateTime valore rappresentato dal time parametro.The same DateTime value represented by the time parameter.
Ora non specificata ( DateTimeKind.Unspecified ).An unspecified time (DateTimeKind.Unspecified). Presuppone che l'ora sia UTC e la converta dall'ora UTC all'ora locale.Assumes that the time is UTC and converts it from UTC to the local time. Oggetto DateTime il cui valore è l'ora locale corrispondente a time.A DateTime object whose value is the local time that corresponds to time.

Se il fuso orario locale osserva l'ora legale, ToLocalTime applica la regola di rettifica corrente a time quando si esegue la conversione.If the local time zone observes daylight saving time, ToLocalTime applies the current adjustment rule to time when performing the conversion.

Nota

Il ToLocalTime metodo riconosce solo la regola di regolazione dell'ora legale corrente per il fuso orario locale.The ToLocalTime method recognizes only the current daylight saving time adjustment rule for the local time zone. Di conseguenza, è garantita la restituzione accurata dell'ora locale corrispondente a una determinata ora UTC solo durante il periodo in cui è attiva la regola di rettifica più recente.As a result, it is guaranteed to accurately return the local time corresponding to a particular UTC time only during the period in which the latest adjustment rule is in effect. Se time è un valore di data e ora cronologico soggetto a una regola di rettifica precedente, può restituire risultati non accurati.It may return inaccurate results if time is a historic date and time value that was subject to a previous adjustment rule.

Il ToLocalTime metodo corrisponde al TimeZoneInfo.ConvertTimeFromUtc metodo con il destinationTimeZone parametro impostato su TimeZoneInfo.Local .The ToLocalTime method corresponds to the TimeZoneInfo.ConvertTimeFromUtc method with its destinationTimeZone parameter set to TimeZoneInfo.Local. Quando possibile, usare il TimeZoneInfo.ConvertTimeFromUtc metodo.Whenever possible, use the TimeZoneInfo.ConvertTimeFromUtc method.

Note per gli eredi

Sebbene non sia obbligatorio, nella maggior parte dei casi le classi derivate in esecuzione con .NET Framework versione 2,0 devono eseguire l'override dell'implementazione predefinita di questo metodo.Although it is not required, in most cases derived classes running under the .NET Framework version 2.0 should override the default implementation of this method. Nelle versioni .NET Framework 1,0 e 1,1, il ToLocalTime metodo ha chiamato il GetUtcOffset(DateTime) metodo e viene regolato per l'ora legale quando viene restituita l'ora locale.In the .NET Framework versions 1.0 and 1.1, the ToLocalTime method called the GetUtcOffset(DateTime) method and adjusted for daylight saving time when returning the local time. Tuttavia, a partire da .NET Framework 2,0, il comportamento dell'implementazione predefinita dipende dalla Kind proprietà del time parametro.However, starting with the .NET Framework 2.0, the behavior of the default implementation depends on the Kind property of the time parameter. Se il valore è Local , questo metodo restituisce time invariato.If its value is Local, this method returns time unchanged. Se il valore è Utc o Unspecified , questo metodo presuppone che time sia UTC e lo converte nell'ora di sistema locale senza chiamare il GetUtcOffset(DateTime) metodo.If its value is either Utc or Unspecified, this method assumes time is UTC and converts it to the local system time without calling the GetUtcOffset(DateTime) method.

Il codice seguente fornisce un override semplice dell'implementazione predefinita del ToLocalTime metodo.The following code provides a simple override of the default implementation of the ToLocalTime method. In questo codice la internalTimeZone variabile rappresenta un'istanza privata della TimeZone classe:In this code, the internalTimeZone variable represents a private instance of the TimeZone class: [! code-CSharpSystem. TimeZone. ToLocalTime # 1] [! Code-VBSystem. TimeZone. ToLocalTime # 1][!code-csharpSystem.TimeZone.ToLocalTime#1] [!code-vbSystem.TimeZone.ToLocalTime#1]

Si applica a

Vedi anche