企业的关键功能通常依赖于日期，例如订阅、定期付款或预订。
作为一名 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');
您可以传递字符串来获取特定输出或计算间隔和周期。
立即学习“PHP免费学习笔记（深入）”；
那么，为什么要使用碳等附加层呢？
更好的可读性
$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 he 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 he jS F');
防止意外突变
datetimeimmutable 或 carbonimmutable 创建后无法更改。大多数时候，您不需要改变初始日期。
如果代码的其他部分依赖于该实例，则可能会引入严重的错误。
不可变格式可以防止此类副作用，并且通常更有利于可读性和测试。
不要忽视时区
忽视时区是有风险的：
php：了解时区
spo0q ・ 8 月 4 日
如果您未在应用中指定默认时区，则服务器将确定它。
但是，您的应用程序可能部署在不同时区的服务器上。
您可能还会遇到夏令时或存储格式（例如，utc 与当地时间）等复杂问题，而对于鼓励良好实践的库来说，这可能会减轻一些痛苦。
包起来
原生 api 允许对日期和时间进行高级操作，而 carbon 则对其进行了精美的扩展。
php 开发人员可以利用这个附加层来简化计算并提高可读性。
无论您是否使用它，请确保您了解本机 php datetime 对象的默认行为。
