C++ Builder 參考手冊 ? System::Sysutils ? IncAMonth
計算一個日期 (年胞皱、月、日) 加上或減去幾個月之后的日期看政。
頭文件:#include <System.SysUtils.hpp>
命名空間:System::Sysutils
函數(shù)原型:
void __fastcall IncAMonth(System::Word &Year, System::Word &Month, System::Word &Day, int NumberOfMonths = 1);
參數(shù):
- Year:年朴恳,輸入計算之前的年,輸出計算之后的年允蚣;
- Month:月于颖,輸入計算之前的月,輸出計算之后的月嚷兔;
- Day:日森渐,輸入計算之前的日,輸出計算之后的日冒晰;
- NumberOfMonths:正數(shù):這些月之后同衣,負數(shù):這些月之前,默認值為 1壶运;
返回值:
- Year 年 Month 月 Day 日加上或減去 NumberOfMonths 個月之后的日期耐齐,并且通過 Year、Month蒋情、Day 參數(shù)返回埠况,參數(shù)值被修改為新的日期 (年、月棵癣、日)辕翰;
- 如果計算之后的日超出這個月的天數(shù),返回這個月的最后一天狈谊,
? 例如 2022年1月30日喜命,NumberOfMonths等于1沟沙,返回 2022年2月28日;
? 例如 2022年1月30日壁榕,NumberOfMonths等于-2矛紫,返回 2021年11月30日; - 通過測試發(fā)現(xiàn):調(diào)用函數(shù)之前參數(shù) Year护桦、Month含衔、Day 給定的日期無效不會引起拋出異常,如果月份超出12月份會認為是順延的月份二庵,例如 2022年14月認為是2023年2月贪染,而參數(shù) Day 不會參與運算,只是最終運算結(jié)果如果超出這個月的天數(shù)催享,就返回這個月的最后一天杭隙;
- 另外一個函數(shù) IncMonth (函數(shù)名比 IncAMonth 少個字母 A) 是針對 System::TDateTime 類型的計算,同樣的功能因妙,IncMonth 和 IncYear痰憎、IncDay 等不在同一個頭文件/命名空間里面 (請參考本頁底部的 "相關(guān)" 內(nèi)容)。
相關(guān):
- 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