共用方式為


DateTime.ToFileTimeUtc 方法

定義

將目前 DateTime 物件的值轉換成 Windows 檔案時間。

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

傳回

Int64

以 Windows 檔案時間表示的目前 DateTime 物件的值。

例外狀況

產生的檔案時間會代表西元 1601 年 1 月 1 日午夜 12:00 之前的日期和時間。 UTC。

備註

Windows 的檔案時間是64位的值,代表自西元1601年1月1日午夜起經過12:00 的 100-納秒間隔數 國際標準時間(UTC) 當應用程式建立、存取或寫入至檔案時,Windows 會使用檔案時間來記錄。

ToFileTimeUtc方法 Kind 會使用屬性來判斷目前的物件是否 DateTime 為當地時間、UTC 時間或被視為 utc 時間的未指定時間類型。 如果是當地時間,則會先將時間轉換成 UTC,再執行轉換成 Windows 的檔案時間。

給呼叫者的注意事項

ToFileTimeUtc()方法有時會用來將當地時間轉換為 UTC,並在之後藉由呼叫方法來還原,然後再呼叫方法 FromFileTimeUtc(Int64) ToLocalTime() 。 但是,如果原始時間代表本地時區中的無效時間,這兩個本機時間值將不會相等。 如需詳細資訊,請參閱 ToLocalTime() 方法。

適用於

另請參閱