TimeZoneInfo Classe

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

TimeZoneInfo.cs

Représente n’importe quel fuseau horaire dans le monde.

public ref class TimeZoneInfo sealed : IEquatable<TimeZoneInfo ^>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface IDeserializationCallback
    interface ISerializable

Public NotInheritable Class TimeZoneInfo
Implements IDeserializationCallback, IEquatable(Of TimeZoneInfo), ISerializable

Héritage

Object

TimeZoneInfo

Implémente

IEquatable<TimeZoneInfo> IDeserializationCallback ISerializable

Remarques

Un fuseau horaire est une région géographique dans laquelle le même temps est utilisé.

La TimeZoneInfo classe offre des améliorations significatives sur la TimeZone classe, qui ne fournit que des fonctionnalités limitées.

La TimeZone classe reconnaît uniquement le fuseau horaire local et peut convertir des heures entre le temps universel coordonné (UTC) et l’heure locale. Un TimeZoneInfo objet peut représenter n’importe quel fuseau horaire et les méthodes de la TimeZoneInfo classe peuvent être utilisées pour convertir l’heure dans un fuseau horaire en heure correspondante dans n’importe quel autre fuseau horaire. Les membres de la TimeZoneInfo classe prennent en charge les opérations suivantes :

• Récupération d’un fuseau horaire déjà défini par le système d’exploitation.

• Énumération des fuseaux horaires disponibles sur un système.

• Conversion des heures entre différents fuseaux horaires.

• Création d’un fuseau horaire qui n’est pas déjà défini par le système d’exploitation.

• Sérialisation d’un fuseau horaire pour une récupération ultérieure.

Note

Une instance de la TimeZoneInfo classe est immuable. Une fois qu’un objet a été instancié, ses valeurs ne peuvent pas être modifiées.

Vous ne pouvez pas instancier un TimeZoneInfo objet à l’aide du new mot clé. Au lieu de cela, vous devez appeler l’un des membres statiques de la TimeZoneInfo classe indiqués dans le tableau suivant.

Nom de membre statique	Description
méthode CreateCustomTimeZone	Crée un fuseau horaire personnalisé à partir de données fournies par l’application.
méthode FindSystemTimeZoneById	Instancie un fuseau horaire en fonction de son identificateur.
méthode FromSerializedString	Désérialise une valeur de chaîne pour recréer un objet sérialisé TimeZoneInfo précédemment.
méthode GetSystemTimeZones	Retourne une énumérable ReadOnlyCollection<T> d’objets TimeZoneInfo qui représente tous les fuseaux horaires disponibles sur le système local.
Propriété Local	Instancie un TimeZoneInfo objet qui représente le fuseau horaire local.
Propriété Utc	Instancie un TimeZoneInfo objet qui représente la zone UTC.

Vous pouvez utiliser la CreateCustomTimeZone méthode pour créer un fuseau horaire qui n’est pas défini dans le registre système local sur les systèmes Windows ou par les données de fuseau horaire de la bibliothèque ICU sur Linux ou macOS. Vous pouvez ensuite utiliser la ToSerializedString() propriété pour enregistrer les informations de l’objet de fuseau horaire sous forme de chaîne, qui peuvent être stockées dans un formulaire accessible à l’application. Vous pouvez utiliser la FromSerializedString méthode pour convertir une chaîne sérialisée en objet TimeZoneInfo .

Propriétés

Nom	Description
BaseUtcOffset	Obtient la différence de temps entre l’heure standard du fuseau horaire actuel et l’heure universelle coordonnée (UTC).
DaylightName	Obtient le nom complet du fuseau horaire actuel de l’heure d’été.
DisplayName	Obtient le nom complet général qui représente le fuseau horaire.
HasIanaId	Retourne true si cet objet TimeZoneInfo a un ID IANA.
Id	Obtient l’identificateur du fuseau horaire.
Local	Obtient un TimeZoneInfo objet qui représente le fuseau horaire local.
StandardName	Obtient le nom complet de l’heure standard du fuseau horaire.
SupportsDaylightSavingTime	Obtient une valeur indiquant si le fuseau horaire a des règles d’heure d’été.
Utc	Obtient un TimeZoneInfo objet qui représente la zone UTC (Temps universel coordonné).

Méthodes

Nom	Description
ClearCachedData()	Efface les données de fuseau horaire mises en cache.
ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)	Convertit une heure d’un fuseau horaire à un autre.
ConvertTime(DateTime, TimeZoneInfo)	Convertit une heure en heure dans un fuseau horaire particulier.
ConvertTime(DateTimeOffset, TimeZoneInfo)	Convertit une heure en heure dans un fuseau horaire particulier.
ConvertTimeBySystemTimeZoneId(DateTime, String, String)	Convertit une heure d’un fuseau horaire en un autre en fonction des identificateurs de fuseau horaire.
ConvertTimeBySystemTimeZoneId(DateTime, String)	Convertit une heure en heure dans un autre fuseau horaire en fonction de l’identificateur du fuseau horaire.
ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)	Convertit une heure en heure dans un autre fuseau horaire en fonction de l’identificateur du fuseau horaire.
ConvertTimeFromUtc(DateTime, TimeZoneInfo)	Convertit un temps universel coordonné (UTC) en heure dans un fuseau horaire spécifié.
ConvertTimeToUtc(DateTime, TimeZoneInfo)	Convertit l’heure dans un fuseau horaire spécifié en temps universel coordonné (UTC).
ConvertTimeToUtc(DateTime)	Convertit la date et l’heure spécifiées en heure universelle coordonnée (UTC).
CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean)	Crée un fuseau horaire personnalisé avec un identificateur spécifié, un décalage de l’heure universelle coordonnée (UTC), un nom complet, un nom d’heure standard, un nom d’heure d’été, des règles d’heure d’été et une valeur qui indique si l’objet retourné reflète les informations d’heure d’été.
CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[])	Crée un fuseau horaire personnalisé avec un identificateur spécifié, un décalage par rapport au temps universel coordonné (UTC), un nom complet, un nom d’heure standard, un nom d’heure d’été et des règles d’heure d’été.
CreateCustomTimeZone(String, TimeSpan, String, String)	Crée un fuseau horaire personnalisé avec un identificateur spécifié, un décalage de l’heure universelle coordonnée (UTC), un nom d’affichage et un nom d’affichage de l’heure standard.
Equals(Object)	Détermine si l’objet actuel TimeZoneInfo et un autre objet sont égaux.
Equals(TimeZoneInfo)	Détermine si l’objet actuel TimeZoneInfo et un autre TimeZoneInfo objet sont égaux.
FindSystemTimeZoneById(String)	Retourne un TimeZoneInfo objet basé sur son identificateur.
FromSerializedString(String)	Désérialise une chaîne pour recréer un objet sérialisé TimeZoneInfo d’origine.
GetAdjustmentRules()	Récupère un tableau d’objets TimeZoneInfo.AdjustmentRule qui s’appliquent à l’objet actuel TimeZoneInfo .
GetAmbiguousTimeOffsets(DateTime)	Retourne des informations sur les dates et heures possibles auxquelles une date et une heure ambiguës peuvent être mappées.
GetAmbiguousTimeOffsets(DateTimeOffset)	Retourne des informations sur les dates et heures possibles auxquelles une date et une heure ambiguës peuvent être mappées.
GetHashCode()	Sert de fonction de hachage pour les algorithmes de hachage et les structures de données tels que les tables de hachage.
GetSystemTimeZones()	Retourne une collection triée de tous les fuseaux horaires sur lesquels les informations sont disponibles sur le système local.
GetSystemTimeZones(Boolean)	Retourne une ReadOnlyCollection<T> valeur contenant tous les fuseaux horaires valides de l’ordinateur local. Cette méthode ne lève pas TimeZoneNotFoundException ou InvalidTimeZoneException.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetUtcOffset(DateTime)	Calcule le décalage ou la différence entre l’heure dans ce fuseau horaire et l’heure universelle coordonnée (UTC) pour une date et une heure particulières.
GetUtcOffset(DateTimeOffset)	Calcule le décalage ou la différence entre l’heure dans ce fuseau horaire et l’heure universelle coordonnée (UTC) pour une date et une heure particulières.
HasSameRules(TimeZoneInfo)	Indique si l’objet actuel et un autre TimeZoneInfo objet ont les mêmes règles d’ajustement.
IsAmbiguousTime(DateTime)	Détermine si une date et une heure particulières dans un fuseau horaire particulier sont ambiguës et peuvent être mappées à deux ou plusieurs heures UTC (Temps universel coordonné).
IsAmbiguousTime(DateTimeOffset)	Détermine si une date et une heure particulières dans un fuseau horaire particulier sont ambiguës et peuvent être mappées à deux ou plusieurs heures UTC (Temps universel coordonné).
IsDaylightSavingTime(DateTime)	Indique si une date et une heure spécifiées tombent dans la plage d’heure d’été pour le fuseau horaire de l’objet actif TimeZoneInfo .
IsDaylightSavingTime(DateTimeOffset)	Indique si une date et une heure spécifiées tombent dans la plage d’heure d’été pour le fuseau horaire de l’objet actif TimeZoneInfo .
IsInvalidTime(DateTime)	Indique si une date et une heure particulières ne sont pas valides.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToSerializedString()	Convertit l’objet actuel TimeZoneInfo en chaîne sérialisée.
ToString()	Retourne le nom complet de l’objet actuel TimeZoneInfo .
TryConvertIanaIdToWindowsId(String, String)	Tente de convertir un ID de fuseau horaire IANA en ID Windows.
TryConvertWindowsIdToIanaId(String, String, String)	Tente de convertir un ID de fuseau horaire Windows en ID IANA.
TryConvertWindowsIdToIanaId(String, String)	Tente de convertir un ID de fuseau horaire Windows en ID IANA.
TryFindSystemTimeZoneById(String, TimeZoneInfo)	Récupère un TimeZoneInfo objet par nom de fuseau horaire.

Implémentations d’interfaces explicites

Nom	Description
IDeserializationCallback.OnDeserialization(Object)	S’exécute lorsque la désérialisation d’un objet a été terminée.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Remplit un SerializationInfo objet avec les données nécessaires pour sérialiser l’objet actuel TimeZoneInfo .