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。