IncMonth - C++ Builder

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

---

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

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

System::TDateTime __fastcall IncMonth(const System::TDateTime DateTime, int NumberOfMonths = 1);

参数：

• DateTime：日期时间类型数值；
• NumberOfMonths：正数：这些月之后，负数：这些月之前，默认值为 1；

返回值：

• Year 年 Month 月 Day 日加上或减去 NumberOfMonths 个月之后的日期，并且通过 Year、Month、Day 参数返回，参数值被修改为新的日期 (年、月、日)，时间部分保持参数 DateTime 原来的时间部分；
• 如果计算之后的日超出这个月的天数，返回这个月的最后一天，时间部分仍然是保持参数 DateTime 原来的时间部分；
  • 例如 2022年1月30日，NumberOfMonths等于1，返回 2022年2月28日；
  • 例如 2022年1月30日，NumberOfMonths等于-2，返回 2021年11月30日；
• 函数 IncMonth 是通过调用 IncAMonth 实现的，所以 IncMonth 和 IncAMonth 功能相同，只是参数类型不同；
• 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 ➙ IncMonth