Función FileTimeToDosDateTime (winbase.h)

  • Artículo

Convierte una hora de archivo en valores de fecha y hora de MS-DOS.

Sintaxis

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

Parámetros

[in] lpFileTime

Puntero a una estructura FILETIME que contiene la hora del archivo que se va a convertir en formato de fecha y hora de MS-DOS.

[out] lpFatDate

Puntero a una variable para recibir la fecha de MS-DOS. La fecha es un valor empaquetado con el formato siguiente.

Bits Descripción
0–4 Día del mes (1–31)
5–8 Mes (1 = enero, 2 = febrero, etc.)
9-15 Desplazamiento del año de 1980 (agregue 1980 para obtener el año real)

[out] lpFatTime

Puntero a una variable para recibir la hora de MS-DOS. La hora es un valor empaquetado con el formato siguiente.

Bits Descripción
0–4 Segundo dividido por 2
5–10 Minuto (0–59)
11–15 Hora (de 0 a 23 en un reloj de 24 horas)

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

El formato de fecha MS-DOS solo puede representar fechas entre el 1/1/1980 y el 31/12/2107; Se produce un error en esta conversión si el tiempo del archivo de entrada está fuera de este intervalo.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

DosDateTimeToFileTime

FileTimeToSystemTime

SystemTimeToFileTime

Funciones de hora