AdjustCalendarDate 函数

已弃用。 按指定的年数、月数、周数或天数调整日期。

语法

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

参数

lpCalDateTime [in, out]

指向 CALDATETIME 结构的指针,该结构包含要调整的日期和日历信息。

calUnit [in]

CALDATETIME_DATEUNIT指示日期单位的枚举值,例如 DayUnit。

amount [out]

指定日期的调整量。

返回值

如果成功,则返回 TRUE ,否则返回 FALSE 。 若要获取扩展的错误信息,应用程序可以调用 GetLastError,这会返回以下错误代码之一:

  • ERROR_DATE_OUT_OF_RANGE。 指定的日期在范围外。
  • ERROR_INVALID_PARAMETER。 任何参数值都无效。

备注

此函数没有关联的头文件或库文件。 应用程序可以使用 DLL 名称 (Kernel32.dll) 调用 LoadLibrary 以获取模块句柄。 然后,它可以使用模块句柄和此函数的名称调用 GetProcAddress 以获取函数地址。

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2008 [仅限桌面应用]
DLL
Kernel32.dll

另请参阅

国家/地区语言支持

国家/地区语言支持函数

NLS:基于名称的 API 示例