DateTimeOffset.Implicit(DateTime to DateTimeOffset) Operator
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Definiuje niejawną konwersję DateTimeDateTimeOffset obiektu na obiekt.
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
Parametry
- dateTime
- DateTime
Do obiektu do skonwertowania.
Zwraca
Przekonwertowany obiekt.
Wyjątki
Data i godzina koordynowanego czasu uniwersalnego (UTC), która wynika z zastosowania przesunięcia, jest wcześniejsza niż DateTimeOffset.MinValue.
-lub-
Data i godzina UTC, która wynika z zastosowania przesunięcia, jest późniejsza niż DateTimeOffset.MaxValue.
Uwagi
Metoda Implicit umożliwia kompilatorowi automatyczne konwertowanie DateTime obiektu na DateTimeOffset obiekt bez jawnego operatora rzutowania (w języku C#) lub wywołanie funkcji konwersji (w Visual Basic). Definiuje on konwersję rozszerzającą, która nie obejmuje utraty danych i nie zgłasza elementu OverflowException. Metoda Implicit tworzy kod, taki jak następujący:
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.
Ta metoda jest równoważna konstruktorowi DateTimeOffset . Przesunięcie wynikowego DateTimeOffset obiektu zależy od wartości DateTime.Kind właściwości parametru dateTime
:
Jeśli wartość DateTime.Kind właściwości to DateTimeKind.Utc, data i godzina DateTimeOffset obiektu są ustawione na wartość
dateTime
, a jej Offset właściwość jest równa 0.Jeśli wartość DateTime.Kind właściwości to DateTimeKind.Local lub DateTimeKind.Unspecified, data i godzina DateTimeOffset obiektu jest ustawiona na wartość
dateTime
, a jej Offset właściwość jest ustawiona na przesunięcie bieżącej strefy czasowej systemu lokalnego.
Równoważna metoda dla tego operatora to DateTimeOffset.DateTimeOffset(DateTime)