IntlCalendar::getActualMaximum

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

IntlCalendar::getActualMaximumEl valor máximo para un campo, considerando el tiempo actual del objeto

Descripción

Estilo orientado a objetos

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

Estilo por procedimientos

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

Devuelve el valor máximo para un campo, considerando el tiempo actual del objeto. La semántica exacta varía según el campo, pero en el caso general, es el valor que se obtendría si se fijara el valor del campo al mínimo máximo relativo para el campo y se incrementara hasta alcanzar el máximo global o que el valor del campo se reinicie, en cuyo caso el valor devuelto sería el máximo global o el valor antes del reinicio, respectivamente.

Por ejemplo, en el calendario gregoriano, el valor máximo real para el día del mes variaría entre 28 y 31, según el mes y el año del tiempo actual.

Parámetros

calendar

An IntlCalendar instance.

field

Una de las constantes del campo fecha/hora de IntlCalendar. Son valores de tipo integer entre 0 y IntlCalendar::FIELD_COUNT.

Valores devueltos

Un int que representa el valor máximo en las unidades asociadas al field dado o false en caso de error.

Ejemplos

Ejemplo #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

El resultado del ejemplo sería:

int(28)
int(29)

Ver también