DateTime::setISODate
date_isodate_set
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
DateTime::setISODate -- date_isodate_set — 設定 ISO 日期
說明
物件導向風格
過程化風格
以 ISO 8601 規範的格式設定日期， 使用周和日的偏移量作為參數，而不是使用月和日。
參數
-
object -
僅過程化風格：由 date_create() 返回的 DateTime 型別的對象。此函式會修改這個對象。
-
year -
年份。
-
week -
周。
-
dayOfWeek -
從周的第一天計算，日在一週內的偏移量。
返回值
返回被修改的 DateTime 對象， 或者在失敗時返回 false.
範例
示例 #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 對象的日期
- DateTime::setTime() - 設定 DateTime 對象的時間