日期/时间

## 简介
DateTimeImmutable 和关联类允许表示日期/时间信息。通过传递字符串表述的日期/时间信息或从当前系统时间来创建这些对象。

还提供了丰富的方法来修改和格式化这些信息，包括处理时区和 DST（夏令时）转换。

PHP 中的日期/时间功能实现了 ISO 8601 历法，这是[» 前公历](https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar "» 前公历")，实现了公历之前的当前闰日规则，并且还包括 0 年作为介于两者之间的年份——公元前 1 年和公元 1 年。不支持闰秒。

日期和时间信息在内部是以 64 位数字存储的，所以支持所有可能有用的日期（包括负数年份）。其范围覆盖当前时间前后 2920 亿年的时间。

> 注意: 本节中用到的时区可以从所支持的时区列表获取。

## 安装/配置

### 需求
构建此扩展不需要其他扩展。

### 安装
使用这些函数不需要安装，它们是 PHP 核心的一部分。

> 注意: 获取最新版的时区数据
可以通过安装 PECL 的 [» timezonedb](https://pecl.php.net/get/timezonedb "» timezonedb") 获取最新的时区数据。

### 运行时配置
此扩展没有在 `php.ini` 中定义配置指令。

### 资源类型
此扩展没有定义资源类型。

## 预定义常量
已定义的 DATE_ 常量提供了一些标准的日期时间的表达，可以用在日期时间格式化的函数中（例如 date()）。

下列常量指定了 date_sunrise() 和 date_sunset() 函数返回的格式。

`SUNFUNCS_RET_TIMESTAMP （int）`
时间戳

`SUNFUNCS_RET_STRING （int）`
小时:分钟（例如：08:02）

`SUNFUNCS_RET_DOUBLE （int）`
浮点数表示的小时（例如：8.75）

## 示例

### 日期/时间算法
以下示例展示了有关 DST 转换和具有不同天数的月份的日期/时间算法的一些缺陷。

示例 #1 DateTimeImmutable::add/sub 添加包含经过时间的间隔

在 DST 转换上添加 PT24H 似乎会增加 23/25 小时（大多数时区）。

```php
<?php
$dt = new DateTimeImmutable("2015-11-01 00:00:00", new DateTimeZone("America/New_York"));
echo "Start: ", $dt->format("Y-m-d H:i:s P"), PHP_EOL;
$dt = $dt->add(new DateInterval("PT3H"));
echo "End:   ", $dt->format("Y-m-d H:i:s P"), PHP_EOL;
?>
```
以上示例会输出：

```
Start: 2015-11-01 00:00:00 -04:00
End:   2015-11-01 02:00:00 -05:00
```
示例 #2 DateTimeImmutable::modify 和 strtotime 递增/减单个组件值

在 DST 转换上添加 +24 小时将准确添加 24 小时，如日期/时间字符串中所示（除非开始/结束时间位于转换点）。

```php
<?php
$dt = new DateTimeImmutable("2015-11-01 00:00:00", new DateTimeZone("America/New_York"));
echo "Start: ", $dt->format("Y-m-d H:i:s P"), PHP_EOL;
$dt = $dt->modify("+24 hours");
echo "End:   ", $dt->format("Y-m-d H:i:s P"), PHP_EOL;
?>
```
以上示例会输出：

```
Start: 2015-11-01 00:00:00 -04:00
End:   2015-11-02 00:00:00 -05:00
```
示例 #3 新增/减去时间可能会溢出/下溢日期

就像 1 月 31 日 + 1 月会导致 3 月 2 日（闰年）或 3 月 3 日（平年）。

```php
<?php
echo "Normal year:\n"; // 2 月有 28 天
$dt = new DateTimeImmutable("2015-01-31 00:00:00", new DateTimeZone("America/New_York"));
echo "Start: ", $dt->format("Y-m-d H:i:s P"), PHP_EOL;
$dt = $dt->modify("+1 month");
echo "End:   ", $dt->format("Y-m-d H:i:s P"), PHP_EOL;

echo "Leap year:\n"; // 2 月有 29 天
$dt = new DateTimeImmutable("2016-01-31 00:00:00", new DateTimeZone("America/New_York"));
echo "Start: ", $dt->format("Y-m-d H:i:s P"), PHP_EOL;
$dt = $dt->modify("+1 month");
echo "End:   ", $dt->format("Y-m-d H:i:s P"), PHP_EOL;
?>
```
以上示例会输出：

```
Normal year:
Start: 2015-01-31 00:00:00 -05:00
End:   2015-03-03 00:00:00 -05:00
Leap year:
Start: 2016-01-31 00:00:00 -05:00
End:   2016-03-02 00:00:00 -05:00
```
要获取下个月的最后一天（例如防止溢出），可以使用 last day of 格式。

```php
<?php
echo "Normal year:\n"; // 2 月有 28 天
$dt = new DateTimeImmutable("2015-01-31 00:00:00", new DateTimeZone("America/New_York"));
echo "Start: ", $dt->format("Y-m-d H:i:s P"), PHP_EOL;
$dt = $dt->modify("last day of next month");
echo "End:   ", $dt->format("Y-m-d H:i:s P"), PHP_EOL;

echo "Leap year:\n"; // 2 月有 29 天
$dt = new DateTimeImmutable("2016-01-31 00:00:00", new DateTimeZone("America/New_York"));
echo "Start: ", $dt->format("Y-m-d H:i:s P"), PHP_EOL;
$dt = $dt->modify("last day of next month");
echo "End:   ", $dt->format("Y-m-d H:i:s P"), PHP_EOL;
?>
```
以上示例会输出：

```
Normal year:
Start: 2015-01-31 00:00:00 -05:00
End:   2015-02-28 00:00:00 -05:00
Leap year:
Start: 2016-01-31 00:00:00 -05:00
End:   2016-02-29 00:00:00 -05:00
```