2024 日本 PHP 研討會

    IntlCalendar::roll

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

    IntlCalendar::roll — 將值新增至欄位而不進位到更重要的欄位

    說明

    物件導向風格

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

    程序式風格

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

    將一個（有符號的）數量加到一個欄位。與 IntlCalendar::add() 的不同之處在於，當欄位值溢位時，它不會進位到更重要的欄位。

    參數

    calendar

    一個 IntlCalendar 實例。

    field

    IntlCalendar 日期/時間欄位常數 之一。這些是介於 0 和 IntlCalendar::FIELD_COUNT 之間的整數值。

    value

    要添加到欄位的（有符號）數量，true 表示向上滾動（加 1），或 false 表示向下滾動（減 1）。

    返回值

    成功時返回 true，失敗時返回 false。

    範例

    範例 #1 IntlCalendar::roll()

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

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

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

    $cal->set(2013, 5 /* 六月 */, 30);
    $cal->roll(IntlCalendar::FIELD_DAY_OF_MONTH, true); // 向上滾動，與滾動 +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"

    參見

    發現問題了嗎？

    學習如何改進此頁面 • 提交拉取請求 • 回報錯誤
    ＋新增筆記

    使用者貢獻的筆記

    此頁面沒有使用者貢獻的筆記。
    To Top