La función IntlCalendar::add() es una función incorporada en PHP que se usa para agregar una cantidad de tiempo firmada a un campo.
Sintaxis:
- Estilo orientado a objetos:
bool IntlCalendar::add( int $field, int $amount )
- Estilo procesal:
bool intlcal_add( IntlCalendar $cal, int $field, int $amount )
Parámetros:
- $cal: este parámetro contiene el recurso IntlCalendar.
- $field: este parámetro contiene las constantes de campo de fecha/hora de IntlCalendar. Contiene el valor entero que se encuentra entre 0 e IntlCalendar::FIELD_COUNT.
- $cantidad: La cantidad firmada para agregar al campo actual. Si el valor de la cantidad es positivo, se moverá hacia adelante y si el valor de la cantidad es negativo, se moverá hacia el pasado.
Valor devuelto: esta función devuelve VERDADERO en caso de éxito o FALSO en caso de error.
Los siguientes programas ilustran la función IntlCalendar::add() en PHP:
Programa 1:
php
<?php
// Create an IntlCalendar from a DateTime object or string
$calendar = IntlCalendar::fromDateTime('2019-08-29 09:19:29');
// Add the date
$calendar->add(IntlCalendar::FIELD_MONTH, 1);
// Display the result date
echo IntlDateFormatter::formatObject($calendar), "\n";
// Add the date
$calendar->add(IntlCalendar::FIELD_WEEK_OF_MONTH, 1);
// Display the result output
echo IntlDateFormatter::formatObject($calendar);
?>
Producción:
Sep 29, 2019, 9:19:29 AM Oct 6, 2019, 9:19:29 AM
Programa 2:
php
<?php
// Create an IntlCalendar from a DateTime object or string
$calendar = IntlCalendar::fromDateTime('2019-08-29 09:19:29');
// Add the date
$calendar->add(IntlCalendar::FIELD_YEAR, 5);
// Display the result date
echo IntlDateFormatter::formatObject($calendar), "\n";
// Add the date
$calendar->add(IntlCalendar::FIELD_YEAR, 10);
// Display the result output
echo IntlDateFormatter::formatObject($calendar), "\n";
// Add the date
$calendar->add(IntlCalendar::FIELD_HOUR_OF_DAY, 10);
// Display the result output
echo IntlDateFormatter::formatObject($calendar);
?>
Producción:
Aug 29, 2024, 9:19:29 AM Aug 29, 2034, 9:19:29 AM Aug 29, 2034, 7:19:29 PM
Referencia: https://www.php.net/manual/en/intlcalendar.add.php