DateTimeOffset.Implicit(DateTime to DateTimeOffset) Operatör

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

DateTimeOffset.cs

Bir nesnenin nesneye örtük bir DateTimeDateTimeOffset dönüştürmesini tanımlar.

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

Parametreler

dateTime

DateTime

Dönüştürülecek nesne.

Döndürülenler

DateTimeOffset

Dönüştürülen nesne.

Özel durumlar

ArgumentOutOfRangeException

Uzaklık uygulanmasından kaynaklanan Eşgüdümlü Evrensel Saat (UTC) tarih ve saati DateTimeOffset.MinValue değerinden daha eskidir.

-veya-

Uzaklık uygulanmasından kaynaklanan UTC tarih ve saati DateTimeOffset.MaxValue değerinden daha sonradır.

Açıklamalar

yöntemi, Implicit derleyicinin bir nesneyi açık bir DateTimeOffset atama işleci (C#'da) veya dönüştürme işlevine (Visual Basic'te) bir çağrı olmadan otomatik olarak bir nesneye dönüştürmesini DateTime sağlar. Veri kaybı içermeyen ve OverflowExceptionoluşturmayan bir genişletme dönüştürmesi tanımlar. Implicit yöntemi aşağıdaki gibi bir kodu mümkün kılar:

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.

Bu yöntem oluşturucuya DateTimeOffset eşdeğerdir. Sonuçta DateTimeOffset elde edilen nesnenin uzaklığı, parametresinin özelliğinin DateTime.KinddateTime değerine bağlıdır:

• özelliğinin DateTime.Kind değeri iseDateTimeKind.Utc, nesnenin DateTimeOffset tarih ve saati değerine eşitdateTimeOffset, özelliği ise 0'a eşit olarak ayarlanır.

• Özelliğin DateTime.Kind değeri veya DateTimeKind.UnspecifiediseDateTimeKind.Local, nesnenin DateTimeOffset tarih ve saati değerine eşitdateTimeOffset, özelliği ise yerel sistemin geçerli saat diliminin uzaklığıyla eşit olarak ayarlanır.

Bu işleç için eşdeğer yöntem şudur: DateTimeOffset.DateTimeOffset(DateTime)