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');

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

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

DateTimeImmutable::setDate() - Sets the date
DateTimeImmutable::setTime() - Sets the time

Found A Problem?

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

＋add a note

User Contributed Notes 1 note

down

samuele dot catuzzi at gmail dot com ¶

4 months 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