IntlCalendar::clear

(PHP 5 >= 5.5.0, PHP 7, PHP 8, PECL >= 3.0.0a1)

IntlCalendar::clear — Очищає поле чи всі поля

Опис

Об'єктно-орієнтований стиль

public IntlCalendar::clear(?int $field = null): true

Процедурний стиль

intlcal_clear(IntlCalendar $calendar, ?int $field = null): true

Очищає всі поля, або певне поле. Очищене поле позначається як не задане, що дає йому найнижчий пріоритет щодо перевизначальних полів або навіть за замовчуванням при обчисленні часу. Крім того, його значення встановлено на , хоча, враховуючи низький пріоритет поля, його значення могло бути внутрішньо встановлено інше значення на момент завершення запиту поля.

Список параметрів

calendar

Екземпляр IntlCalendar

field

Одна з представлених у класі IntlCalendar константполей типа дата/время. Целое число от до**IntlCalendar::FIELD_COUNT**

Значення, що повертаються

Функція завжди повертає true

список змін

Версия	Опис
8.2.0	Тип значення, що повертається тепер true; раніше було bool.

Приклади

Приклад #1 Приклад використання IntlCalendar::clear()****

Loading...
▶

Результат виконання наведеного прикладу:

После создания григорианского календаря
Array
(
    [0] => FIELD_ERA
    [1] => FIELD_YEAR
    [2] => FIELD_MONTH
    [3] => FIELD_DATE
)

15/03/2013 00:00:00
После того, как средство форматирования запросило поле EXTENDED_YEAR
Array
(
    [0] => FIELD_ERA
    [1] => FIELD_YEAR
    [2] => FIELD_MONTH
    [3] => FIELD_DATE
    [4] => FIELD_EXTENDED_YEAR
)

После того, как год будет очищен, дата останется прежней
15/03/2013 00:00:00
Потому что FIELD_EXTENDED_YEAR все ещё установлен
Array
(
    [0] => FIELD_ERA
    [1] => FIELD_MONTH
    [2] => FIELD_DATE
    [3] => FIELD_EXTENDED_YEAR
)

bool(true)
После того, как поле EXTENDED_YEAR было очищено
Array
(
    [0] => FIELD_ERA
    [1] => FIELD_MONTH
    [2] => FIELD_DATE
)
15/03/1970 00:00:00

После пересчёта полей,
 снова установлено поле EXTENDED_YEAR (до 1970 г.)
Array
(
    [0] => FIELD_ERA
    [1] => FIELD_MONTH
    [2] => FIELD_DATE
    [3] => FIELD_EXTENDED_YEAR
)

После вызова варианта без аргументов
Array
(
)
01/01/1970 00:00:00