DateTime.ToFileTimeUtc Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Source:

DateTime.cs

Geçerli DateTime nesnenin değerini Windows dosya zamanına dönüştürür.

public:
 long ToFileTimeUtc();

public long ToFileTimeUtc ();

member this.ToFileTimeUtc : unit -> int64

Public Function ToFileTimeUtc () As Long

Döndürülenler

Int64

Geçerli nesnenin DateTime Windows dosya zamanı olarak ifade edilen değeri.

Özel durumlar

ArgumentOutOfRangeException

Sonuçta elde edilen dosya saati, 1 Ocak 1601 UTC saat 12:00 gece yarısından önceki bir tarih ve saati temsil eder.

Açıklamalar

Windows dosya süresi, 1 Ocak 1601 M.S. (C.E.) 12:00 gece yarısından bu yana geçen 100 nanosaniyelik aralık sayısını temsil eden 64 bitlik bir değerdir. Eşgüdümlü Evrensel Saat (UTC). Windows, bir uygulamanın bir dosyayı oluşturduğu, ona eriştiği veya yazdığı zamanları kaydetmek için bir dosya zamanı kullanır.

yöntemi, ToFileTimeUtc geçerli DateTime nesnenin yerel saat mi, UTC saati mi yoksa UTC saati olarak ele alınan belirtilmemiş bir saat türü mü olduğunu belirlemek için özelliğini kullanırKind. Yerel bir saatse, Windows dosya zamanına dönüştürme işlemini gerçekleştirmeden önce saati UTC'ye dönüştürür.

Arayanlara Notlar

yöntemi ToFileTimeUtc() bazen yerel saati UTC'ye dönüştürmek ve ardından yöntemini ToLocalTime() çağırarak FromFileTimeUtc(Int64) geri yüklemek için kullanılır. Ancak, özgün saat yerel saat diliminde geçersiz bir saati temsil ederse, iki yerel saat değeri eşit olmaz. Ek bilgi için yöntemine ToLocalTime() bakın.

Ayrıca bkz.

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