DateTime.ToFileTime Metoda

Definicja

Konwertuje wartość bieżącego obiektu DateTime na czas pliku systemu Windows.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

Zwraca

Wartość bieżącego obiektu DateTime wyrażona jako czas pliku systemu Windows.The value of the current DateTime object expressed as a Windows file time.

Wyjątki

Uzyskany czas pliku będzie reprezentować datę i godzinę przed 12:00 1 stycznia 1601 0001The resulting file time would represent a date and time before 12:00 midnight January 1, 1601 C.E. czasu UTC.UTC.

Przykłady

Poniższy przykład demonstruje metodę ToFileTime.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

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.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. 0001 Uniwersalny czas koordynowany (UTC).(C.E.) Coordinated Universal Time (UTC). System Windows wykorzystuje czas pliku do rejestrowania informacji o tym, kiedy aplikacja tworzy, uzyskuje dostęp do zapisuje do pliku.Windows uses a file time to record when an application creates, accesses, or writes to a file.

Metoda ToFileTime używa właściwości Kind, aby określić, czy bieżący obiekt DateTime jest czasem lokalnym, czasem UTC lub nieokreślonym rodzajem czasu, który jest traktowany jako czas lokalny.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.

Uwagi dotyczące wywoływania

Zwykle Metoda FromFileTime(Int64) przywraca wartość DateTime, która została zapisana przez metodę ToFileTime().Ordinarily, the FromFileTime(Int64) method restores a DateTime value that was saved by the ToFileTime() method. Jednak te dwie wartości mogą się różnić w następujących warunkach:However, the two values may differ under the following conditions: — Jeśli Serializacja i deserializacja wartości DateTime występuje w różnych strefach czasowych.- If the serialization and deserialization of the DateTime value occur in different time zones. Na przykład jeśli DateTime wartość o godzinie 12:30For example, if a DateTime value with a time of 12:30 P.M. w środkowym obszarze czasu USA jest serializowany, a następnie deserializowany w strefie czasowej pacyficznego w Stanach Zjednoczonych — oryginalna wartość 12:30 P.M.in 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. jest dostosowywany do 9:30 ranois adjusted to 9:30 A.M. Aby odzwierciedlić różnicę między dwiema strefami czasowymi.to reflect the difference between the two time zones.

— Jeśli wartość DateTime, która jest serializowana, reprezentuje nieprawidłowy czas w lokalnej strefie czasowej.- If the DateTime value that is serialized represents an invalid time in the local time zone. W takim przypadku Metoda ToFileTime() dostosowuje przywróconą wartość DateTime, aby reprezentować prawidłową godzinę w lokalnej strefie czasowej.In this case, the ToFileTime() method adjusts the restored DateTime value so that it represents a valid time in the local time zone.

Na przykład strefie czasu pacyficznego w Stanach Zjednoczonych przejście od czasu standardowego do czasu letniego nastąpi 14 marca 2010 r. o godzinie 2:00, kiedy czas jest przesuwany o jedną godzinę — na 3:00.For 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. Ten interwał godzinowy jest nieprawidłowy, czyli jest to przedział czasu, który nie istnieje w danej strefie czasowej.This hour interval is an invalid time, that is, a time interval that does not exist in this time zone. Poniższy przykład pokazuje, że gdy czas należący do tego zakresu jest konwertowany na wartość Long Integer przez metodę ToFileTime() i zostanie przywrócona przez metodę FromFileTime(Int64), oryginalna wartość zostanie zmieniona, aby stała się prawidłowym czasem.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. Można określić, czy określona wartość daty i godziny może podlegać modyfikacji, przekazując ją do metody IsInvalidTime(DateTime), jak pokazano w przykładzie.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]

Dotyczy

Zobacz też