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

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

作为一名 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');

防止意外突变

DateTimeImmutable 或 CarbonImmutable 创建后无法更改。大多数时候，您不需要改变初始日期。

如果代码的其他部分依赖于该实例，则可能会引入严重的错误。

不可变格式可以防止此类副作用，并且通常更有利于可读性和测试。

不要忽视时区

忽视时区是有风险的：

PHP：了解时区

spO0q ・ 8 月 4 日

#php #初学者 ＃编程

如果您未在应用中指定默认时区，则服务器将确定它。

但是，您的应用程序可能部署在不同时区的服务器上。

您可能还会遇到夏令时或存储格式（例如，UTC 与当地时间）等复杂问题，如果库鼓励良好实践，这可能会减轻一些痛苦。

包起来

原生 API 允许对日期和时间进行高级操作，而 Carbon 则对其进行了精美的扩展。

PHP 开发人员可以利用这个附加层来简化计算并提高可读性。

无论您是否使用它，请确保您了解本机 PHP DateTime 对象的默认行为。

以上是PHP：逃离日期地狱的实用方法的详细内容。更多信息请关注PHP中文网其他相关文章！