PHP Conference Nagoya 2025

IntlCalendar::roll

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

IntlCalendar::rollAdd value to field without carrying into more significant fields

Опис

Об'єктно-орієнтований стиль

public IntlCalendar::roll(int $field, int|bool $value): bool

Процедурний стиль

intlcal_roll(IntlCalendar $calendar, int $field, int|bool $value): bool

Adds a (signed) amount to a field. The difference with respect to IntlCalendar::add() is that when the field value overflows, it does not carry into more significant fields.

Параметри

calendar

Примірник IntlCalendar.

field

Одна із предвизначених констант дати/часу для IntlCalendar. Вони мають цілочисельний (integer) тип зі значенням між 0 та IntlCalendar::FIELD_COUNT.

value

The (signed) amount to add to the field, true for rolling up (adding 1), or false for rolling down (subtracting 1).

Значення, що повертаються

Returns true on success or false on failure.

Приклади

Приклад #1 IntlCalendar::roll()

<?php
ini_set
('date.timezone', 'Europe/Lisbon');
ini_set('intl.default_locale', 'pt_PT');

$cal = new IntlGregorianCalendar(2013, 5 /* June */, 30);

$cal->add(IntlCalendar::FIELD_DAY_OF_MONTH, 1);
var_dump(IntlDateFormatter::formatObject($cal)); // "01/07/2013, 00:00:00"

$cal->set(2013, 5 /* June */, 30);
$cal->roll(IntlCalendar::FIELD_DAY_OF_MONTH, true); // roll up, same as rolling +1
var_dump(IntlDateFormatter::formatObject($cal)); // "01/06/2013, 00:00:00"

Поданий вище приклад виведе:

string(20) "01/07/2013, 00:00:00"
string(20) "01/06/2013, 00:00:00"

Прогляньте також

add a note

User Contributed Notes

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