IncAMonth - C++ Builder

C++ Builder 参考手册 ➙ System::Sysutils ➙ IncAMonth

---

计算一个日期 (年、月、日) 加上或减去几个月之后的日期。

头文件：#include
命名空间：System::Sysutils
函数原型：

void __fastcall IncAMonth(System::Word &Year, System::Word &Month, System::Word &Day, int NumberOfMonths = 1);

参数：

• Year：年，输入计算之前的年，输出计算之后的年；
• Month：月，输入计算之前的月，输出计算之后的月；
• Day：日，输入计算之前的日，输出计算之后的日；
• NumberOfMonths：正数：这些月之后，负数：这些月之前，默认值为 1；

返回值：

• Year 年 Month 月 Day 日加上或减去 NumberOfMonths 个月之后的日期，并且通过 Year、Month、Day 参数返回，参数值被修改为新的日期 (年、月、日)；
• 如果计算之后的日超出这个月的天数，返回这个月的最后一天，
  • 例如 2022年1月30日，NumberOfMonths等于1，返回 2022年2月28日；
  • 例如 2022年1月30日，NumberOfMonths等于-2，返回 2021年11月30日；
• 通过测试发现：调用函数之前参数 Year、Month、Day 给定的日期无效不会引起抛出异常，如果月份超出12月份会认为是顺延的月份，例如 2022年14月认为是2023年2月，而参数 Day 不会参与运算，只是最终运算结果如果超出这个月的天数，就返回这个月的最后一天；
• 另外一个函数 IncMonth (函数名比 IncAMonth 少个字母 A) 是针对 System::TDateTime 类型的计算，同样的功能，IncMonth 和 IncYear、IncDay 等不在同一个头文件/命名空间里面 (请参考本页底部的 "相关" 内容)。

---

相关：

• System::Sysutils::IncMonth
• System::Sysutils::IncAMonth
• System::Sysutils::ReplaceTime
• System::Sysutils::ReplaceDate
• System::Sysutils::CurrentYear
• System::Sysutils::Now
• System::Sysutils::Date
• System::Sysutils::Time
• System::Sysutils::DecodeDate
• System::Sysutils::DecodeDateFully
• System::Sysutils::DecodeTime
• System::Sysutils::EncodeDate
• System::Sysutils::EncodeTime
• System::Sysutils::TryEncodeDate
• System::Sysutils::TryEncodeTime
• System::Sysutils::TryStrToDate
• System::Sysutils::TryStrToDateTime
• System::Sysutils::TryStrToTime
• System::Sysutils
• System::Dateutils::IncYear
• System::Dateutils::IncDay
• System::Dateutils::IncWeek
• System::Dateutils::IncHour
• System::Dateutils::IncMinute
• System::Dateutils::IncSecond
• System::Dateutils::IncMilliSecond
• System::Dateutils::DayOfTheYear
• System::Dateutils::DayOfTheMonth
• System::Dateutils::DayOfTheWeek
• System::Dateutils::DayOf
• System::Dateutils::HourOf
• System::Dateutils::SecondOf
• System::Dateutils::MinuteOf
• System::Dateutils::MilliSecondOf
• System::Dateutils::DecodeDateTime
• System::Dateutils::EncodeDateTime
• System::Dateutils::TryEncodeDateTime
• System::Dateutils

---

C++ Builder 参考手册 ➙ System::Sysutils ➙ IncAMonth