Freigeben über


DateTime.ToFileTimeUtc-Methode

Konvertiert den Wert des aktuellen DateTime-Objekts in eine Windows-Dateizeit.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Function ToFileTimeUtc As Long
'Usage
Dim instance As DateTime
Dim returnValue As Long

returnValue = instance.ToFileTimeUtc
public long ToFileTimeUtc ()
public:
long long ToFileTimeUtc ()
public long ToFileTimeUtc ()
public function ToFileTimeUtc () : long

Rückgabewert

Der Wert des aktuellen DateTime-Objekts als Windows-Dateizeit.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentOutOfRangeException

Die resultierende Dateizeit stellt ein Datum und eine Zeit vor dem 1. Januar 1601 u. Z. 00:00 Uhr UTC dar.

Hinweise

Eine Windows-Dateizeit ist ein 64-Bit-Wert, der die Anzahl von 100-Nanosekunden-Intervallen darstellt, die seit 1. Januar 1601, 00:00 u. Z. koordinierter Weltzeit (Coordinated Universal Time, UTC) verstrichen sind. Windows verwendet eine Dateizeit, um aufzuzeichnen, wann eine Anwendung eine Datei erstellt, auf eine Datei zugreift oder in eine Datei schreibt.

Frühere Versionen der ToFileTimeUtc-Methode gehen davon aus, dass das aktuelle DateTime-Objekt eine UTC-Zeit angibt. Seit .NET Framework, Version 2.0, verwendet die ToFileTimeUtc-Methode die Kind-Eigenschaft, um zu bestimmen, ob das aktuelle DateTime-Objekt eine lokale Zeit, eine UTC-Zeit oder eine nicht angegebene Art von Zeit ist, die als UTC-Zeit behandelt wird.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DateTime-Struktur
DateTime-Member
System-Namespace
ToFileTime
Int64
ToUniversalTime
GetUtcOffset