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