PHP マニュアル: ISO 日付を設定する

説明

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

ISO 8601 標準形式、つまり週と日オフセットで日付を設定する形式に従って日付を設定した、新しい DateTimeImmutable オブジェクトを返します。

パラメータ

year: その日付の年。
week: その日付の週。
dayOfWeek: 週の最初の日からのオフセット。

戻り値

変更されたデータを持つ、新しい DateTimeImmutable オブジェクトを返します。

例

例1 DateTimeImmutable::setISODate の例

オブジェクト指向型

<?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 範囲を超えた値が親の値に加算される例

<?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 その週が存在する月を探す例

<?php

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

上の例の出力は以下となります。

参考

DateTimeImmutable::setDate
DateTimeImmutable::setTime