ConvertTimeFromUtc Méthode (DateTime, TimeZoneInfo)
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

TimeZoneInfo.ConvertTimeFromUtc, méthode (DateTime, TimeZoneInfo)

 

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

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)

public static DateTime ConvertTimeFromUtc(
	DateTime dateTime,
	TimeZoneInfo destinationTimeZone
)

Paramètres

dateTime

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

destinationTimeZone

Fuseau horaire vers lequel convertir dateTime.

Valeur de retour

Type: System.DateTime

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

Exception Condition
ArgumentException

Le Kind propriété du dateTime est DateTimeKind.Local.

ArgumentNullException

destinationTimeZone a la valeur null.

Lors de la conversion, la ConvertTimeFromUtc méthode s'applique à toute règle d'ajustement en vigueur dans la destinationTimeZone fuseau horaire.

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

Propriété DateTime.Kind

Conversion

DateTimeKind.Local

Lève une ArgumentException.

DateTimeKind.Unspecified ou DateTimeKind.Utc

Convertit le temps universel coordonné (UTC).

Si la conversion de dateTime renvoie une valeur de date et d'heure est antérieure à DateTime.MinValue ou une version DateTime.MaxValue, cette méthode retourne DateTime.MinValue ou DateTime.MaxValue, respectivement.

Remarques à l'attention des appelants :

Sur Windows XP systèmes, cette méthode s'applique uniquement la règle d'ajustement actuelle à la conversion de fuseau horaire si destinationTimeZone est TimeZoneInfo.Local.Par conséquent, la méthode peut ne pas convertit correctement les temps pour les périodes avant l'entrée en vigueur de la règle d'ajustement. Pour plus d'informations, consultez les Notes de la section appelants dans le Local propriété.

L'exemple suivant convertit le temps universel coordonné (UTC) en heure du centre.

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.");
}

.NET Framework
Disponible depuis 3.5
Retour au début
Afficher:
© 2016 Microsoft