IntlCalendar::getActualMaximum
(PHP 5 >= 5.5.0, PHP 7, PHP 8, PECL >= 3.0.0a1)
IntlCalendar::getActualMaximum — The maximum value for a field, considering the objectʼs current time
Beschreibung
Objektorientierter Stil
$field): int|falseProzeduraler Stil
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.
Parameter-Liste
-
calendar -
Eine IntlCalendar-Instanz.
-
field -
One of the IntlCalendar date/time field constants. These are integer values between
0andIntlCalendar::FIELD_COUNT.
Rückgabewerte
An int representing the maximum value in the units associated
with the given fieldBei einem Fehler wird false zurückgegeben..
Beispiele
Beispiel #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
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
int(28) int(29)
Siehe auch
- IntlCalendar::getMaximum() - Get the global maximum value for a field
- IntlCalendar::getLeastMaximum() - Get the smallest local maximum for a field
- IntlCalendar::getActualMinimum() - The minimum value for a field, considering the objectʼs current time
