C++ Builder 参考手册 ➙ System::Sysutils ➙ IncAMonth
计算一个日期 (年、月、日) 加上或减去几个月之后的日期。
头文件：#include <System.SysUtils.hpp>
命名空间：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
