PHP 日期与时间

// 获取当前时间戳（Unix 时间戳：1970-01-01 起的秒数）
echo time(); // 如：1714000000
// 格式化当前时间
echo date('Y-m-d');           // 2024-01-15
echo date('Y-m-d H:i:s');     // 2024-01-15 14:30:00
echo date('Y年m月d日 H:i');   // 2024年01月15日 14:30
echo date('D, d M Y');        // Mon, 15 Jan 2024
``

date() 函数的第二个参数可以传入时间戳，不传则默认使用当前时间。需要注意的是，date() 输出的时间受 date_default_timezone_set() 设置的时区影响，在项目入口文件中统一设置时区是良好的实践。

date() 格式字符
字符
说明
示例
Y
四位年份
2024
m
两位月份
01-12
d
两位日期
01-31
H
24小时制小时
00-23
i
分钟
00-59
s
秒
00-59
N
星期（1=周一）
1-7
U
Unix 时间戳
1714000000
时间戳转换
strtotime() 是 PHP 中非常强大的函数，可以将人类可读的日期字符串解析为时间戳，还支持相对时间表达式，如 +7 days、next Monday、-1 month 等。

`php
// 字符串转时间戳
$ts = strtotime('2024-06-01');
$ts = strtotime('next Monday');
$ts = strtotime('+7 days');
$ts = strtotime('-1 month');

echo date('Y-m-d', strtotime('+30 days')); // 30天后的日期
// mktime() 创建指定时间的时间戳
$ts = mktime(12, 0, 0, 6, 1, 2024); // 2024-06-01 12:00:00
echo date('Y-m-d H:i:s', $ts);
`

strtotime() 解析失败时返回 false，使用前应做检查。对于用户输入的日期字符串，建议使用 DateTime::createFromFormat() 指定格式解析，更加可靠。mktime() 参数顺序是 (时, 分, 秒, 月, 日, 年)，注意月和日的顺序与直觉相反。

DateTime 类（推荐）
面向对象的 DateTime 类比函数式 API 更加灵活，支持链式调用，并且可以与 DateTimeZone、DateInterval 等类配合使用，处理复杂的日期时间逻辑。

`php
// 创建
$now  = new DateTime();
$date = new DateTime('2024-06-01');
$date = new DateTime('now', new DateTimeZone('Asia/Shanghai'));

// 格式化
echo $now->format('Y-m-d H:i:s');
// 修改
$date->modify('+1 month');
$date->modify('next Friday');
// 设置
$date->setDate(2024, 12, 25);
$date->setTime(10, 30, 0);
`

DateTime::createFromFormat() 静态方法可以按指定格式解析日期字符串，例如 DateTime::createFromFormat('d/m/Y', '25/12/2024') 可以正确解析欧式日期格式。解析失败时返回 false，可以通过 DateTime::getLastErrors() 获取详细的错误信息。

日期计算
DateTime::diff() 方法返回一个 DateInterval 对象，包含两个日期之间的年、月、日、时、分、秒差值，以及总天数（days 属性）。这是计算日期差值最准确的方式。

`php
$start = new DateTime('2024-01-01');
$end   = new DateTime('2024-12-31');

// 计算差值
$diff = $start->diff($end);
echo $diff->days;   // 365（总天数）
echo $diff->m;      // 月数
echo $diff->y;      // 年数
// 判断是否过期
$expire = new DateTime('2024-06-01');
$now    = new DateTime();
if ($now > $expire) {
    echo '已过期';
}
`

DateInterval 对象的 invert 属性表示方向，0 表示正向（start < end），1 表示反向（start > end）。DateTime 对象支持直接用比较运算符（>、<、==）进行比较，非常直观。

DateTimeImmutable（不可变对象）
DateTime 的 modify()、setDate() 等方法会直接修改原对象，在函数式编程或需要保留原始值的场景中容易引发 bug。DateTimeImmutable 解决了这个问题，所有修改操作都返回新对象，原对象保持不变。

`php
// DateTime 会修改原对象，DateTimeImmutable 返回新对象
$date    = new DateTimeImmutable('2024-01-01');
$newDate = $date->modify('+1 month'); // $date 不变

echo $date->format('Y-m-d');    // 2024-01-01（不变）
echo $newDate->format('Y-m-d'); // 2024-02-01
`

在现代 PHP 项目中，推荐优先使用 DateTimeImmutable 而不是 DateTime，因为不可变对象更安全，不会因为意外修改而引发难以追踪的 bug。DateTimeImmutable 和 DateTime 都实现了 DateTimeInterface 接口，函数参数类型提示应使用接口类型。

时区设置
时区处理是国际化应用的难点之一。PHP 使用 IANA 时区数据库，中国大陆应使用 Asia/Shanghai（而不是 Asia/Beijing，后者不存在）。

`php
// 全局设置（推荐放在入口文件）
date_default_timezone_set('Asia/Shanghai');

echo date('Y-m-d H:i:s'); // 北京时间
// 单独指定时区
$tz   = new DateTimeZone('America/New_York');
$date = new DateTime('now', $tz);
echo $date->format('Y-m-d H:i:s');
`

处理跨时区数据时，推荐在数据库中统一存储 UTC 时间，在展示时再转换为用户所在时区。DateTime 的 setTimezone() 方法可以转换时区，时间戳本身不受时区影响，是跨时区传递时间的最安全方式。

实用示例
日期时间处理在实际项目中有很多常见场景，下面是两个典型的工具函数：计算年龄和格式化"多久前"。
`php
// 计算年龄
function calcAge(string $birthday): int {
    return (new DateTime($birthday))->diff(new DateTime())->y;
}
echo calcAge('1995-08-15'); // 28

// 格式化为"多久前"
function timeAgo(int $timestamp): string {
    $diff = time() - $timestamp;
    if ($diff < 60)     return $diff . ' 秒前';
    if ($diff < 3600)   return floor($diff / 60) . ' 分钟前';
    if ($diff < 86400)  return floor($diff / 3600) . ' 小时前';
    if ($diff < 604800) return floor($diff / 86400) . ' 天前';
    return date('Y-m-d', $timestamp);
}
echo timeAgo(time() - 3600); // 1 小时前
`

timeAgo() 函数在社交应用、评论系统中非常常见，可以根据需要扩展支持"X 个月前"、"X 年前"等更多粒度。对于需要本地化的场景，可以结合 PHP 的 IntlDateFormatter 类或第三方库 Carbon 来实现多语言的时间格式化。

Carbon 库简介
Carbon 是 PHP 中最流行的日期时间处理库，基于 DateTime 扩展，提供了更丰富的 API 和更友好的链式调用语法。

`php
// 安装：composer require nesbot/carbon
use Carbon\Carbon;

$now = Carbon::now('Asia/Shanghai');
echo $now->format('Y-m-d H:i:s');
// 链式操作
$date = Carbon::parse('2024-01-01')
    ->addMonths(3)
    ->subDays(5)
    ->startOfDay();
// 人性化输出
echo Carbon::parse('2024-01-01')->diffForHumans(); // 3 months ago
// 判断
$date = Carbon::now();
echo $date->isWeekend() ? '周末' : '工作日';
echo $date->isToday()   ? '今天' : '不是今天';