DateTimeOffset.Implicit(DateTime to DateTimeOffset) Operatör

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

DateTimeOffset.cs

Bir nesnenin DateTime nesneye örtük dönüştürmesini DateTimeOffset 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 geç olur.

Açıklamalar

yöntemi, Implicit derleyicinin açık bir DateTimeOffset atama işleci (C#'de) veya dönüştürme işlevine çağrı (Visual Basic'te) olmadan bir nesneyi 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 DateTime.Kind özelliğinin dateTime değerine bağlıdır:

• özelliğinin DateTime.Kind değeri iseDateTimeKind.Utc, nesnenin DateTimeOffset tarih ve saati değerine, dateTimeOffset ö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şlecin eşdeğer yöntemi şudur: DateTimeOffset.DateTimeOffset(DateTime)