DateTimeOffset 構造体

定義

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 struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable

[System.Serializable]
public struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, 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

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

type DateTimeOffset = struct
    interface IFormattable

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

type DateTimeOffset = struct
    interface IFormattable
    interface IDeserializationCallback
    interface ISerializable

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

継承

Object

ValueType

DateTimeOffset

属性

SerializableAttribute

実装

IComparable IComparable<DateTimeOffset> IEquatable<DateTimeOffset> IFormattable IDeserializationCallback ISerializable

注釈

DateTimeOffset構造体には、現在のDateTime インスタンスの日時と協定世界時 (UTC) の差を定義するOffset プロパティと共に、DateTimeOffset値が含まれています。 UTC に対する日付と時刻を正確に定義するため、DateTimeOffset構造体には、Kind構造体と同様に、DateTimeメンバーは含まれません。 これは、UTC の範囲が 12:00:00:00、0001 年 1 月 1 日の Anno Domini (Common Era) から、9999 年 12 月 31 日午後 11 時 59 分 59 分 59 秒 (C.E.) までの日付と時刻を表します。

DateTimeOffset値の時間成分はティックと呼ばれる 100 ナノ秒単位で測定され、特定の日付は、GregorianCalendar カレンダーの 0001 年 1 月 1 日午前 12 時 00 分からのティック数です。 DateTimeOffset値は、常に明示的または既定のカレンダーのコンテキストで表されます。 閏秒に起因するティックは、ティックの合計数には含まれません。

DateTimeOffset値にはオフセットが含まれますが、完全なタイム ゾーン対応のデータ構造ではありません。 UTC からのオフセットはタイム ゾーンの特性の 1 つですが、タイム ゾーンを明確に識別することはありません。 複数のタイム ゾーンが UTC からの同じオフセットを共有するだけでなく、夏時間が観察されると、1 つのタイム ゾーンのオフセットが変わります。 つまり、 DateTimeOffset 値がタイム ゾーンとの関連付けが解除されるとすぐに、元のタイム ゾーンに明確にリンクできなくなります。

DateTimeOffsetは構造体であるため、宣言されているが初期化されていないDateTimeOffset オブジェクトには、各メンバー フィールドの既定値が含まれます。 つまり、 DateTime プロパティは DateTimeOffset.MinValue に設定され、 Offset プロパティは TimeSpan.Zero に設定されます。

DateTimeOffset構造体のオーバーロードされたコンストラクターに似たコンストラクターのオーバーロードのいずれかを呼び出すことによって、新しいDateTime値を作成できます。 DateTimeOffset値を割り当てることで、新しいDateTime値を作成することもできます。 これは暗黙的な変換です。キャスト演算子 (C# の場合) や変換メソッドの呼び出し (Visual Basic の場合) は必要ありません。 DateTimeOffset、Parse、ParseExact、TryParseなど、さまざまな静的文字列解析メソッドを呼び出すことによって、日付と時刻の文字列形式からTryParseExact値を初期化することもできます。

DateTimeOffset構造体のメンバーは、次の領域で機能を提供します。

• 日付と時刻の算術演算。

  特定の DateTimeOffset 値から日付または時間間隔を加算または減算できます。 DateTimeOffset値を使用した算術演算は、DateTime値を持つ演算とは異なり、結果を返すときの時間オフセットの違いを調整します。 たとえば、次のコードでは、 DateTime 変数を使用して、現在の UTC 時刻から現在の現地時刻を減算します。 その後、コードは DateTimeOffset 変数を使用して同じ操作を実行します。 DateTime値を使用した減算はローカル タイム ゾーンの UTC との差を返し、DateTimeOffset値を使用した減算は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
  

• 型変換操作。

  DateTimeOffset値をDateTime値に変換したり、その逆を行うことができます。

• 時間操作と抽出操作。

  DateTimeOffset値の日付または時刻を抽出できます。 特定の DateTimeOffset コンポーネントの値 (年や月など) を取得することもできます。

  Note

  分や秒などの他の時間間隔に変換するティック値を使用する場合は、 TimeSpan.TicksPerDay、 TimeSpan.TicksPerHour、 TimeSpan.TicksPerMinute、 TimeSpan.TicksPerSecond、または TimeSpan.TicksPerMillisecond 定数を使用して変換を実行する必要があります。 たとえば、指定したティック数で表される秒数をSecond値のDateTimeOffsetコンポーネントに追加するには、式dateValue.Second + nTicks/Timespan.TicksPerSecondを使用します。

• 日付と時刻の変換。

  任意の DateTimeOffset 値を、別のタイム ゾーン内の同じ時点を表す別の DateTimeOffset 値に変換できます。 ただし、タイム ゾーンの調整規則は、 ToLocalTime メソッドの場合にのみ適用され、 DateTimeOffset 値がローカル システム ゾーンの日付と時刻に変換されます。

• 日付と時刻の比較。

  特定の DateTimeOffset 値が、別の DateTimeOffset 値よりも前か、同じか、またはそれ以降かを判断できます。 比較を実行する前に、すべての値が UTC に変換されます。

こちらもご覧ください

• DateTime、DateTimeOffset、TimeSpan、TimeZoneInfo の選択
• サンプル: .NET Core WinForms 書式設定ユーティリティ (C#)
• サンプル: .NET Core WinForms 書式設定ユーティリティ (Visual Basic)