IncAMonth - C++ Builder

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 等不在同一个头文件/命名空间里面 (请参考本页底部的 "相关" 内容)。

相关：

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

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
平台声明：文章内容（如有图片或视频亦包括在内）由作者上传并发布，文章内容仅代表作者本人观点，简书系信息发布平台，仅提供信息存储服务。

推荐阅读更多精彩内容