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 actuel DateTime en heure de fichier Windows.
public:
long ToFileTimeUtc();public long ToFileTimeUtc();member this.ToFileTimeUtc : unit -> int64Public Function ToFileTimeUtc () As LongRetours
Valeur de l’objet actuel DateTime exprimé sous la forme d’une heure de fichier Windows.
Exceptions
L’heure du fichier résultant représente une date et une heure antérieures à 12:00 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 lorsqu’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 en 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 heure 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.
