DateTime.ToFileTime Méthode

Définition

Convertit la valeur de l'objet DateTime actuel en heure de fichier 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

Retours

Valeur de l'objet DateTime actuel exprimée sous forme d'heure de fichier Windows.The value of the current DateTime object expressed as a Windows file time.

Exceptions

L’heure du fichier résultante représente une date et une heure avant 00:00 (minuit) le 1er janvier 1601 (notre ère)The resulting file time would represent a date and time before 12:00 midnight January 1, 1601 C.E. UTC.UTC.

Exemples

L’exemple suivant illustre la méthode 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

Remarques

Une heure de fichier Windows est une valeur 64 bits qui représente le nombre d’intervalles de 100 nanosecondes qui se sont écoulés depuis 12:00 minuit le 1er janvier de 1601 après J.-C.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. COMMUNE Temps universel coordonné (UTC).(C.E.) Coordinated Universal Time (UTC). Windows utilise une heure de fichier pour enregistrer quand une application crée, accède ou écrit dans un fichier.Windows uses a file time to record when an application creates, accesses, or writes to a file.

La méthode ToFileTime utilise la propriété Kind pour déterminer si l’objet DateTime actuel est une heure locale, une heure UTC ou un type de temps non spécifié qui est traité comme une heure locale.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.

Notes pour les appelants

En règle générale, la méthode FromFileTime(Int64) restaure une valeur DateTime qui a été enregistrée par la méthode ToFileTime().Ordinarily, the FromFileTime(Int64) method restores a DateTime value that was saved by the ToFileTime() method. Toutefois, les deux valeurs peuvent différer dans les conditions suivantes :However, the two values may differ under the following conditions: -Si la sérialisation et la désérialisation de la valeur DateTime se produisent dans des fuseaux horaires différents.- If the serialization and deserialization of the DateTime value occur in different time zones. Par exemple, si une valeur DateTime avec une heure de 12:30 P.M.For example, if a DateTime value with a time of 12:30 P.M. aux États-Unis Le fuseau horaire est sérialisé, puis désérialisé aux États-Unis Pacific fuseau horaire, la valeur d’origine de 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. est ajusté à 9:30 du matinis adjusted to 9:30 A.M. pour refléter la différence entre les deux fuseaux horaires.to reflect the difference between the two time zones.

-Si la valeur DateTime qui est sérialisée représente une heure non valide dans le fuseau horaire local.- If the DateTime value that is serialized represents an invalid time in the local time zone. Dans ce cas, la méthode ToFileTime() ajuste la valeur DateTime restaurée afin qu’elle représente une heure valide dans le fuseau horaire local.In this case, the ToFileTime() method adjusts the restored DateTime value so that it represents a valid time in the local time zone.

Par exemple, le passage de l’heure d’hiver à l’heure d’été se produit aux États-Unis Heure du Pacifique le 14 mars à 2010, à 2:00 h 00, lorsque l’heure avance d’une heure, à 3:00 du matin.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. Cette heure est une heure non valide, autrement dit, un intervalle de temps qui n’existe pas dans ce fuseau horaire.This hour interval is an invalid time, that is, a time interval that does not exist in this time zone. L’exemple suivant montre que lorsqu’une heure qui se trouve dans cette plage est convertie en valeur entière longue par la méthode ToFileTime() et qu’elle est ensuite restaurée par la méthode FromFileTime(Int64), la valeur d’origine est ajustée pour devenir une heure valide.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. Vous pouvez déterminer si une valeur de date et d’heure particulière peut être sujette à modification en la passant à la méthode IsInvalidTime(DateTime), comme l’illustre l’exemple.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]

S’applique à

Voir aussi