Udostępnij za pośrednictwem


DateTime.ToFileTimeUtc Metoda

Definicja

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

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

Zobacz też