IntlCalendar::getActualMaximum

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

IntlCalendar::getActualMaximum — El valor máximo de un campo, considerando el instante actual del objeto

Descripción

Estilo orientado a objetos

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

Estilo por procedimientos

intlcal_get_actual_maximum ( IntlCalendar $cal , int $field ) : int

Devuelve un valor máximo relativo de un campo en torno al instante actual. La semántica exacta varía según cada campo, pero en general, será el valor que se obtendría si se estableciera el valor del campo al máximo relativo más pequeño y se incrementara hasta alcanzar el máximo global o sobrepasase, en donde el valor devuelto sería el máximo global o el valor antes de sobrepasar, respectivamente.

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

Parámetros

cal

El recurso IntlCalendar.

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 campo dado por field 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