ConFoo: Call for paper is now Open

IntlCalendar::add

(PHP 5.5.0, PECL >= 3.0.0a1)

IntlCalendar::addAñadir una candidad (con signo) de tiempo al campo

Descripción

Estilo orientado a objetos

public bool IntlCalendar::add ( int $field , int $amount )

Estilo por procedimientos

bool intlcal_add ( IntlCalendar $cal , int $field , int $amount )

Añade una cantidad con signo a un campo. Una cantidad positiva permite avanzar el tiempo, incluso si el valor numérico del campo decrementa (p.ej., al trabajar con años en fechas AC).

Podría ser necesario ajustar otros campos – por ejemplo, añadir un mes al 31 de enero resultará en el 28 (o 29) de febrero. Al contrario que IntlCalendar::roll(), cuando un valor envuelve, podrían cambiar significativamente más campos. Por ejemplo, añadir un día al 31 de enero resultará en el 1 de febrero, no en el 1 de enero.

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.

amount

La cantidad con signo a añadir al campo actual. Si la cantidad es positiva, el instante avanzará; si es negativa, el instante retrocederá. La unidad está implícita en el tipo de campo. Por ejemplo, horas para IntlCalendar::FIELD_HOUR_OF_DAY.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Ejemplos

Ejemplo #1 IntlCalendar::add()

<?php
ini_set
('intl.default_locale''fr_FR');
ini_set('date.timezone''UTC');

$cal = new IntlGregorianCalendar(2012/* January */31);
echo 
IntlDateFormatter::formatObject($cal), "\n";

$cal->add(IntlCalendar::FIELD_MONTH1);
echo 
IntlDateFormatter::formatObject($cal), "\n";

$cal->add(IntlCalendar::FIELD_DAY_OF_MONTH1);
echo 
IntlDateFormatter::formatObject($cal), "\n";

El resultado del ejemplo sería:

31 janv. 2012 00:00:00
29 févr. 2012 00:00:00
1 mars 2012 00:00:00

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top