DateTimeOffset.Implicit(DateTime to DateTimeOffset) Operator
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Definiert eine implizite Konvertierung eines DateTime Objekts in ein DateTimeOffset Objekt.
public:
static operator DateTimeOffset(DateTime dateTime);public static implicit operator DateTimeOffset(DateTime dateTime);static member op_Implicit : DateTime -> DateTimeOffsetPublic Shared Widening Operator CType (dateTime As DateTime) As DateTimeOffsetParameter
- dateTime
- DateTime
Das zu konvertierende Objekt.
Gibt zurück
Das konvertierte Objekt.
Ausnahmen
Das Datum und die Uhrzeit der koordinierten Weltzeit (Coordinated Universal Time, UTC), die aus der Anwendung des Offsets resultiert, ist früher als DateTimeOffset.MinValue.
- oder -
Das UTC-Datum und die Uhrzeit, die aus der Anwendung des Offsets resultiert, ist später als DateTimeOffset.MaxValue.
Hinweise
Mit Implicit der Methode kann der Compiler automatisch ein DateTime Objekt ohne expliziten Umwandlungsoperator (in C#) oder einen Aufruf einer Konvertierungsfunktion (in Visual Basic) in ein DateTimeOffset Objekt konvertieren. Es definiert eine Erweiterungskonvertierung, die keinen Datenverlust beinhaltet und keinen Auslösen eines OverflowException. Die Implicit Methode macht Code wie die folgenden möglich:
DateTimeOffset timeWithOffset;
timeWithOffset = new DateTime(2008, 7, 3, 18, 45, 0);
Console.WriteLine(timeWithOffset.ToString());
timeWithOffset = DateTime.UtcNow;
Console.WriteLine(timeWithOffset.ToString());
timeWithOffset = DateTime.SpecifyKind(DateTime.Now,
DateTimeKind.Unspecified);
Console.WriteLine(timeWithOffset.ToString());
timeWithOffset = new DateTime(2008, 7, 1, 2, 30, 0) +
new TimeSpan(1, 0, 0, 0);
Console.WriteLine(timeWithOffset.ToString());
timeWithOffset = new DateTime(2008, 1, 1, 2, 30, 0);
Console.WriteLine(timeWithOffset.ToString());
// The example produces the following output if run on 3/20/2007
// at 6:25 PM on a computer in the U.S. Pacific Daylight Time zone:
// 7/3/2008 6:45:00 PM -07:00
// 3/21/2007 1:25:52 AM +00:00
// 3/20/2007 6:25:52 PM -07:00
// 7/2/2008 2:30:00 AM -07:00
// 1/1/2008 2:30:00 AM -08:00
//
// The last example shows automatic adaption to the U.S. Pacific Time
// for winter dates.
let timeWithOffset = DateTime(2008, 7, 3, 18, 45, 0)
printfn $"{timeWithOffset}"
let timeWithOffset = DateTime.UtcNow
printfn $"{timeWithOffset}"
let timeWithOffset =
DateTime.SpecifyKind(DateTime.Now, DateTimeKind.Unspecified)
printfn $"{timeWithOffset}"
let timeWithOffset =
DateTime(2008, 7, 1, 2, 30, 0)
+ TimeSpan(1, 0, 0, 0)
printfn $"{timeWithOffset}"
let timeWithOffset = DateTime(2008, 1, 1, 2, 30, 0)
printfn $"{timeWithOffset}"
// The example produces the following output if run on 3/20/2007
// at 6:25 PM on a computer in the U.S. Pacific Daylight Time zone:
// 7/3/2008 6:45:00 PM -07:00
// 3/21/2007 1:25:52 AM +00:00
// 3/20/2007 6:25:52 PM -07:00
// 7/2/2008 2:30:00 AM -07:00
// 1/1/2008 2:30:00 AM -08:00
//
// The last example shows automatic adaption to the U.S. Pacific Time
// for winter dates.
Dim timeWithOffset As DateTimeOffset
timeWithOffset = #07/03/2008 6:45PM#
Console.WriteLine(timeWithOffset.ToString())
timeWithOffset = Date.UtcNow
Console.WriteLine(timeWithOffset.ToString())
timeWithOffset = Date.SpecifyKind(Date.Now, DateTimeKind.Unspecified)
Console.WriteLine(timeWithOffset.ToString())
timeWithOffset = #07/01/2008 2:30AM# + New TimeSpan(1, 0, 0, 0)
Console.WriteLine(timeWithOffset.ToString())
timeWithOffset = #01/01/2008 2:30AM#
Console.WriteLine(timeWithOffset.ToString())
' The example produces the following output if run on 3/20/2007
' at 6:25 PM on a computer in the U.S. Pacific Daylight Time zone:
' 7/3/2008 6:45:00 PM -07:00
' 3/21/2007 1:25:52 AM +00:00
' 3/20/2007 6:25:52 PM -07:00
' 7/2/2008 2:30:00 AM -07:00
' 1/1/2008 2:30:00 AM -08:00
'
' The last example shows automatic adaption to the U.S. Pacific Time
' for winter dates.
Diese Methode entspricht dem DateTimeOffset Konstruktor. Der Offset des resultierenden DateTimeOffset Objekts hängt vom Wert der DateTime.Kind Eigenschaft des dateTime Parameters ab:
Wenn der Wert der DateTime.Kind Eigenschaft lautet, wird DateTimeKind.Utcdas Datum und die Uhrzeit des DateTimeOffset Objekts auf "
dateTime0" festgelegt, und seine Offset Eigenschaft wird auf 0 festgelegt.Wenn der Wert der DateTime.Kind Eigenschaft das DateTimeKind.UnspecifiedDateTimeKind.Local Datum und die Uhrzeit des DateTimeOffset Objekts entspricht
dateTime, und seine Offset Eigenschaft auf den Offset der aktuellen Zeitzone des lokalen Systems festgelegt wird.
Die entsprechende Methode für diesen Operator ist DateTimeOffset.DateTimeOffset(DateTime)
