DateTime.ToFileTimeUtc Metode

Definisi

Ruang nama:

System

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

DateTime.cs

Mengonversi nilai objek saat ini DateTime ke waktu file Windows.

public:
 long ToFileTimeUtc();

public long ToFileTimeUtc();

member this.ToFileTimeUtc : unit -> int64

Public Function ToFileTimeUtc () As Long

Mengembalikan

Int64

Nilai objek saat ini DateTime dinyatakan sebagai waktu file Windows.

Pengecualian

ArgumentOutOfRangeException

Waktu file yang dihasilkan akan mewakili tanggal dan waktu sebelum 12:00 tengah malam 1 Januari 1601 C.E. UTC.

Keterangan

Waktu file Windows adalah nilai 64-bit yang menunjukkan jumlah interval 100 nanodetik yang telah berlalu sejak 12:00 tengah malam, 1 Januari 1601 A.D. (C.E.) Waktu Universal Terkoordinasi (UTC). Windows menggunakan waktu file untuk merekam ketika aplikasi membuat, mengakses, atau menulis ke file.

Metode ini ToFileTimeUtc menggunakan Kind properti untuk menentukan apakah objek saat ini DateTime adalah waktu lokal, waktu UTC, atau jenis waktu yang tidak ditentukan, yang diperlakukan sebagai waktu UTC. Jika ini adalah waktu lokal, ini mengonversi waktu ke UTC sebelum melakukan konversi ke waktu file Windows.

Catatan Bagi Pemanggil

Metode ToFileTimeUtc() ini kadang-kadang digunakan untuk mengonversi waktu lokal ke UTC, dan kemudian untuk memulihkannya dengan memanggil FromFileTimeUtc(Int64) metode diikuti dengan ToLocalTime() metode . Namun, jika waktu asli mewakili waktu yang tidak valid di zona waktu lokal, dua nilai waktu lokal tidak akan sama. Untuk informasi tambahan, lihat ToLocalTime() metode .

Lihat juga

• ToFileTime()
• Int64
• ToUniversalTime()
• GetUtcOffset(DateTime)