IntlCalendar::add()函数—用法及示例

函数名：IntlCalendar::add() 

适用版本：PHP 5 >= 5.5.0, PHP 7, PHP 8

用法： IntlCalendar::add ( int $field , int $amount ) : bool

参数：

• $field：表示要添加的日历字段，可以是以下常量之一：
  • IntlCalendar::FIELD_ERA：时代字段
  • IntlCalendar::FIELD_YEAR：年份字段
  • IntlCalendar::FIELD_MONTH：月份字段
  • IntlCalendar::FIELD_WEEK_OF_YEAR：年的第几周字段
  • IntlCalendar::FIELD_WEEK_OF_MONTH：月的第几周字段
  • IntlCalendar::FIELD_DATE：日期字段
  • IntlCalendar::FIELD_DAY_OF_YEAR：年的第几天字段
  • IntlCalendar::FIELD_DAY_OF_WEEK：星期几字段
  • IntlCalendar::FIELD_DAY_OF_WEEK_IN_MONTH：月的第几个星期几字段
  • IntlCalendar::FIELD_AM_PM：上午/下午字段
  • IntlCalendar::FIELD_HOUR：小时字段
  • IntlCalendar::FIELD_HOUR_OF_DAY：一天的第几个小时字段
  • IntlCalendar::FIELD_MINUTE：分钟字段
  • IntlCalendar::FIELD_SECOND：秒字段
  • IntlCalendar::FIELD_MILLISECOND：毫秒字段
  • IntlCalendar::FIELD_ZONE_OFFSET：时区偏移字段
  • IntlCalendar::FIELD_DST_OFFSET：夏令时偏移字段
• $amount：表示要添加的数量，可以为正数或负数。

返回值：

• 如果成功添加了指定的数量到日历字段，则返回 true，否则返回 false。

示例：

$cal = IntlCalendar::createInstance();
$cal->set(2022, 1, 15); // 设置日期为 2022-02-15

$cal->add(IntlCalendar::FIELD_MONTH, 1); // 添加一个月
echo $cal->getTime(); // 输出：1644825600000（对应的时间戳）

$cal->add(IntlCalendar::FIELD_DAY_OF_WEEK, -2); // 减去两天的星期几
echo $cal->getTime(); // 输出：1644624000000（对应的时间戳）

在上面的示例中，我们首先创建了一个 IntlCalendar 实例，并将日期设置为 2022 年 2 月 15 日。然后，我们使用 add() 函数分别添加了一个月和减去两天的星期几。最后，通过 getTime() 函数获取更新后的日期对应的时间戳。