DateTime.ToFileTimeUtc 方法
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將目前 DateTime 物件的值轉換成 Windows 檔案時間。
public:
long ToFileTimeUtc();C#
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() 方法。
| 產品 | 版本 |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |