DateTime.ToFileTimeUtc Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

DateTime.cs

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

Int64

Valeur de l'objet DateTime actuel exprimée sous forme d'heure de fichier Windows.

Exceptions

ArgumentOutOfRangeException

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 .

Voir aussi

• ToFileTime()
• Int64
• ToUniversalTime()
• GetUtcOffset(DateTime)