IntlCalendar::roll

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

IntlCalendar::roll — Add value to field without carrying into more significant fields

Descrierea

Stil obiect-orientat

public IntlCalendar::roll ( int $field , mixed $amountOrUpOrDown ) : bool

Stil procedural

intlcal_roll ( IntlCalendar $cal , int $field , mixed $amountOrUpOrDown ) : 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.

Parametri

cal: The IntlCalendar resource.
field: Una din constantele de câmp dată/oră ale IntlCalendar. Acestea sunt valori întregi de la 0 până la IntlCalendar::FIELD_COUNT.
amountOrUpOrDown: The (signed) amount to add to the field, true for rolling up (adding 1), or false for rolling down (subtracting 1).

Valorile întoarse

Returns true on success or false on failure.

Exemple

Example #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"

Exemplul de mai sus va afișa:

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

A se vedea și

IntlCalendar::add() - Add a (signed) amount of time to a field
IntlCalendar::set() - Set a time field or several common fields at once

add a note

User Contributed Notes

There are no user contributed notes for this page.