DateTime.ToFileTimeUtc DateTime.ToFileTimeUtc DateTime.ToFileTimeUtc DateTime.ToFileTimeUtc Method

定義

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

public:
 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. 西暦 1601 年 1 月 1 日深夜 12:00 時 (UTC) よりも前の日時を表すことがあります。UTC.

注釈

Windows ファイル時刻の西暦 1601 年 1 月 1 日午前 12時 00分以降の経過時間を 100 ナノ秒間隔の数を表す 64 ビット値は、します。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.

適用対象

こちらもご覧ください