DateTime.ToFileTimeUtc 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 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.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.

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 ToFileTimeUtc 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 UTC.The ToFileTimeUtc 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 UTC time. S’il s’agit d’une heure locale, il convertit l’heure en heure UTC avant d’effectuer la conversion en heure de fichier Windows.If it is a local time, it converts the time to UTC before performing the conversion to a Windows file time.

Notes pour les appelants

La méthode ToFileTimeUtc() est parfois utilisée pour convertir une heure locale en heure UTC et, par la suite, pour la restaurer en appelant la méthode FromFileTimeUtc(Int64) suivie de la méthode ToLocalTime().The ToFileTimeUtc() method is sometimes used to convert a local time to UTC, and subsequently to restore it by calling the FromFileTimeUtc(Int64) method followed by the ToLocalTime() method. Toutefois, si l’heure d’origine représente une heure non valide dans le fuseau horaire local, les deux valeurs d’heure locales ne sont pas égales.However, if the original time represents an invalid time in the local time zone, the two local time values will not be equal. Pour plus d’informations, consultez la méthode ToLocalTime().For additional information, see the ToLocalTime() method.

S’applique à

Voir aussi