TimeZoneInfo Classe

Définition

Représente un fuseau horaire dans le monde.Represents any time zone in the world.

public ref class TimeZoneInfo sealed : IEquatable<TimeZoneInfo ^>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
[System.Serializable]
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface ISerializable
    interface IDeserializationCallback
Public NotInheritable Class TimeZoneInfo
Implements IDeserializationCallback, IEquatable(Of TimeZoneInfo), ISerializable
Héritage
TimeZoneInfo
Attributs
Implémente

Remarques

Un fuseau horaire est une région géographique dans laquelle la même heure est utilisée.A time zone is a geographical region in which the same time is used.

La TimeZoneInfo classe offre des améliorations significatives par TimeZone rapport à la classe, qui ne fournit que des fonctionnalités limitées.The TimeZoneInfo class offers significant enhancements over the TimeZone class, which provides only limited functionality.

La TimeZone classe reconnaît uniquement le fuseau horaire local et peut convertir les heures entre le temps universel coordonné (UTC, Universal Time Coordinated) et l’heure locale.The TimeZone class recognizes only the local time zone, and can convert times between Coordinated Universal Time (UTC) and local time. Un TimeZoneInfo objet peut représenter n’importe quel fuseau horaire, et les TimeZoneInfo méthodes de la classe peuvent être utilisées pour convertir l’heure d’un fuseau horaire en heure correspondante dans un autre fuseau horaire.A TimeZoneInfo object can represent any time zone, and methods of the TimeZoneInfo class can be used to convert the time in one time zone to the corresponding time in any other time zone. Les membres de la TimeZoneInfo classe prennent en charge les opérations suivantes:The members of the TimeZoneInfo class support the following operations:

  • Récupération d’un fuseau horaire déjà défini par le système d’exploitation.Retrieving a time zone that is already defined by the operating system.

  • Énumération des fuseaux horaires disponibles sur un système.Enumerating the time zones that are available on a system.

  • Conversion d’heures entre différents fuseaux horaires.Converting times between different time zones.

  • Création d’un nouveau fuseau horaire qui n’est pas déjà défini par le système d’exploitation.Creating a new time zone that is not already defined by the operating system.

  • Sérialisation d’un fuseau horaire pour une récupération ultérieure.Serializing a time zone for later retrieval.

Notes

Une instance de la TimeZoneInfo classe est immuable.An instance of the TimeZoneInfo class is immutable. Une fois qu’un objet a été instancié, ses valeurs ne peuvent pas être modifiées.Once an object has been instantiated, its values cannot be modified.

Vous ne pouvez pas TimeZoneInfo instancier un new objet à l’aide du mot clé.You cannot instantiate a TimeZoneInfo object using the new keyword. Au lieu de cela, vous devez appeler l’un des membres TimeZoneInfo statiques de la classe illustrés dans le tableau suivant.Instead, you must call one of the static members of the TimeZoneInfo class shown in the following table.

Nom de membre statiqueStatic member name DescriptionDescription
Méthode CreateCustomTimeZoneCreateCustomTimeZone method Crée un fuseau horaire personnalisé à partir des données fournies par l’application.Creates a custom time zone from application-supplied data.
Méthode FindSystemTimeZoneByIdFindSystemTimeZoneById method Instancie un fuseau horaire en fonction de son identificateur.Instantiates a time zone based on its identifier.
Méthode FromSerializedStringFromSerializedString method Désérialise une valeur de chaîne pour recréer un TimeZoneInfo objet précédemment sérialisé.Deserializes a string value to re-create a previously serialized TimeZoneInfo object.
Méthode GetSystemTimeZonesGetSystemTimeZones method Retourne un ReadOnlyCollection<T> énumérable TimeZoneInfo d’objets qui représente tous les fuseaux horaires disponibles sur le système local.Returns an enumerable ReadOnlyCollection<T> of TimeZoneInfo objects that represents all time zones that are available on the local system.
PropriétéLocalLocal property Instancie un TimeZoneInfo objet qui représente le fuseau horaire local.Instantiates a TimeZoneInfo object that represents the local time zone.
PropriétéUtcUtc property Instancie un TimeZoneInfo objet qui représente la zone UTC.Instantiates a TimeZoneInfo object that represents the UTC zone.

Vous pouvez utiliser la CreateCustomTimeZone méthode pour créer un fuseau horaire qui n’est pas défini dans le Registre du système local sur les systèmes Windows ou les classes de fuseau horaire dans la bibliothèque ICU sur Linux ou MacOS.You can use the CreateCustomTimeZone method to create a time zone that is not defined in the local system registry on Windows systems or by the time zone classes in the ICU Library on Linux or 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 peut être stockée sous une forme accessible à l’application.You can then use the ToSerializedString property to save the time zone object's information as a string, which can be stored in some form that is accessible to the application. Vous pouvez utiliser la FromSerializedString méthode pour convertir une chaîne sérialisée TimeZoneInfo en objet.You can use the FromSerializedString method to convert a serialized string back to a TimeZoneInfo object.

Propriétés

BaseUtcOffset

Obtient la différence de temps entre l'heure d'hiver du fuseau horaire actuel et le temps universel coordonné (UTC, Universal Time Coordinated).Gets the time difference between the current time zone's standard time and Coordinated Universal Time (UTC).

DaylightName

Obtient le nom d'affichage pour l'heure d'été du fuseau horaire actuel.Gets the display name for the current time zone's daylight saving time.

DisplayName

Obtient le nom d'affichage général qui représente le fuseau horaire.Gets the general display name that represents the time zone.

Id

Obtient l'identificateur du fuseau horaire.Gets the time zone identifier.

Local

Obtient un objet TimeZoneInfo qui représente le fuseau horaire local.Gets a TimeZoneInfo object that represents the local time zone.

StandardName

Obtient le nom complet pour l'heure d'hiver du fuseau horaire.Gets the display name for the time zone's standard time.

SupportsDaylightSavingTime

Obtient une valeur indiquant si le fuseau horaire a des règles d'heure d'été.Gets a value indicating whether the time zone has any daylight saving time rules.

Utc

Obtient un objet TimeZoneInfo qui représente la zone de temps universel (UTC, Universal Time Coordinated).Gets a TimeZoneInfo object that represents the Coordinated Universal Time (UTC) zone.

Méthodes

ClearCachedData()

Efface les données de fuseau horaire mises en cache.Clears cached time zone data.

ConvertTime(DateTime, TimeZoneInfo)

Convertit une heure en heure d'un fuseau horaire particulier.Converts a time to the time in a particular time zone.

ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)

Convertit une heure d'un fuseau horaire vers une autre.Converts a time from one time zone to another.

ConvertTime(DateTimeOffset, TimeZoneInfo)

Convertit une heure en heure d'un fuseau horaire particulier.Converts a time to the time in a particular time zone.

ConvertTimeBySystemTimeZoneId(DateTime, String)

Convertit une heure en heure d'un autre fuseau horaire selon l'identificateur du fuseau horaire.Converts a time to the time in another time zone based on the time zone's identifier.

ConvertTimeBySystemTimeZoneId(DateTime, String, String)

Convertit une heure d'un fuseau horaire vers une autre selon les identificateurs de fuseau horaire.Converts a time from one time zone to another based on time zone identifiers.

ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)

Convertit une heure en heure d'un autre fuseau horaire selon l'identificateur du fuseau horaire.Converts a time to the time in another time zone based on the time zone's identifier.

ConvertTimeFromUtc(DateTime, TimeZoneInfo)

Convertit le temps universel coordonné (UTC, Universal Time Coordinated) en heure d'un fuseau horaire spécifié.Converts a Coordinated Universal Time (UTC) to the time in a specified time zone.

ConvertTimeToUtc(DateTime)

Convertit la date et l'heure spécifiées en temps universel coordonné (UTC, Universal Time Coordinated).Converts the specified date and time to Coordinated Universal Time (UTC).

ConvertTimeToUtc(DateTime, TimeZoneInfo)

Convertit l'heure d'un fuseau horaire spécifié en temps universel coordonné (UTC, Universal Time Coordinated).Converts the time in a specified time zone to Coordinated Universal Time (UTC).

CreateCustomTimeZone(String, TimeSpan, String, String)

Crée un fuseau horaire personnalisé avec un identificateur spécifié, un offset de temps universel coordonné (UTC, Universal Time Coordinated), un nom d'affichage et un nom d'affichage de l'heure d'hiver.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, and a standard time display name.

CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[])

Crée un fuseau horaire personnalisé avec un identificateur spécifié, un offset de temps universel coordonné (UTC, Universal Time Coordinated), un nom d'affichage, un nom d'heure d'hiver, un nom d'heure d'été et des règles d'heure d'été.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, a standard time name, a daylight saving time name, and daylight saving time rules.

CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean)

Crée un fuseau horaire personnalisé avec un identificateur spécifié, un offset de temps universel coordonné (UTC, Universal Time Coordinated), un nom d'affichage, un nom d'heure d'hiver, 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é.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, a standard time name, a daylight saving time name, daylight saving time rules, and a value that indicates whether the returned object reflects daylight saving time information.

Equals(Object)

Détermine si l'objet TimeZoneInfo en cours et un deuxième objet sont égaux.Determines whether the current TimeZoneInfo object and another object are equal.

Equals(TimeZoneInfo)

Détermine si l'objet TimeZoneInfo en cours et un deuxième objet TimeZoneInfo sont égaux.Determines whether the current TimeZoneInfo object and another TimeZoneInfo object are equal.

FindSystemTimeZoneById(String)

Instancie un nouvel objet TimeZoneInfo en fonction de son identificateur.Instantiates a new TimeZoneInfo object based on its identifier.

FromSerializedString(String)

Désérialise une chaîne pour recréer un objet TimeZoneInfo sérialisé d'origine.Deserializes a string to re-create an original serialized TimeZoneInfo object.

GetAdjustmentRules()

Récupère un tableau d'objets TimeZoneInfo.AdjustmentRule qui s'appliquent à l'objet TimeZoneInfo en cours.Retrieves an array of TimeZoneInfo.AdjustmentRule objects that apply to the current TimeZoneInfo object.

GetAmbiguousTimeOffsets(DateTime)

Retourne des informations sur les dates et heures possibles auxquelles une date et heure ambiguë peut être mappée.Returns information about the possible dates and times that an ambiguous date and time can be mapped to.

GetAmbiguousTimeOffsets(DateTimeOffset)

Retourne des informations sur les dates et heures possibles auxquelles une date et heure ambiguë peut être mappée.Returns information about the possible dates and times that an ambiguous date and time can be mapped to.

GetHashCode()

Sert de fonction de hachage pour les algorithmes de hachage et les structures de données telles que les tables de hachage.Serves as a hash function for hashing algorithms and data structures such as hash tables.

GetSystemTimeZones()

Retourne une collection triée de tous les fuseaux horaires pour lesquels des informations sont disponibles sur le système local.Returns a sorted collection of all the time zones about which information is available on the local system.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
GetUtcOffset(DateTime)

Calcule l'offset ou la différence entre l'heure de ce fuseau horaire et le temps universel (UTC, Universal Time Coordinated) pour une date et une heure spécifiques.Calculates the offset or difference between the time in this time zone and Coordinated Universal Time (UTC) for a particular date and time.

GetUtcOffset(DateTimeOffset)

Calcule l'offset ou la différence entre l'heure de ce fuseau horaire et le temps universel (UTC, Universal Time Coordinated) pour une date et une heure spécifiques.Calculates the offset or difference between the time in this time zone and Coordinated Universal Time (UTC) for a particular date and time.

HasSameRules(TimeZoneInfo)

Indique si l'objet actuel et un autre objet TimeZoneInfo sont soumis aux mêmes règles d'ajustement.Indicates whether the current object and another TimeZoneInfo object have the same adjustment rules.

IsAmbiguousTime(DateTime)

Détermine si une valeur de date et d'heure particulière pour un fuseau horaire particulier est ambiguë et s'il est possible de la mapper en deux heures ou plus au temps universel (UTC, Universal Time Coordinated).Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

IsAmbiguousTime(DateTimeOffset)

Détermine si une valeur de date et d'heure particulière pour un fuseau horaire particulier est ambiguë et s'il est possible de la mapper en deux heures ou plus au temps universel (UTC, Universal Time Coordinated).Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

IsDaylightSavingTime(DateTime)

Indique si la date et l'heure spécifiées se trouvent dans la plage d'heure d'été du fuseau horaire de l'objet TimeZoneInfo actuel.Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.

IsDaylightSavingTime(DateTimeOffset)

Indique si la date et l'heure spécifiées se trouvent dans la plage d'heure d'été du fuseau horaire de l'objet TimeZoneInfo actuel.Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.

IsInvalidTime(DateTime)

Indique si une valeur de date et d'heure particulière n'est pas valide.Indicates whether a particular date and time is invalid.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToSerializedString()

Convertit l'objet TimeZoneInfo en cours en chaîne sérialisée.Converts the current TimeZoneInfo object to a serialized string.

ToString()

Renvoie le nom complet de l'objet TimeZoneInfo en cours.Returns the current TimeZoneInfo object's display name.

Implémentations d’interfaces explicites

IDeserializationCallback.OnDeserialization(Object)

S'exécute quand la désérialisation d'un objet a été effectuée.Runs when the deserialization of an object has been completed.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Remplit un objet SerializationInfo des données nécessaires à la sérialisation de l'objet TimeZoneInfo actuel.Populates a SerializationInfo object with the data needed to serialize the current TimeZoneInfo object.

S’applique à