IntlCalendar::getActualMaximum

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

IntlCalendar::getActualMaximum — Максимальное значение для поля с учётом текущего времени объекта

Описание

Объектно-ориентированный стиль

public function IntlCalendar::getActualMaximum(int $field): int|false

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

function intlcal_get_actual_maximum(IntlCalendar $calendar, int $field): int|false

Возвращает относительное максимальное значение поля для текущего времени. Точная семантика зависит от поля, но в общем случае это значение, которое было бы получено, если установить значение поля на наименьший относительный максимум и увеличивать его до тех пор, пока не будет достигнут глобальный максимум, чтобы обернуть значение поля, в котором возвращаемое значение будет глобальным максимумом или значением до переноса, соответственно.

Например, в григорианском календаре фактическое максимальное значение для дня месяца будет варьироваться от 28 до 31, в зависимости от месяца и года текущего времени.

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

calendar: Экземпляр класса IntlCalendar.
field: Одна из представленных в классе IntlCalendar констант полей типа дата/время. Целое число от 0 до IntlCalendar::FIELD_COUNT.

Возвращаемые значения

Целое число (int), представляющее максимальное значение в единицах измерения, связанное с данным field или false, если возникла ошибка.

Примеры

Пример #1 Пример использования IntlCalendar::getActualMaximum()

<?php
ini_set('date.timezone', 'Europe/Lisbon');

$cal = IntlCalendar::fromDateTime('2013-02-15');
var_dump($cal->getActualMaximum(IntlCalendar::FIELD_DAY_OF_MONTH)); //28

$cal->add(IntlCalendar::FIELD_EXTENDED_YEAR, -1);
var_dump($cal->getActualMaximum(IntlCalendar::FIELD_DAY_OF_MONTH)); //29

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

int(28)
int(29)

Смотрите также

IntlCalendar::getMaximum() - Получает глобальное максимальное значение поля
IntlCalendar::getLeastMaximum() - Получает наименьший локальный максимум поля
IntlCalendar::getActualMinimum() - Минимальное значение для поля с учётом текущего времени объекта

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы