(PHP 5 >= 5.5.0, PHP 7, PHP 8)
DateTimeImmutable::setISODate — ISO 日付を設定する
ISO 8601 標準形式、 つまり週と日オフセットで日付を設定する形式に従って日付を設定した、 新しい DateTimeImmutable オブジェクトを返します。
object手続き型のみ: date_create() が返す DateTime オブジェクト。 この関数は、このオブジェクトを変更します。
yearその日付の年。
weekその日付の週。
dayOfWeek週の最初の日からのオフセット。
新しく変更された DateTimeImmutable オブジェクトを返します。失敗した場合に false を返します.
例1 DateTimeImmutable::setISODate() の例
オブジェクト指向型
<?php
$date = new DateTimeImmutable();
$date->setISODate(2008, 2);
echo $date->format('Y-m-d') . "\n";
$date->setISODate(2008, 2, 7);
echo $date->format('Y-m-d') . "\n";
?>
手続き型
<?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');
?>
上の例の出力は以下となります。
3