DateTimeOffset.Implicit(DateTime to DateTimeOffset) Betreiber

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Source:

DateTimeOffset.cs

Definiert eine implizite Konvertierung eines DateTime-Objekts in ein DateTimeOffset.

public:
 static operator DateTimeOffset(DateTime dateTime);

public static implicit operator DateTimeOffset (DateTime dateTime);

static member op_Implicit : DateTime -> DateTimeOffset

Public Shared Widening Operator CType (dateTime As DateTime) As DateTimeOffset

Parameter

dateTime

DateTime

Das zu konvertierende Objekt.

Gibt zurück

DateTimeOffset

Das konvertierte Objekt.

Ausnahmen

ArgumentOutOfRangeException

Datum und Uhrzeit der koordinierten Weltzeit (UTC), die sich aus dem Anwenden des Offsets ergeben, sind früher als DateTimeOffset.MinValue.

- oder -

Das UTC-Datum und die Uhrzeit, die sich aus dem Anwenden des Offsets ergeben, sind höher als DateTimeOffset.MaxValue.

Hinweise

Die Implicit -Methode ermöglicht es dem Compiler, ein DateTime Objekt ohne expliziten Umwandlungsoperator (in C#) oder einen Aufruf einer Konvertierungsfunktion (in Visual Basic) automatisch in ein DateTimeOffset Objekt zu konvertieren. Es definiert eine erweiternde Konvertierung, die keinen Datenverlust mit sich bringt und keine auslöst OverflowException. Die Implicit -Methode ermöglicht Code wie den folgenden:

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 ist, wird DateTimeKind.Utcdas Datum und die Uhrzeit des DateTimeOffset Objekts gleich dateTimefestgelegt, und seine Offset Eigenschaft ist gleich 0.

• Wenn der Wert der DateTime.Kind -Eigenschaft oder DateTimeKind.UnspecifiedistDateTimeKind.Local, werden Datum und Uhrzeit des DateTimeOffset Objekts gleich dateTimefestgelegt, und seine Offset Eigenschaft ist gleich dem Offset der aktuellen Zeitzone des lokalen Systems festgelegt.

Die entsprechende Methode für diesen Operator ist DateTimeOffset.DateTimeOffset(DateTime)