DateTime.ToFileTime Methode

Definition

Konvertiert den Wert des aktuellen DateTime-Objekts in eine Windows-Dateizeit.Converts the value of the current DateTime object to a Windows file time.

public:
 long ToFileTime();
public long ToFileTime ();
member this.ToFileTime : unit -> int64
Public Function ToFileTime () As Long

Gibt zurück

Der Wert des aktuellen DateTime-Objekts als Windows-Dateizeit.The value of the current DateTime object expressed as a Windows file time.

Ausnahmen

Die resultierende Dateizeitangabe würde ein Datum und eine Uhrzeit vor 24:00 Uhr am 1. Januar 1601 UTC unserer Zeitrechnung darstellenThe resulting file time would represent a date and time before 12:00 midnight January 1, 1601 C.E. .UTC.

Beispiele

Das folgende Beispiel veranschaulicht die ToFileTime Methode.The following example demonstrates the ToFileTime method.

int main()
{
   System::Console::WriteLine( "Enter the file path:" );
   String^ filePath = System::Console::ReadLine();
   if ( System::IO::File::Exists( filePath ) )
   {
      System::DateTime fileCreationDateTime = System::IO::File::GetCreationTime( filePath );
      __int64 fileCreationFileTime = fileCreationDateTime.ToFileTime();
      System::Console::WriteLine( "{0} in file time is {1}.", fileCreationDateTime, fileCreationFileTime );
   }
   else
   {
      System::Console::WriteLine( "{0} is an invalid file", filePath );
   }
}

static void Main(string[] args)
{
    System.Console.WriteLine("Enter the file path:");
    string filePath = System.Console.ReadLine();

    if (System.IO.File.Exists(filePath)) {
        System.DateTime fileCreationDateTime = 
            System.IO.File.GetCreationTime(filePath);

        long fileCreationFileTime = fileCreationDateTime.ToFileTime();

        System.Console.WriteLine("{0} in file time is {1}.",
                                 fileCreationDateTime,
                                 fileCreationFileTime);
    } 
    else {
        System.Console.WriteLine("{0} is an invalid file", filePath);
    }
}
Public Shared Sub Main()

   System.Console.WriteLine("Enter the file path:")
   Dim filePath As String
   filePath = System.Console.ReadLine()

   If System.IO.File.Exists(filePath) Then
      Dim fileCreationDateTime As System.DateTime
      fileCreationDateTime = System.IO.File.GetCreationTime(filePath)

      Dim fileCreationFileTime As Long
      fileCreationFileTime = fileCreationDateTime.ToFileTime()

      System.Console.WriteLine("{0} in file time is {1}.", _
                               fileCreationDateTime, _
                               fileCreationFileTime)
   Else
      System.Console.WriteLine("{0} is an invalid file", filePath)
   End If
End Sub

Hinweise

Eine Windows-Dateizeit ist ein 64-Bit-Wert, der die Anzahl der 100-Nanosekunden-Intervalle darstellt, die seit 12:00 Mitternacht, 1. Januar 1601 n/s verstrichen sind.A Windows file time is a 64-bit value that represents the number of 100-nanosecond intervals that have elapsed since 12:00 midnight, January 1, 1601 A.D. (C.E.) Koordinierte Weltzeit (UTC).(C.E.) Coordinated Universal Time (UTC). Windows verwendet eine Dateizeit, um aufzuzeichnen, wann eine Anwendung eine Datei erstellt, zugreift oder in eine Datei schreibt.Windows uses a file time to record when an application creates, accesses, or writes to a file.

Die ToFileTime-Methode verwendet die Kind-Eigenschaft, um zu bestimmen, ob es sich bei dem aktuellen DateTime-Objekt um eine Ortszeit, eine UTC-Zeit oder eine nicht angegebene Zeitangabe handelt, die als Ortszeit behandelt wird.The ToFileTime method uses the Kind property to determine whether the current DateTime object is a local time, a UTC time, or an unspecified kind of time which is treated as a local time.

Hinweise für Aufrufer

Normalerweise stellt die FromFileTime(Int64)-Methode einen DateTime-Wert wieder her, der von der ToFileTime()-Methode gespeichert wurde.Ordinarily, the FromFileTime(Int64) method restores a DateTime value that was saved by the ToFileTime() method. Die beiden Werte können sich jedoch unter den folgenden Bedingungen unterscheiden:However, the two values may differ under the following conditions: : Wenn die Serialisierung und Deserialisierung des DateTime-Werts in verschiedenen Zeitzonen auftritt.- If the serialization and deserialization of the DateTime value occur in different time zones. Beispiel: Wenn ein DateTime-Wert mit einer Uhrzeit von 12:30 UhrFor example, if a DateTime value with a time of 12:30 P.M. in den USA Die Zeitzone "Eastern Time" wird serialisiert und anschließend in den USA (USA) deserialisiert. Pacific Time Zone, der ursprüngliche Wert von 12:30 Uhrin the U.S. Eastern Time zone is serialized, and then deserialized in the U.S. Pacific Time zone, the original value of 12:30 P.M. wird an 9:30 Uhr angepasst.is adjusted to 9:30 A.M. , um den Unterschied zwischen den beiden Zeitzonen widerzuspiegeln.to reflect the difference between the two time zones.

-Wenn der DateTime-Wert, der serialisiert wird, eine ungültige Zeit in der lokalen Zeitzone darstellt.- If the DateTime value that is serialized represents an invalid time in the local time zone. In diesem Fall passt die ToFileTime()-Methode den wiederhergestellten DateTime-Wert so an, dass er eine gültige Zeit in der lokalen Zeitzone darstellt.In this case, the ToFileTime() method adjusts the restored DateTime value so that it represents a valid time in the local time zone.

Die Umstellung von Standardzeit auf Sommerzeit erfolgt beispielsweise in den USA Pacific Time Zone am 14. März 2010 um 2:00 Uhr, wenn die Zeit um eine Stunde um um 3:00 Uhr liegtFor example, the transition from standard time to daylight saving time occurs in the U.S. Pacific Time zone on March 14, 2010, at 2:00 A.M., when the time advances by one hour, to 3:00 A.M. Dieses Stunden Intervall ist eine ungültige Zeit, d. h. ein Zeitintervall, das in dieser Zeitzone nicht vorhanden ist.This hour interval is an invalid time, that is, a time interval that does not exist in this time zone. Das folgende Beispiel zeigt, dass eine Zeitspanne, die in diesen Bereich fällt, von der ToFileTime()-Methode in einen Long-ganzzahligen Wert konvertiert und dann mit der FromFileTime(Int64)-Methode wieder hergestellt wird. der ursprüngliche Wert wird so angepasst, dass er zu einer gültigen Zeit wird.The following example shows that when a time that falls within this range is converted to a long integer value by the ToFileTime() method and is then restored by the FromFileTime(Int64) method, the original value is adjusted to become a valid time. Sie können feststellen, ob ein bestimmter Datums-und Uhrzeitwert geändert werden kann, indem Sie ihn an die IsInvalidTime(DateTime)-Methode übergeben, wie im Beispiel veranschaulicht.You can determine whether a particular date and time value may be subject to modification by passing it to the IsInvalidTime(DateTime) method, as the example illustrates.

[! Code-csharpSystem. DateTime. FromFileTime # 1] [! Code-vbSystem. DateTime. FromFileTime # 1][!code-csharpSystem.DateTime.FromFileTime#1] [!code-vbSystem.DateTime.FromFileTime#1]

Gilt für:

Siehe auch