DateTime.ToFileTimeUtc Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Konverterar värdet för det aktuella DateTime-objektet till en Windows filtid.
public:
long ToFileTimeUtc();public long ToFileTimeUtc();member this.ToFileTimeUtc : unit -> int64Public Function ToFileTimeUtc () As LongReturer
Värdet för det aktuella DateTime-objektet uttryckt som en Windows filtid.
Undantag
Den resulterande filtiden representerar ett datum och en tid före 12:00 midnatt den 1 januari 1601 C.E. UTC.
Kommentarer
En Windows filtid är ett 64-bitars värde som representerar antalet intervall på 100 nanosekunder som har förflutit sedan 12:00 midnatt, 1 januari 1601 e.D. (C.E.) UtC (Coordinated Universal Time). Windows använder en filtid för att registrera när ett program skapar, öppnar eller skriver till en fil.
Metoden ToFileTimeUtc använder Kind egenskapen för att avgöra om det aktuella DateTime objektet är en lokal tid, en UTC-tid eller en ospecificerad typ av tid, som behandlas som en UTC-tid. Om det är en lokal tid konverteras tiden till UTC innan konverteringen utförs till en Windows filtid.
Anteckningar till anropare
Metoden ToFileTimeUtc() används ibland för att konvertera en lokal tid till UTC och sedan återställa den FromFileTimeUtc(Int64) genom att anropa metoden följt av ToLocalTime() metoden. Men om den ursprungliga tiden representerar en ogiltig tid i den lokala tidszonen är de två lokala tidsvärdena inte lika med. Mer information finns i ToLocalTime() metoden.
