DateTimeImmutable::setISODate

    (PHP 5 >= 5.5.0, PHP 7, PHP 8)

    DateTimeImmutable::setISODate — Sets the ISO date

    Опис

    #[\NoDiscard]
    public DateTimeImmutable::setISODate(int $year, int $week, int $dayOfWeek = 1): DateTimeImmutable

    Returns a new DateTimeImmutable object with the date set according to the ISO 8601 standard - using weeks and day offsets rather than specific dates.

    Параметри

    year

    Year of the date.

    week

    Week of the date.

    dayOfWeek

    Offset from the first day of the week.

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

    Повертає новий об'єкт DateTimeImmutable зі зміненими даними.

    Приклади

    Приклад #1 DateTimeImmutable::setISODate() example

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

    <?php

    $date     = new DateTimeImmutable();

    $newDate = $date->setISODate(2008, 2);
    echo     $newDate->format('Y-m-d') . "\n";

    $newDate = $date->setISODate(2008, 2, 7);
    echo     $newDate->format('Y-m-d') . "\n";

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

    2008-01-07
2008-01-13

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

    <?php

    $date     = date_create();

    date_isodate_set($date, 2008, 2);
    echo     date_format($date, 'Y-m-d') . "\n";

    date_isodate_set($date, 2008, 2, 7);
    echo     date_format($date, 'Y-m-d') . "\n";

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

    2008-01-07
2008-01-13

    Приклад #2 Values exceeding ranges are added to their parent values

    <?php

    $date     = new DateTimeImmutable();

    $newDate = $date->setISODate(2008, 2, 7);
    echo     $newDate->format('Y-m-d') . "\n";

    $newDate = $date->setISODate(2008, 2, 8);
    echo     $newDate->format('Y-m-d') . "\n";

    $newDate = $date->setISODate(2008, 53, 7);
    echo     $newDate->format('Y-m-d') . "\n";

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

    2008-01-13
2008-01-14
2009-01-04

    Приклад #3 Finding the month a week is in

    <?php

    $date     = new DateTimeImmutable();
    $newDate = $date->setISODate(2008, 14);
    echo     $newDate->format('n');

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

    3

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

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    0
    samuele dot catuzzi at gmail dot com
    1 day ago
    note that giving a week out of range will produce a date for a different year

example:
<?php
$date = new DateTimeImmutable();

$newDate = $date->setISODate(2026, 53);
echo $newDate->format('Y-m-d') . "\n";
// will print "2026-12-28"  (2026 has 53 weeks)

$newDate = $date->setISODate(2026, 54);
echo $newDate->format('Y-m-d') . "\n";
// will print 2027-01-04 which is the 1st week of 2027
?>
    ＋add a note
    To Top