DateTime.ToFileTimeUtc メソッド


現在の DateTime オブジェクトの値を Windows ファイル時刻に変換します。Converts the value of the current DateTime object to a Windows file time.

 long ToFileTimeUtc();
public long ToFileTimeUtc ();
member this.ToFileTimeUtc : unit -> int64
Public Function ToFileTimeUtc () As Long



現在の DateTime オブジェクトの値を Windows ファイル時刻で表した値。The value of the current DateTime object expressed as a Windows file time.


結果のファイル時刻が、The resulting file time would represent a date and time before 12:00 midnight January 1, 1601 C.E. (UTC)。UTC.


Windows ファイル時刻は、64年1月 1601 1 日の午前0時から12:00 に経過した100ナノ秒間隔の数を表すビット値です。A Windows file time is a 64-bit value that represents the number of 100-nanosecond intervals that have elapsed since 12:00 midnight, January 1, 1601 A.D. 西暦協定世界時 (UTC)。(C.E.) Coordinated Universal Time (UTC). Windows では、ファイルの作成、アクセス、またはファイルへの書き込みを行うときに、ファイルの時刻が記録されます。Windows uses a file time to record when an application creates, accesses, or writes to a file.

ToFileTimeUtc メソッドは、Kind プロパティを使用して、現在の DateTime オブジェクトが現地時刻、UTC 時刻、または UTC 時刻として扱われる指定されていない時刻のいずれであるかを判断します。The ToFileTimeUtc method uses the Kind property to determine whether the current DateTime object is a local time, a UTC time, or an unspecified kind of time which is treated as a UTC time. 現地時刻の場合は、時刻を UTC に変換してから、Windows ファイル時刻への変換を実行します。If it is a local time, it converts the time to UTC before performing the conversion to a Windows file time.

注意 (呼び出し元)

ToFileTimeUtc() メソッドは、現地時刻を UTC に変換するために使用されることがあります。その後、FromFileTimeUtc(Int64) メソッドを呼び出し、その後に ToLocalTime() メソッドを呼び出すことによって復元します。The ToFileTimeUtc() method is sometimes used to convert a local time to UTC, and subsequently to restore it by calling the FromFileTimeUtc(Int64) method followed by the ToLocalTime() method. ただし、元の時刻がローカルタイムゾーンの無効な時刻を表している場合、2つのローカル時刻値は等しくなりません。However, if the original time represents an invalid time in the local time zone, the two local time values will not be equal. 詳細については、ToLocalTime() メソッドを参照してください。For additional information, see the ToLocalTime() method.