DateTimeOffset Yapı

Tanım

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, ISpanFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, IUtf8SpanFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, ISpanFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, IUtf8SpanFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

[System.Serializable]
public struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

type DateTimeOffset = struct
    interface IFormattable

type DateTimeOffset = struct
    interface IFormattable
    interface IDeserializationCallback
    interface ISerializable

type DateTimeOffset = struct
    interface ISpanFormattable
    interface IFormattable
    interface IDeserializationCallback
    interface ISerializable

type DateTimeOffset = struct
    interface IFormattable
    interface IParsable<DateTimeOffset>
    interface ISpanFormattable
    interface ISpanParsable<DateTimeOffset>
    interface IDeserializationCallback
    interface ISerializable

type DateTimeOffset = struct
    interface IFormattable
    interface IParsable<DateTimeOffset>
    interface ISpanFormattable
    interface ISpanParsable<DateTimeOffset>
    interface IDeserializationCallback
    interface ISerializable
    interface IUtf8SpanFormattable

type DateTimeOffset = struct
    interface IFormattable
    interface IParsable<DateTimeOffset>
    interface ISpanFormattable
    interface ISpanParsable<DateTimeOffset>
    interface IUtf8SpanFormattable
    interface IDeserializationCallback
    interface ISerializable

[<System.Serializable>]
type DateTimeOffset = struct
    interface IFormattable
    interface ISerializable
    interface IDeserializationCallback

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IEquatable(Of DateTimeOffset), IFormattable

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), IFormattable, ISerializable

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), ISerializable, ISpanFormattable

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), IParsable(Of DateTimeOffset), ISerializable, ISpanFormattable, ISpanParsable(Of DateTimeOffset)

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), IParsable(Of DateTimeOffset), ISerializable, ISpanFormattable, ISpanParsable(Of DateTimeOffset), IUtf8SpanFormattable

Devralma

Object

ValueType

DateTimeOffset

Öznitelikler

SerializableAttribute

Uygulamalar

IComparable IComparable<DateTimeOffset> IEquatable<DateTimeOffset> IFormattable IDeserializationCallback ISerializable ISpanFormattable IParsable<DateTimeOffset> IParsable<TSelf> ISpanParsable<DateTimeOffset> IUtf8SpanFormattable

Açıklamalar

YapıDateTimeOffset, geçerli DateTimeOffset örneğin tarih ve saati ile Eşgüdümlü Evrensel Saat (UTC) arasındaki farkı tanımlayan bir özelliğiyle birlikte bir DateTimeOffset değer içerir. UTC ile ilgili bir tarih ve saati tam olarak tanımladığından, DateTimeOffset yapıda olduğu gibi DateTime bir Kind üye yoktur. UTC değeri 12:00:00:00 gece yarısı, 1 Ocak 0001 Anno Domini (Ortak Çağ) ile 11:59:59, 31 Aralık 9999 A.D. (C.E.) arasında değişen değerlerle tarih ve saatleri temsil eder.

Bir DateTimeOffset değerin zaman bileşeni, keneler olarak adlandırılan 100 nanosaniyelik birimlerle ölçülür ve belirli bir tarih takvimde 12:00 gece yarısından (1 Ocak 0001 M.Ö. (C.E.) GregorianCalendar bu yana kene sayısıdır. Değer DateTimeOffset her zaman açık veya varsayılan takvim bağlamında ifade edilir. Artık saniyelere atılabilir olan keneler, toplam değer çizgisi sayısına dahil değildir.

Bir DateTimeOffset değer bir uzaklık içerse de, tam saat dilimine duyarlı bir veri yapısı değildir. UTC'den uzaklık bir saat diliminin özelliklerinden biri olsa da, kesin olarak bir saat dilimi tanımlamaz. Birden çok saat dilimi UTC'den aynı uzaklığı paylaşmakla kalmaz, aynı zamanda gün ışığından yararlanma saati gözlemlerse tek bir saat diliminin uzaklığı da değişir. Başka bir deyişle, bir DateTimeOffset değer saat dilimiyle ilişkilendirildiğinde, artık özgün saat dilimine kesin bir şekilde bağlanılamaz.

DateTimeOffset Bir yapı olduğundan, bildirilmiş ancak başka bir şekilde başlatılmamış bir DateTimeOffset nesne, üye alanlarının her biri için varsayılan değerleri içerir. Bu, özelliğinin olarak, OffsetDateTimeOffset.MinValue özelliğinin DateTime ise olarak ayarlandığı TimeSpan.Zeroanlamına gelir.

Yapısının aşırı yüklenmiş oluşturucularına DateTime benzer şekilde oluşturucusunun aşırı yüklemelerinden herhangi birini çağırarak yeni DateTimeOffset bir değer oluşturabilirsiniz. Ayrıca bir değer atayarak yeni DateTimeOffset bir DateTime değer de oluşturabilirsiniz. Bu örtük bir dönüştürmedir; bir dönüştürme işleci (C#'de) veya dönüştürme yöntemine (Visual Basic'te) çağrı gerektirmez. Ayrıca, , ParseExact, ve dahil olmak üzere Parsebir dizi statik dize ayrıştırma yöntemini çağırarak bir tarih ve TryParseExactsaatin dize gösteriminden bir değer başlatabilirsiniz DateTimeOffsetTryParse.

Yapı üyeleri DateTimeOffset aşağıdaki alanlarda işlevsellik sağlar:

• Tarih ve saat aritmetiği.

  Belirli DateTimeOffset bir değerden tarih veya saat aralıkları ekleyebilir veya çıkarabilirsiniz. Değerleri olan DateTimeOffset aritmetik işlemler, değerleri olan DateTime işlemlerden farklı olarak, bir sonuç döndürürken zaman uzaklıklarındaki farklara göre ayarlanır. Örneğin aşağıdaki kod, geçerli yerel saati geçerli UTC saatinden çıkarmak için değişkenleri kullanır DateTime . Kod daha sonra aynı işlemi gerçekleştirmek için değişkenleri kullanır DateTimeOffset . Değerleri içeren DateTime çıkarma, yerel saat diliminin UTC ile arasındaki farkını döndürürken, değerlerle DateTimeOffset çıkarma işlevi döndürür TimeSpan.Zero.

  using System;
  
  public class DateArithmetic
  {
     public static void Main()
     {
        DateTime date1, date2;
        DateTimeOffset dateOffset1, dateOffset2;
        TimeSpan difference;
  
        // Find difference between Date.Now and Date.UtcNow
        date1 = DateTime.Now;
        date2 = DateTime.UtcNow;
        difference = date1 - date2;
        Console.WriteLine("{0} - {1} = {2}", date1, date2, difference);
  
        // Find difference between Now and UtcNow using DateTimeOffset
        dateOffset1 = DateTimeOffset.Now;
        dateOffset2 = DateTimeOffset.UtcNow;
        difference = dateOffset1 - dateOffset2;
        Console.WriteLine("{0} - {1} = {2}",
                          dateOffset1, dateOffset2, difference);
        // If run in the Pacific Standard time zone on 4/2/2007, the example
        // displays the following output to the console:
        //    4/2/2007 7:23:57 PM - 4/3/2007 2:23:57 AM = -07:00:00
        //    4/2/2007 7:23:57 PM -07:00 - 4/3/2007 2:23:57 AM +00:00 = 00:00:00
     }
  }
  

  open System
  
  // Find difference between Date.Now and Date.UtcNow
  let date1 = DateTime.Now
  let date2 = DateTime.UtcNow
  let difference1 = date1 - date2
  printfn $"{date1} - {date2} = {difference1}"
  
  // Find difference between Now and UtcNow using DateTimeOffset
  let dateOffset1 = DateTimeOffset.Now
  let dateOffset2 = DateTimeOffset.UtcNow
  let difference2 = dateOffset1 - dateOffset2
  printfn $"{dateOffset1} - {dateOffset2} = {difference2}"
                   
  // If run in the Pacific Standard time zone on 1/7/2022, the example
  // displays the following output to the console:
  //    1/7/2022 6:45:10 PM - 1/8/2022 2:45:10 AM = -08:00:00.0072573
  //    1/7/2022 6:45:10 PM -08:00 - 1/8/2022 2:45:10 AM +00:00 = -00:00:00.0000278
  

  Module DateArithmetic
     Public Sub Main()
        Dim date1, date2 As Date
        Dim dateOffset1, dateOffset2 As DateTimeOffset
        Dim difference As TimeSpan
        
        ' Find difference between Date.Now and Date.UtcNow
        date1 = Date.Now
        date2 = Date.UtcNow
        difference = date1 - date2
        Console.WriteLine("{0} - {1} = {2}", date1, date2, difference)
        
        ' Find difference between Now and UtcNow using DateTimeOffset
        dateOffset1 = date.Now
        dateOffset2 = date.UtcNow
        difference = dateOffset1 - dateOffset2
        Console.WriteLine("{0} - {1} = {2}", _
                          dateOffset1, dateOffset2, difference)
        ' If run in the Pacific Standard time zone on 4/2/2007, the example
        ' displays the following output to the console:
        '    4/2/2007 7:23:57 PM - 4/3/2007 2:23:57 AM = -07:00:00
        '    4/2/2007 7:23:57 PM -07:00 - 4/3/2007 2:23:57 AM +00:00 = 00:00:00                        
     End Sub
  End Module
  

• Tür dönüştürme işlemleri.

  Değerleri değerlere DateTime dönüştürebilir DateTimeOffset ve bunun tersi de geçerlidir.

• Zaman işleme ve ayıklama işlemleri.

  Değerin tarihini veya saatini DateTimeOffset ayıklayabilirsiniz. Ayrıca, yıl veya ayı gibi belirli DateTimeOffset bir bileşenin değerini de alabilirsiniz.

• Tarih ve saat dönüştürme.

  Herhangi bir DateTimeOffset değeri, başka bir DateTimeOffset saat dilimindeki aynı noktayı temsil eden başka bir değere dönüştürebilirsiniz. Ancak, bir saat diliminin ayarlama kuralları yalnızca yöntemi söz konusu olduğunda ToLocalTime uygulanır ve bu da bir DateTimeOffset değeri yerel sistem bölgesindeki tarih ve saate dönüştürür.

• Tarih ve saat karşılaştırması.

  Belirli DateTimeOffset bir değerin başka bir değerden önce mi yoksa başka bir DateTimeOffset değerle aynı mı yoksa daha sonra mı olduğunu belirleyebilirsiniz. Karşılaştırma gerçekleştirilmeden önce tüm değerler UTC'ye dönüştürülür.

Oluşturucular

Alanlar

Özellikler

Yöntemler

İşleçler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• DateTime, DateTimeOffset, TimeSpan ve TimeZoneInfo Arasında Seçim
• Örnek: .NET Core WinForms Biçimlendirme Yardımcı Programı (C#)
• Örnek: .NET Core WinForms Biçimlendirme Yardımcı Programı (Visual Basic)