DateTimeOffset.Implicit(DateTime to DateTimeOffset) Operator

Definition

Definiert eine implizite Konvertierung eines DateTime-Objekts in ein DateTimeOffset-Objekt.Defines an implicit conversion of a DateTime object to a DateTimeOffset object.

public:
 static operator DateTimeOffset(DateTime dateTime);
public static implicit operator DateTimeOffset (DateTime dateTime);
static member op_Implicit : DateTime -> DateTimeOffset

Parameter

dateTime
DateTime

Das zu konvertierende Objekt.The object to convert.

Gibt zurück

Das konvertierte Objekt.The converted object.

Ausnahmen

Der UTC-Zeitpunkt (Datum und Uhrzeit in koordinierter Weltzeit), der sich nach Anwenden des Offsets ergeben hat, liegt vor MinValue.The Coordinated Universal Time (UTC) date and time that results from applying the offset is earlier than MinValue.

- oder --or- Der UTC-Zeitpunkt (Datum und Uhrzeit), der sich nach Anwenden des Offsets ergeben hat, liegt nach MaxValue.The UTC date and time that results from applying the offset is later than MaxValue.

Hinweise

Die Implicit -Methode ermöglicht es dem Compiler, das DateTime automatische Konvertieren eines DateTimeOffset -Objekts in ein-Objekt ohne einen C#expliziten Umwandlungs Operator (in) oder durch einen-Rückruf einer Konvertierungs Funktion (in Visual Basic).The Implicit method enables the compiler to automatically convert a DateTime object to a DateTimeOffset object without an explicit casting operator (in C#) or a call to a conversion function (in Visual Basic). Es definiert eine erweiternde Konvertierung, die keinen Datenverlust umfasst und keine OverflowExceptionauslöst.It defines a widening conversion that does not involve data loss and does not throw an OverflowException. Mit Implicit der-Methode wird Code wie der folgende ermöglicht:The Implicit method makes code such as the following possible:

   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.
   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.This method is equivalent to the DateTimeOffset constructor. Der Offset des resultierenden DateTimeOffset Objekts hängt vom Wert DateTime.Kind der-Eigenschaft des dateTime -Parameters ab:The offset of the resulting DateTimeOffset object depends on the value of the DateTime.Kind property of the dateTime parameter:

Die äquivalente Methode für diesen Operator ist.DateTimeOffset.DateTimeOffset(DateTime)The equivalent method for this operator is DateTimeOffset.DateTimeOffset(DateTime)

Gilt für: