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() 函式獲取更新後的日期對應的時間戳。