Share via

Função FileTimeToDosDateTime (winbase.h)

  • Artigo

Converte uma hora de arquivo em valores de data e hora do MS-DOS.

Sintaxe

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

Parâmetros

[in] lpFileTime

Um ponteiro para uma estrutura FILETIME que contém a hora do arquivo a ser convertida em formato de data e hora do MS-DOS.

[out] lpFatDate

Um ponteiro para uma variável para receber a data do MS-DOS. A data é um valor empacotado com o formato a seguir.

Bits Descrição
0-4 Dia do mês (1 a 31)
5–8 Mês (1 = janeiro, 2 = fevereiro etc.)
9-15 Deslocamento anual a partir de 1980 (adicione 1980 para obter o ano real)

[out] lpFatTime

Um ponteiro para uma variável para receber a hora do MS-DOS. A hora é um valor empacotado com o formato a seguir.

Bits Descrição
0-4 Segundo dividido por 2
5–10 Minuto (0 a 59)
11–15 Hora (0 a 23 em um relógio de 24 horas)

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

O formato de data MS-DOS pode representar apenas datas entre 1/1/1980 e 31/12/2107; essa conversão falhará se a hora do arquivo de entrada estiver fora desse intervalo.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbase.h (incluir Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

DosDateTimeToFileTime

FileTimeToSystemTime

SystemTimeToFileTime

Funções de tempo