DateTime.ToFileTimeUtc Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestaw:: System.Runtime.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Konwertuje wartość bieżącego DateTime obiektu na czas pliku systemu Windows.

public:
 long ToFileTimeUtc();

public long ToFileTimeUtc ();

member this.ToFileTimeUtc : unit -> int64

Public Function ToFileTimeUtc () As Long

Zwraca

Int64

Wartość bieżącego DateTime obiektu wyrażona jako czas pliku systemu Windows.

Wyjątki

ArgumentOutOfRangeException

Wynikowa godzina pliku będzie reprezentować datę i godzinę przed 12:00 północą 1 stycznia 1601 C.E. czasu UTC.

Uwagi

Czas pliku systemu Windows ma wartość 64-bitową. Reprezentuje ona liczbę 100-nanosekundowych przedziałów czasu, które upłynęły od północy 1 stycznia 1601 roku n.e. (C.E.) Uniwersalny czas koordynowany (UTC). System Windows wykorzystuje czas pliku do rejestrowania informacji o tym, kiedy aplikacja tworzy, uzyskuje dostęp do zapisuje do pliku.

Metoda ToFileTimeUtc używa Kind właściwości , aby określić, czy bieżący DateTime obiekt jest czasem lokalnym, czasem UTC, czy nieokreślonym rodzajem czasu, który jest traktowany jako czas UTC. Jeśli jest to czas lokalny, konwertuje czas na UTC przed wykonaniem konwersji na czas pliku systemu Windows.

Uwagi dotyczące wywoływania

Metoda ToFileTimeUtc() jest czasami używana do konwertowania czasu lokalnego na czas UTC, a następnie do przywrócenia go przez wywołanie FromFileTimeUtc(Int64) metody, po której następuje ToLocalTime() metoda . Jeśli jednak oryginalny czas reprezentuje nieprawidłowy czas w lokalnej strefie czasowej, dwie wartości czasu lokalnego nie będą równe. Aby uzyskać dodatkowe informacje, zobacz metodę ToLocalTime() .

Dotyczy