(PHP 5 >= 5.5.0, PHP 7, PHP 8, PECL >= 3.0.0a1)
IntlCalendar::add — Adiciona uma quantidade de tempo (com sinal) a um campo
Estilo orientado a objetos
Estilo procedural
Adiciona uma quantidade de tempo com sinal a um campo. Adicionar uma quantidade positiva permite avançar no tempo, mesmo se o valor numérico do campo diminua (por exemplo, ao trabalhar com anos em datas AC).
Outros campos podem precisar de ajuste – por exemplo, adicionar um mês a 31 de janeiro irá resultar em 28 (ou 29) de fevereiro. Contrário ao que ocorre em IntlCalendar::roll(), quando um valor passa do limite, mais campos significativos podem ser alterados. Por exemplo, adicionar um dia a 31 de janeiro irá resultar em 1º de fevereiro, e não em 1º de janeiro.
calendarUma instância de IntlCalendar.
field
Uma das constantes de campo
de data/horário da classe IntlCalendar. São valores inteiros
entre 0 e
IntlCalendar::FIELD_COUNT.
value
A quantidade com sinal a ser adicionada ao campo atual. Se a quantidade for positiva,
o instantes de tempo será movido para a frente; se for negativa, o instante será
movido para o passado. A unidade é implícita ao tipo do campo. Por exemplo,
horas para IntlCalendar::FIELD_HOUR_OF_DAY.
Exemplo #1 IntlCalendar::add()
<?php
ini_set('intl.default_locale', 'fr_FR');
ini_set('date.timezone', 'UTC');
$cal = new IntlGregorianCalendar(2012, 0 /* janeiro */, 31);
echo IntlDateFormatter::formatObject($cal), "\n";
$cal->add(IntlCalendar::FIELD_MONTH, 1);
echo IntlDateFormatter::formatObject($cal), "\n";
$cal->add(IntlCalendar::FIELD_DAY_OF_MONTH, 1);
echo IntlDateFormatter::formatObject($cal), "\n";O exemplo acima produzirá:
31 janv. 2012 00:00:00 29 févr. 2012 00:00:00 1 mars 2012 00:00:00