DateTime.ToFileTimeUtc 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將目前 DateTime 物件的值轉換成 Windows 檔案時間。
public:
long ToFileTimeUtc();public long ToFileTimeUtc ();member this.ToFileTimeUtc : unit -> int64Public Function ToFileTimeUtc () As Long傳回
以 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() 方法。