DateTime::setISODate
date_isodate_set
(PHP 5 >= 5.2.0, PHP 7)
DateTime::setISODate -- date_isodate_set — ISO 日付を設定する
説明
オブジェクト指向型
手続き型
ISO 8601 標準形式、つまり週と日オフセットで日付を設定します。
パラメータ
-
object -
手続き型のみ: date_create() が返す DateTime オブジェクト。 この関数は、このオブジェクトを変更します。
-
year -
その日付の年。
-
week -
その日付の週。
-
day -
週の最初の日からのオフセット。
返り値
メソッドチェインに使う DateTime オブジェクトを返します。失敗した場合に FALSE を返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 5.3.0 | 成功した場合の返り値が
NULL から DateTime に変更されました。 |
例
例1 DateTime::setISODate() の例
オブジェクト指向型
<?php
$date = new DateTime();
$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 DateTime();
$date->setISODate(2008, 2, 7);
echo $date->format('Y-m-d') . "\n";
$date->setISODate(2008, 2, 8);
echo $date->format('Y-m-d') . "\n";
$date->setISODate(2008, 53, 7);
echo $date->format('Y-m-d') . "\n";
?>
上の例の出力は以下となります。
2008-01-13 2008-01-14 2009-01-04
例3 その週が存在する月を探す例
<?php
$date = new DateTime();
$date->setISODate(2008, 14);
echo $date->format('n');
?>
上の例の出力は以下となります。
3
参考
- DateTime::setDate() - 日付を設定する
- DateTime::setTime() - 時刻を設定する
忘却曲線を使ってこの知識を確実に記憶に残す
