IntlCalendar::clear()函式—用法及示例

函式名稱：IntlCalendar::clear()

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

用法：public bool IntlCalendar::clear(int $field)

函式描述：清除給定欄位的值，將其設定為未定義狀態。

引數：

• $field：要清除的欄位常量。可以是以下之一：
  • IntlCalendar::FIELD_ERA：時代欄位
  • IntlCalendar::FIELD_YEAR：年份欄位
  • IntlCalendar::FIELD_MONTH：月份欄位
  • IntlCalendar::FIELD_WEEK_OF_YEAR：年的週數字段
  • IntlCalendar::FIELD_WEEK_OF_MONTH：月的週數字段
  • IntlCalendar::FIELD_DAY_OF_MONTH：月的日期欄位
  • 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：夏令時偏移欄位

返回值：如果成功清除欄位的值，則返回 true，否則返回 false。

示例：

$cal = IntlCalendar::fromDateTime('2021-10-15 12:30:45');
echo $cal->get(IntlCalendar::FIELD_DAY_OF_MONTH) . PHP_EOL;  // 輸出：15

$cal->clear(IntlCalendar::FIELD_DAY_OF_MONTH);
echo $cal->get(IntlCalendar::FIELD_DAY_OF_MONTH) . PHP_EOL;  // 輸出：0

在上述示例中，我們首先建立了一個 IntlCalendar 物件，表示了一個特定的日期和時間。然後，我們使用 get() 方法獲取了該日期的月份欄位值，並將其輸出。接下來，我們使用 clear() 方法清除了月份欄位的值。最後，我們再次使用 get() 方法獲取月份欄位的值，並將其輸出。由於我們清除了該欄位的值，輸出結果為 0。