大网数据广告活动
PHP 语言与运行手册

DateTimeImmutable::setISODate · Sets the ISO date

· 52CE 我爱测

DateTimeImmutable::setISODate — Sets the ISO date

DateTimeImmutable::setISODate

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

DateTimeImmutable::setISODate — Sets the ISO date

说明

#[\NoDiscard(message: "as DateTimeImmutable::setISODate() does not modify the object itself")]
public function 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 对象。

错误/异常

Throws a DateObjectError if the object has not been correctly initialized, for example when the constructor of a child class does not call the parent constructor.

更新日志

版本 说明
8.3.0 A DateObjectError is now thrown if the object has not been correctly initialized; previously, an Error was thrown.

示例

示例 #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');

以上示例会输出:

3

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。