PHP | IntlCalendar add()函数

IntlCalendar add ( int $field , int $amount ) 是一个PHP Intl扩展函数，用于修改已有的日历时间。它将指定的时间字段增加指定的数量，以产生一个新的日历时间。它返回一个bool值，表示修改是否成功。

参数

该函数接受两个参数：

• $field：时间字段。有以下常量可用：
  • IntlCalendar::FIELD_ERA：年代（e.g. AD or BC）
  • 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。

代码示例

此示例使用"FIELD_YEAR"字段和"5"的数量将现有日历时间增加5年：

$cal = IntlCalendar::createInstance();
$cal->set(2020, 7, 1);
echo $cal->getTime() . "<br>"; //输出：Jul 01, 2020, 00:00:00 AM
$cal->add(IntlCalendar::FIELD_YEAR, 5);
echo $cal->getTime() . "<br>"; // 输出：Jul 01, 2025, 00:00:00 AM

在上面的示例中，我们首先创建了一个名为$cal的IntlCalendar实例，并将其设置为2020年7月1日。我们将它打印出来，以检查其准确性。

接下来，我们使用"add()"函数将该实例的"FIELD_YEAR"字段增加了5年，然后再次将其打印出来以证明该函数确实修改了时间。

总结

IntlCalendar add()函数是一个十分实用的函数，方便程序员修改已有的日历时间。在使用前，需要首先了解时间字段的常量，以及如何在代码中创建IntlCalendar对象。