TimeZone.ToLocalTime(DateTime) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne l’heure locale qui correspond à une valeur de date et d’heure spécifiée.
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 DateTimeParamètres
- time
- DateTime
Heure UTC (Temps universel coordonné).
Retours
Objet DateTime dont la valeur est l’heure locale qui correspond à time.
Remarques
Le tableau suivant montre la relation entre le time paramètre et la DateTime valeur retournée par cette méthode.
time Paramètre |
Behavior | Valeur renvoyée |
|---|---|---|
| Heure utc (DateTimeKind.UtcTemps universel coordonné). | Convertit l’heure UTC en heure locale. | Objet DateTime dont la valeur est l’heure locale qui correspond à time. |
| Heure locale (DateTimeKind.Local). | Aucune conversion n’est nécessaire. | Même DateTime valeur représentée par le time paramètre. |
| Heure non spécifiée (DateTimeKind.Unspecified). | Suppose que l’heure est UTC et la convertit de UTC en heure locale. | Objet DateTime dont la valeur est l’heure locale qui correspond à time. |
Si le fuseau horaire local observe l’heure d’été, ToLocalTime applique la règle time d’ajustement actuelle lors de l’exécution de la conversion.
Note
La ToLocalTime méthode reconnaît uniquement la règle d’ajustement de l’heure d’été actuelle pour le fuseau horaire local. Par conséquent, il est garanti de retourner avec précision l’heure locale correspondant à une heure UTC particulière uniquement pendant la période pendant laquelle la règle d’ajustement la plus récente est en vigueur. Il peut retourner des résultats incorrects s’il time s’agit d’une valeur de date et d’heure historique soumise à une règle d’ajustement précédente.
La ToLocalTime méthode correspond à la TimeZoneInfo.ConvertTimeFromUtc méthode avec son destinationTimeZone paramètre défini sur TimeZoneInfo.Local. Dans la mesure du possible, utilisez la TimeZoneInfo.ConvertTimeFromUtc méthode.
Notes pour les héritiers
Bien qu’il ne soit pas nécessaire, dans la plupart des cas, les classes dérivées doivent remplacer l’implémentation par défaut de cette méthode. Le comportement de l’implémentation par défaut dépend de la Kind propriété du time paramètre. Si sa valeur est Local, cette méthode retourne time inchangé. Si sa valeur est l’une Utc ou l’autre, Unspecifiedcette méthode suppose qu’elle time est UTC et la convertit en heure système locale sans appeler la GetUtcOffset(DateTime) méthode.
