(PHP 5 >= 5.5.0, PHP 7, PHP 8)
DateTimeImmutable::__construct -- date_create_immutable — 返回新的 DateTimeImmutable 对象
面向对象风格
过程式风格
$datetime = "now", ?DateTimeZone $timezone = null): DateTimeImmutable|false返回一个新的 DateTimeImmutable 对象。
datetime日期/时间字符串。有效格式在日期和时间格式中解释。
在使用$timezone参数时，在此输入"now"以获取当前时间。
timezone一个DateTimeZone对象，表示$datetime的时间区域。
如果省略$timezone或为null，则将使用当前时区。
注意:
当
$datetime参数是 UNIX 时间戳（例如@946684800）或指定了时区（例如2010-01-28T15:00:00+02:00或2010-07-05T06:00:00Z）时，将忽略$timezone参数和当前时区。
返回一个新的 DateTimeImmutable 实例。
如果传递了无效的日期/时间字符串，则会抛出DateMalformedStringException。在 PHP 8.3 之前，这是Exception。
| 版本 | 描述 |
|---|---|
| 8.3.0 | 现在如果传递了无效的字符串，则抛出DateMalformedStringException，而不是Exception。 |
| 7.1.0 | 从现在开始，微秒将填充实际值。而不是“00000”。 |
示例 #1 DateTimeImmutable::__construct() 示例
面向对象风格
<?php
try {
$date = new DateTimeImmutable('2000-01-01');
} catch (Exception $e) {
echo $e->getMessage();
exit(1);
}
echo $date->format('Y-m-d');
?>过程式风格
<?php
$date = date_create('2000-01-01');
if (!$date) {
$e = date_get_last_errors();
foreach ($e['errors'] as $error) {
echo "$error\n";
}
exit(1);
}
echo date_format($date, 'Y-m-d');
?>以上示例将输出
2000-01-01
示例 #2 DateTimeImmutable::__construct() 的复杂性
<?php
// 在您的计算机时区中指定日期/时间。
$date = new DateTimeImmutable('2000-01-01');
echo $date->format('Y-m-d H:i:sP') . "\n";
// 在指定时区中指定日期/时间。
$date = new DateTimeImmutable('2000-01-01', new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";
// 您计算机时区的当前日期/时间。
$date = new DateTimeImmutable();
echo $date->format('Y-m-d H:i:sP') . "\n";
// 指定时区的当前日期/时间。
$date = new DateTimeImmutable('now', new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";
// 使用 UNIX 时间戳。请注意结果位于 UTC 时区。
$date = new DateTimeImmutable('@946684800');
echo $date->format('Y-m-d H:i:sP') . "\n";
// 不存在的数值会循环。
$date = new DateTimeImmutable('2000-02-30');
echo $date->format('Y-m-d H:i:sP') . "\n";
?>以上示例的输出类似于以下内容
2000-01-01 00:00:00-05:00 2000-01-01 00:00:00+12:00 2010-04-24 10:24:16-04:00 2010-04-25 02:24:16+12:00 2000-01-01 00:00:00+00:00 2000-03-01 00:00:00-05:00
示例 #3 更改关联时区
<?php
$timeZone = new \DateTimeZone('Asia/Tokyo');
$time = new \DateTimeImmutable();
$time = $time->setTimezone($timeZone);
echo $time->format('Y/m/d H:i:s'), "\n";
?>以上示例的输出类似于以下内容
2022/08/12 23:49:23
示例 #4 使用相对日期/时间字符串
<?php
$time = new \DateTimeImmutable("-1 year");
echo $time->format('Y/m/d H:i:s'), "\n";
?>以上示例的输出类似于以下内容
2021/08/12 15:43:51
"如果省略 $timezone 或为 null，则将使用当前时区。" - 请注意，时区不等于偏移量，如果这对您的应用程序很重要。
如果默认时区 = Europe/Moscow，则
echo (new \DateTimeImmutable('2014-10'))->format(DATE_ATOM); // 输出 "2014-10-01T00:00:00+04:00"
echo (new \DateTimeImmutable('2014-11'))->format(DATE_ATOM); // 输出 "2014-11-01T00:00:00+03:00"
因为法律变更（废除“夏令时”）。