Fonction FileTimeToDosDateTime (winbase.h)

  • Article

Convertit une heure de fichier en valeurs de date et d’heure MS-DOS.

Syntaxe

BOOL FileTimeToDosDateTime(
  [in]  const FILETIME *lpFileTime,
  [out] LPWORD         lpFatDate,
  [out] LPWORD         lpFatTime
);

Paramètres

[in] lpFileTime

Pointeur vers une structure FILETIME contenant l’heure de conversion du fichier au format de date et d’heure MS-DOS.

[out] lpFatDate

Pointeur vers une variable pour recevoir la date MS-DOS. La date est une valeur empaquetée au format suivant.

Bits Description
0–4 Jour du mois (1-31)
5–8 Mois (1 = janvier, 2 = février, etc.)
9-15 Décalage de l’année à partir de 1980 (ajouter 1980 pour obtenir l’année réelle)

[out] lpFatTime

Pointeur vers une variable pour recevoir l’heure MS-DOS. L’heure est une valeur empaquetée au format suivant.

Bits Description
0–4 Deuxième divisé par 2
5–10 Minute (0-59)
11–15 Heure (0-23 sur une horloge de 24 heures)

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Le format de date MS-DOS ne peut représenter que des dates comprises entre le 1/1/1980 et le 31/12/2107 ; cette conversion échoue si l’heure du fichier d’entrée est en dehors de cette plage.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winbase.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

DosDateTimeToFileTime

FileTimeToSystemTime

SystemTimeToFileTime

Fonctions de temps