php8.5
Home/ Manual/ intl / intlcalendar/ IntlCalendar::getActualMaximum

IntlCalendar::getActualMaximum

PHP function Edit on GitHub ✎

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

The maximum value for a field, considering the objectʼs current time

Description

Oop

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

Procedural

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

Returns a fieldʼs relative maximum value around the current time. The exact semantics vary by field, but in the general case this is the value that would be obtained if one would set the field value into the smallest relative maximum for the field and would increment it until reaching the global maximum or the field value wraps around, in which the value returned would be the global maximum or the value before the wrapping, respectively.

For instance, in the gregorian calendar, the actual maximum value for the day of month would vary between 28 and 31, depending on the month and year of the current time.

Parameters

calendar

Intl-calendar

field

Incfieldparam

Return Values

An int representing the maximum value in the units associated with the given fieldFalseforfailure.

Examples

IntlCalendar::getActualMaximum()

php
<?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

The above example will output:

output
int(28)
int(29)

See Also

  • IntlCalendar::getMaximum
  • IntlCalendar::getLeastMaximum
  • IntlCalendar::getActualMinimum

Source: reference/intl/intlcalendar/getactualmaximum.xml · from the official PHP manual (php/doc-en)