Compartilhar via


Função AdjustCalendarDate

Preterido. Ajusta uma data por um número especificado de anos, meses, semanas ou dias.

Sintaxe

BOOL AdjustCalendarDate(
  _Inout_ LPCALDATETIME        lpCalDateTime,
  _In_    CALDATETIME_DATEUNIT calUnit,
  _Out_   INT                  amount
);

Parâmetros

lpCalDateTime [in, out]

Ponteiro para uma estrutura CALDATETIME que contém as informações de data e calendário a serem ajustadas.

calUnit [in]

O CALDATETIME_DATEUNIT valor de enumeração que indica a unidade de data, por exemplo, DayUnit.

amount [out]

O valor pelo qual ajustar a data especificada.

Valor retornado

Retornará TRUE se tiver êxito ou FALSE caso contrário. Para obter informações de erro estendidas, o aplicativo pode chamar GetLastError, que pode retornar um dos seguintes códigos de erro:

  • ERROR_DATE_OUT_OF_RANGE. A data especificada estava fora do intervalo.
  • ERROR_INVALID_PARAMETER. Qualquer um dos valores de parâmetro era inválido.

Comentários

Essa função não tem um arquivo de cabeçalho ou arquivo de biblioteca associado. O aplicativo pode chamar LoadLibrary com o nome DLL (Kernel32.dll) para obter um identificador de módulo. Em seguida, ele pode chamar GetProcAddress com o identificador do módulo e o nome dessa função para obter o endereço da função.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 [somente aplicativos da área de trabalho]
DLL
Kernel32.dll

Confira também

Suporte a idiomas nacionais

Funções de suporte à linguagem nacional

NLS: exemplo de APIs baseadas em nome