DateTime.ToFileTimeUtc メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在の DateTime オブジェクトの値を Windows ファイル時刻に変換します。
public:
long ToFileTimeUtc();public long ToFileTimeUtc ();member this.ToFileTimeUtc : unit -> int64Public Function ToFileTimeUtc () As Long戻り値
現在の DateTime オブジェクトの値を Windows ファイル時刻で表した値。
例外
結果のファイル時刻が、 西暦 1601 年 1 月 1 日深夜 12:00 時 (UTC) よりも前の日時を表すことがあります。
注釈
Windows ファイル時刻は、1601 年 1 月 1 日午前 12 時 00 分から経過した 100 ナノ秒間隔の数を表す 64 ビット値です。 年月日はキリスト紀元で、時刻は協定世界時 (UTC) です。 Windows では、アプリケーションがファイルを作成、アクセス、またはファイルに書き込むときに、ファイル時刻を使用して記録します。
このメソッドは ToFileTimeUtc 、このプロパティを Kind 使用して、現在 DateTime のオブジェクトが現地時刻、UTC 時刻、または UTC 時刻として扱われる特定の種類の時刻であるかどうかを判断します。 ローカル時刻の場合は、Windows ファイル時刻への変換を実行する前に時刻を UTC に変換します。
注意 (呼び出し元)
このToFileTimeUtc()メソッドは、ローカル時刻を UTC に変換し、その後、メソッドの後ToLocalTime()にメソッドを呼び出FromFileTimeUtc(Int64)して復元するために使用される場合があります。 ただし、元の時刻がローカル タイム ゾーンの無効な時刻を表す場合、2 つのローカル時刻の値は等しくありません。 詳細については、メソッドを ToLocalTime() 参照してください。