Lire en anglais

Partager via


TimeZoneInfo.ConvertTimeFromUtc(DateTime, TimeZoneInfo) Méthode

Définition

Convertit le temps universel coordonné (UTC, Universal Time Coordinated) en heure d'un fuseau horaire spécifié.

public static DateTime ConvertTimeFromUtc (DateTime dateTime, TimeZoneInfo destinationTimeZone);

Paramètres

dateTime
DateTime

Temps universel coordonné (UTC, Universal Time Coordinated).

destinationTimeZone
TimeZoneInfo

Fuseau horaire vers lequel convertir dateTime.

Retours

Date et heure dans le fuseau horaire de destination. Sa propriété Kind a la valeur Utc si destinationTimeZone a la valeur Utc ; sinon, sa propriété Kind a la valeur Unspecified.

Exceptions

La propriété Kind de dateTime a la valeur Local.

destinationTimeZone a la valeur null.

Exemples

L’exemple suivant convertit le temps universel coordonné (UTC) en heure centrale.

DateTime timeUtc = DateTime.UtcNow;
try
{
   TimeZoneInfo cstZone = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time");
   DateTime cstTime = TimeZoneInfo.ConvertTimeFromUtc(timeUtc, cstZone);
   Console.WriteLine("The date and time are {0} {1}.", 
                     cstTime, 
                     cstZone.IsDaylightSavingTime(cstTime) ?
                             cstZone.DaylightName : cstZone.StandardName);
}
catch (TimeZoneNotFoundException)
{
   Console.WriteLine("The registry does not define the Central Standard Time zone.");
}                           
catch (InvalidTimeZoneException)
{
   Console.WriteLine("Registry data on the Central Standard Time zone has been corrupted.");
}

Remarques

Lors de l’exécution de la conversion, la ConvertTimeFromUtc méthode applique toutes les règles d’ajustement en vigueur dans le destinationTimeZone fuseau horaire.

Le comportement précis de cette méthode dépend de la valeur de la Kind propriété du paramètre, comme le dateTime montre le tableau suivant.

Propriété DateTime.Kind Conversion
DateTimeKind.Local Lève un ArgumentException.
DateTimeKind.Unspecified ou DateTimeKind.Utc Convertit à partir du temps universel coordonné (UTC).

Si la conversion de dateTime aboutit à une valeur de date et d’heure antérieure DateTime.MinValue ou ultérieure à DateTime.MaxValue, cette méthode retourne DateTime.MinValue ou DateTime.MaxValue, respectivement.

S’applique à

Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Voir aussi