DateTime.ToFileTimeUtc Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Convertit la valeur de l'objet DateTime actuel en heure de fichier Windows.
public:
long ToFileTimeUtc();
public long ToFileTimeUtc ();
member this.ToFileTimeUtc : unit -> int64
Public Function ToFileTimeUtc () As Long
Retours
Valeur de l'objet DateTime actuel exprimée sous forme d'heure de fichier Windows.
Exceptions
L’heure de fichier résultante représente une date et une heure avant 12h00 minuit le 1er janvier 1601 C.E. UTC.
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 1601 A.D. (C.E.) Temps universel coordonné (UTC). Windows utilise une heure de fichier pour enregistrer le moment où une application crée, accède ou écrit dans un fichier.
La ToFileTimeUtc méthode utilise la Kind propriété pour déterminer si l’objet actuel DateTime est une heure locale, une heure UTC ou un type d’heure non spécifié qui est traité comme une heure UTC. S’il s’agit d’une heure locale, il convertit l’heure utc avant d’effectuer la conversion en heure de fichier Windows.
Notes pour les appelants
La ToFileTimeUtc() méthode est parfois utilisée pour convertir une heure locale en UTC, puis pour la restaurer en appelant la FromFileTimeUtc(Int64) méthode suivie de la ToLocalTime() méthode. Toutefois, si l’heure d’origine représente une heure non valide dans le fuseau horaire local, les deux valeurs d’heure locale ne sont pas égales. Pour plus d’informations, consultez la ToLocalTime() méthode .