PHP：逃离日期地狱的实用方法-php教程-PHP中文网

PHP：逃离日期地狱的实用方法

DDD

发布： 2024-11-30 09:14:19

原创

157 人浏览过

企业的关键功能通常依赖于日期，例如订阅、定期付款或预订。

作为一名 PHP 程序员，您可能需要操作日期/时间。

开始使用第三方库？真的吗？

虽然坚持使用本机 API 来掌握技能并了解语言的工作原理通常是一个很好的做法，但让我们务实一些。

Carbon 是一个功能强大的库，它扩展了 DateTimeInterface、JsonSerialized 和其他原生 PHP 工具。

它为操作现有和新的日期对象提供了有用的帮助器：

// Tomorrow
CarbonImmutable::now()->add(1, 'day');

// Copy instance from another API
$dateTime = new \DateTime('first day of January 2025');
$carbon = Carbon::instance($dateTime);

// Parsing values
$date = Carbon::parse('2050-01-01 12:34:00', 'UTC');

登录后复制

回到基础

Carbon 扩展了原生 API，但 DateTime 对象已经提供了计算日期和时间的工具：

$date = new DateTime('2024-07-23');
$date->add(new DateInterval('P10D'));
echo $date->format('Y-m-d');

$date2 = new DateTime('2024-08-03');
$interval = $date->diff($date2);
echo $interval->format('%R%a days');

登录后复制

您可以传递字符串来获取特定输出或计算间隔和周期。

那么，为什么要使用碳等附加层呢？

更好的可读性

$yesterday = Carbon::yesterday();
$today = Carbon::today();
$now = Carbon::now();
$tomorrow = Carbon::tomorrow();
$futureDate = Carbon::today()->addDays(21)->format('Y-m-d');

if ($now->isEndOfDay()) {
    // Some code
}

登录后复制

该库对于日期比较来说方便且强大，但很容易出现各种错误。

轻松本地化

Carbon 可以方便地处理语言环境：

$now = Carbon::now()->locale('fr_FR');
echo $now->monthName;

登录后复制

处理溢出

默认的 PHP DateTime 行为在添加或减去月份时可能会产生误导。它可以溢出！

虽然您有时可能需要这种行为，但 Carbon 提供了更好的控制：

Carbon::useMonthsOverflow(false);
Carbon::resetMonthsOverflow();

登录后复制

您还可以在操作年或月时在每个方法中配置溢出（例如，subMonthsNoOverflow、addMonthsWithOverflow）。

单元测试日期

由于可变性，日期在单元测试中可能会出现问题。

Carbon 提供了先进的模拟功能，确保测试保持一致和可靠。

这可以防止随机错误破坏 CI/CD 管道。

如何避免日期/时间的常见陷阱

无论您是否使用 Carbon，都有一些实用的方法可以减少潜在的错误和不一致：

不要消除错误

PHP 的最新版本引入了更好的日期/时间异常，使您能够更一致地捕获意外输入。

但是，实现有时可以消除严重错误：

$dateInput = '2dsds';
$timestamp = strtotime($dateInput);
echo date('Y-m-d', $timestamp); // Defaults back to 1970-01-01

登录后复制

以下代码并不是改进，即使它使用 DateTime 对象：

$dateInput = '2024-02-30'; // Invalid date (February has 28 days, 29 at most)
$date = new DateTime($dateInput);
echo $date->format('l \t\h\e jS F'); // Outputs "Friday the 1st March"

登录后复制

所以，始终验证日期/时间：

$dateInput = '2dsds';
$timestamp = strtotime($dateInput);

if (false === $timestamp) {
    throw new InvalidArgumentException();
}

echo date('Y-m-d', $timestamp);

登录后复制

并且，深入检查输入：

$format = 'Y-m-d';
$dateInput = '2024-02-30';
$dateInfo = date_parse($dateInput);
if (!checkdate($dateInfo['day'], $dateInfo['month'], $dateInfo['year'])) {
    throw new InvalidArgumentException();
}

$date = DateTimeImmutable::createFromFormat($format, $dateInput);
echo $date->format('l \t\h\e jS F');

登录后复制