Função EnumDateFormatsA (winnls.h)

Artigo
11/20/2024

Enumera os formatos de data longa, data curta ou ano/mês disponíveis para uma localidade especificada.

Observação Para receber um identificador de calendário além das informações de formato de data, o aplicativo deve usar a função EnumDateFormatsEx . Outro motivo para preferir essa função é que a Microsoft está migrando para o uso de nomes de localidade em vez de identificadores de localidade para novas localidades, por motivos de interoperabilidade.

Observação Qualquer aplicativo que será executado somente no Windows Vista ou posterior deve usar EnumDateFormatsExEx em preferência para EnumDateFormats.

Sintaxe

BOOL EnumDateFormatsA(
  [in] DATEFMT_ENUMPROCA lpDateFmtEnumProc,
  [in] LCID              Locale,
  [in] DWORD             dwFlags
);

Parâmetros

[in] lpDateFmtEnumProc

Ponteiro para uma função de retorno de chamada definida pelo aplicativo. Para obter mais informações, consulte EnumDateFormatsProc.

[in] Locale

identificador de localidade que especifica a localidade para a qual recuperar informações de formato de data. Você pode usar a macro MAKELCID para criar um identificador ou usar um dos seguintes valores predefinidos.

[in] dwFlags

Sinalizador especificando formatos de data. Para obter definições detalhadas, consulte o parâmetro dwFlags de EnumDateFormatsExEx.

Valor de retorno

Retorna um valor diferente de zero se tiver êxito ou 0 de outra forma. Para obter informações de erro estendidas, o aplicativo pode chamar GetLastError, que pode retornar um dos seguintes códigos de erro:

ERROR_INVALID_FLAGS. Os valores fornecidos para sinalizadores não eram válidos.
ERROR_INVALID_PARAMETER. Qualquer um dos valores de parâmetro era inválido.

Observações

Observação esta API está sendo atualizada para dar suporte à alteração da era japonesa de maio de 2019. Se o aplicativo der suporte ao calendário japonês, você deverá validar que ele lida corretamente com a nova era. Consulte Preparar seu aplicativo para a de alteração da era japonesa para obter mais informações.

Para obter detalhes sobre a operação dessa função, consulte Comentários em EnumDateFormatsEx.

Observação Para enumerar os formatos de data para localidades com calendários alternativos, o aplicativo deve usar EnumDateFormatsEx.

Nota

O cabeçalho winnls.h define EnumDateFormats como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winnls.h (inclua Windows.h)
biblioteca	Kernel32.lib
de DLL	Kernel32.dll

Consulte também

EnumDateFormatsEx

EnumDateFormatsExEx

EnumDateFormatsProc

de Suporte à Linguagem Nacional

funções de suporte à linguagem nacional

Compartilhar via