TimeZoneInfo.ConvertTimeFromUtc(DateTime, TimeZoneInfo) Methode

Definition

Konvertiert eine Coordinated Universal Time (UTC) in die Zeit in einer angegebenen Zeitzone.Converts a Coordinated Universal Time (UTC) to the time in a specified time zone.

public:
 static DateTime ConvertTimeFromUtc(DateTime dateTime, TimeZoneInfo ^ destinationTimeZone);
public static DateTime ConvertTimeFromUtc (DateTime dateTime, TimeZoneInfo destinationTimeZone);
static member ConvertTimeFromUtc : DateTime * TimeZoneInfo -> DateTime

Parameter

dateTime
DateTime

Die Coordinated Universal Time (UTC).The Coordinated Universal Time (UTC).

destinationTimeZone
TimeZoneInfo

Die Zeitzone, in die dateTime konvertiert werden soll.The time zone to convert dateTime to.

Gibt zurück

Das Datum und die Uhrzeit in der Zielzeitzone.The date and time in the destination time zone. Die Kind-Eigenschaft ist Utc, wenn destinationTimeZone den Wert Utc hat, andernfalls hat die Kind-Eigenschaft den Wert Unspecified.Its Kind property is Utc if destinationTimeZone is Utc; otherwise, its Kind property is Unspecified.

Ausnahmen

Die Kind-Eigenschaft von dateTime ist Local.The Kind property of dateTime is Local.

destinationTimeZone ist null.destinationTimeZone is null.

Beispiele

Im folgenden Beispiel wird die koordinierte Weltzeit (UTC) in die zentrale Zeit konvertiert.The following example converts Coordinated Universal Time (UTC) to Central Time.

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.");
}
Dim timeUtc As Date = Date.UtcNow
Try
   Dim cstZone As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time")
   Dim cstTime As Date = TimeZoneInfo.ConvertTimeFromUtc(timeUtc, cstZone)
   Console.WriteLine("The date and time are {0} {1}.", _
                     cstTime, _
                     IIf(cstZone.IsDaylightSavingTime(cstTime), _
                         cstZone.DaylightName, cstZone.StandardName))
Catch e As TimeZoneNotFoundException
   Console.WriteLine("The registry does not define the Central Standard Time zone.")
Catch e As InvalidTimeZoneException
   Console.WriteLine("Registry data on the Central Standard Time zone has been corrupted.")
End Try

Hinweise

Beim Durchführen der Konvertierung wendet die ConvertTimeFromUtc-Methode alle in der destinationTimeZone Zeitzone geltenden Anpassungsregeln an.When performing the conversion, the ConvertTimeFromUtc method applies any adjustment rules in effect in the destinationTimeZone time zone.

Das genaue Verhalten dieser Methode hängt vom Wert der Kind-Eigenschaft des dateTime-Parameters ab, wie in der folgenden Tabelle gezeigt.The precise behavior of this method depends on the value of the Kind property of the dateTime parameter, as the following table shows.

DateTime. Kind-EigenschaftDateTime.Kind property KonvertierungConversion
DateTimeKind.Local Löst eine ArgumentExceptionaus.Throws an ArgumentException.
DateTimeKind.Unspecified oder DateTimeKind.UtcDateTimeKind.Unspecified or DateTimeKind.Utc Konvertiert die koordinierte Weltzeit (UTC).Converts from Coordinated Universal Time (UTC).

Wenn die Konvertierung von dateTime führt ein Datum und Uhrzeit-Wert, der älter als DateTime.MinValue oder später als DateTime.MaxValue, gibt diese Methode DateTime.MinValue oder DateTime.MaxValuebzw.If the conversion of dateTime results in a date and time value that is earlier than DateTime.MinValue or later than DateTime.MaxValue, this method returns DateTime.MinValue or DateTime.MaxValue, respectively.

Gilt für:

Siehe auch