System.DateTime.ToBinary メソッドと FromBinary メソッド

[アーティクル]
01/30/2024

この記事では、この API のリファレンスドキュメントへの補足的な解説を提供します。

メソッドを ToBinary 使用して、現在 DateTime のオブジェクトの値をバイナリ値に変換します。その後、バイナリ値とメソッドを FromBinary 使用して、元 DateTime のオブジェクトを再作成します。

重要

場合によっては、DateTimeメソッドによってFromBinary返される値が、メソッドに指定されたToBinary元DateTimeの値と同じではありません。詳細については、次のセクション「ローカル時刻の調整」を参照してください。

構造体は DateTime プライベート Kind フィールドで構成されます。このフィールドは、指定された時刻値が現地時刻、協定世界時 (UTC) に基づいているか、どちらもプライベート Ticks フィールドに連結されていないかを示します。このフィールドには、日付と時刻を指定する 100 ナノ秒のティック数が含まれます。

現地時刻の調整

現地時刻は、ローカルタイムゾーンに合わせて調整された協定世界時であり、そのプロパティに値Localが設定された構造体KindによってDateTime表されます。メソッドによってToBinary生成されるバイナリ表現からローカルDateTime値を復元する場合、FromBinaryメソッドは再作成された値を元の値と等しくしないように調整できます。これは、次のような条件で発生します。

メソッドによってToBinaryローカル DateTime オブジェクトが 1 つのタイムゾーンでシリアル化され、メソッドによってFromBinary別のタイムゾーンで逆シリアル化された場合、結果DateTimeのオブジェクトによって表されるローカル時刻が 2 番目のタイムゾーンに自動的に調整されます。

たとえば、現地時刻の午後 3 時を表すオブジェクトがあると DateTime します。米国太平洋タイムゾーンで実行されているアプリケーションでは、このメソッドを ToBinary 使用してそのオブジェクトを DateTime バイナリ値に変換します。米国東部タイムゾーンで実行されている別のアプリケーションでは、このメソッドを FromBinary 使用してバイナリ値を新しい DateTime オブジェクトに変換します。新しい DateTime オブジェクトの値は午後 6 時で、元の 3 P.M. 値と同じ時点を表しますが、東部タイムゾーンの現地時刻に調整されます。

ローカル DateTime 値のバイナリ表現が、呼び出されるシステムのローカルタイムゾーンで無効な時刻を FromBinary 表している場合、時刻は有効になるように調整されます。

たとえば、標準時から夏時間への移行は、2010 年 3 月 14 日午前 2 時 00 分に、時刻が 1 時間進んでから午前 3 時に、米国の太平洋標準時ゾーンで発生します。この時間間隔は無効な時間です。つまり、このタイムゾーンに存在しない時間間隔です。次の例は、この範囲内にある時刻がメソッドによってバイナリ値に変換され、メソッドによってToBinary FromBinary復元された場合、元の値が有効な時刻になるように調整されることを示しています。この例に示すように、特定の日付と時刻の値をメソッドに渡 TimeZoneInfo.IsInvalidTime すことで、変更の対象となる可能性があるかどうかを判断できます。

using System;

public class Example
{
   public static void Main()
   {
      DateTime localDate = new DateTime(2010, 3, 14, 2, 30, 0, DateTimeKind.Local);
      long binLocal = localDate.ToBinary();
      if (TimeZoneInfo.Local.IsInvalidTime(localDate))
         Console.WriteLine("{0} is an invalid time in the {1} zone.",
                           localDate,
                           TimeZoneInfo.Local.StandardName);

      DateTime localDate2 = DateTime.FromBinary(binLocal);
      Console.WriteLine("{0} = {1}: {2}",
                        localDate, localDate2, localDate.Equals(localDate2));
   }
}
// The example displays the following output:
//    3/14/2010 2:30:00 AM is an invalid time in the Pacific Standard Time zone.
//    3/14/2010 2:30:00 AM = 3/14/2010 3:30:00 AM: False

open System

let localDate = DateTime(2010, 3, 14, 2, 30, 0, DateTimeKind.Local)
let binLocal = localDate.ToBinary()
if TimeZoneInfo.Local.IsInvalidTime localDate then
    printfn $"{localDate} is an invalid time in the {TimeZoneInfo.Local.StandardName} zone."

let localDate2 = DateTime.FromBinary binLocal
printfn $"{localDate} = {localDate2}: {localDate.Equals localDate2}"

// The example displays the following output:
//    3/14/2010 2:30:00 AM is an invalid time in the Pacific Standard Time zone.
//    3/14/2010 2:30:00 AM = 3/14/2010 3:30:00 AM: False

Module Example
   Public Sub Main()
      Dim localDate As Date = DateTime.SpecifyKind(#03/14/2010 2:30AM#, DateTimeKind.Local)
      Dim binLocal As Long = localDate.ToBinary()
      If TimeZoneInfo.Local.IsInvalidTime(localDate) Then
         Console.WriteLine("{0} is an invalid time in the {1} zone.", _
                           localDate, _
                           TimeZoneInfo.Local.StandardName)
      End If
      Dim localDate2 As Date = DateTime.FromBinary(binLocal)
      Console.WriteLine("{0} = {1}: {2}", _
                        localDate, localDate2, localDate.Equals(localDate2))
   End Sub
End Module
' The example displays the following output:
'    3/14/2010 2:30:00 AM is an invalid time in the Pacific Standard Time zone.
'    3/14/2010 2:30:00 AM = 3/14/2010 3:30:00 AM: False

System.DateTime.ToBinary メソッドと FromBinary メソッド

現地時刻の調整

フィードバック

その他のリソース