IntlCalendar::set

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

    IntlCalendar::set — Set a time field or several common fields at once

    说明

    面向对象风格

    public IntlCalendar::set(int $field, int $value): true
    public IntlCalendar::set(
        int $year,
        int $month,
        int $dayOfMonth = NULL,
        int $hour = NULL,
        int $minute = NULL,
        int $second = NULL
    ): true

    过程化风格

    intlcal_set(IntlCalendar $cal, int $field, int $value): true
    intlcal_set(
        IntlCalendar $cal,
        int $year,
        int $month,
        int $dayOfMonth = NULL,
        int $hour = NULL,
        int $minute = NULL,
        int $second = NULL
    ): bool

    Sets either a specific field to the given value, or sets at once several common fields. The range of values that are accepted depend on whether the calendar is using the lenient mode.

    For fields that conflict, the fields that are set later have priority.

    This method cannot be called with exactly four arguments.

    参数

    cal

    IntlCalendar 实例。

    field

    One of the IntlCalendar date/time field constants. These are integer values between 0 and IntlCalendar::FIELD_COUNT.

    value

    The new value of the given field.

    year

    The new value for IntlCalendar::FIELD_YEAR.

    month

    The new value for IntlCalendar::FIELD_MONTH. The month sequence is zero-based, i.e., January is represented by 0, February by 1, …, December is 11 and Undecember (if the calendar has it) is 12.

    dayOfMonth

    The new value for IntlCalendar::FIELD_DAY_OF_MONTH.

    hour

    The new value for IntlCalendar::FIELD_HOUR_OF_DAY.

    minute

    The new value for IntlCalendar::FIELD_MINUTE.

    second

    The new value for IntlCalendar::FIELD_SECOND.

    返回值

    总是返回 true。

    更新日志

    版本 说明
    8.2.0 现在返回类型为 true；之前是 bool。
    8.4.0 This had been deprecated in favor of the methods IntlCalendar::setDate() and IntlCalendar::setDateTime().

    示例

    示例 #1 IntlCalendar::set()

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

    //Calls made later have priority
    $cal = new IntlGregorianCalendar(2013, 6 /* July */, 1);
    $cal->set(IntlCalendar::FIELD_YEAR, 2012);
    $cal->set(IntlCalendar::FIELD_EXTENDED_YEAR, 2011);
    var_dump(IntlDateFormatter::formatObject($cal));


    $cal = new IntlGregorianCalendar(2013, 6 /* July */, 1);
    $cal->set(IntlCalendar::FIELD_YEAR, 2012);
    $cal->set(IntlCalendar::FIELD_EXTENDED_YEAR, 2011);
    //the time has not been recalculated yet. If we clear the extended year,
    //the year set before will be used
    $cal->clear(IntlCalendar::FIELD_EXTENDED_YEAR);
    var_dump(IntlDateFormatter::formatObject($cal));

    以上示例会输出：

    string(20) "01/07/2011, 00:00:00"
string(20) "01/07/2012, 00:00:00"

    参见

    发现了问题？

    了解如何改进此页面 • 提交拉取请求 • 报告一个错误
    ＋添加备注

    用户贡献的备注

    此页面尚无用户贡献的备注。
    To Top