IntlCalendar::add
(PHP 5 >= 5.5.0, PHP 7, PHP 8, PECL >= 3.0.0a1)
IntlCalendar::add — Додає кількість (зі знаком) часу у поле
Опис
Об'єктно-орієнтований стиль
public IntlCalendar::add(int $field, int $value): bool
Процедурний стиль
intlcal_add(IntlCalendar $calendar, int $field, int $value): bool
Додає кількість зі знаком у полі. Додавання позитивної суми дозволяє просуватися в часі, навіть якщо числове значення поля зменшується (наприклад, під час роботи з роками до нашої ери).
Інші поля можуть потребувати коригування, наприклад, додавання місяця до 31 січня призведе до 28 (або 29) лютого. На відміну від IntlCalendar::roll()Коли значення обертається, важливіші поля можуть змінитися. Наприклад, додавання 1 дня до 31 січня призведе до 1 лютого, а не до 1 січня.
Список параметрів
calendar
Екземпляр IntlCalendar
field
Одна з представлених у класі IntlCalendar константполей типа дата/время. Целое число от до**IntlCalendar::FIELD_COUNT**
value
Кількість зі знаком, що додається до поточного поля. Якщо сума позитивна, час буде переміщений вперед; якщо він негативний, час буде переміщений у минуле. Одиниця неявно пов'язана із типом поля. Наприклад, годинник для IntlCalendar::FIELD_HOUR_OF_DAY
Значення, що повертаються
Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.
Приклади
Приклад #1 Приклад використання IntlCalendar::add()****
Результат виконання наведеного прикладу:
31 janv. 2012 00:00:00
29 févr. 2012 00:00:00
1 mars 2012 00:00:00