企业的关键功能通常依赖于日期,例如订阅、定期付款或预订。
作为一名 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 对象的默认行为。
以上就是PHP:逃离日期地狱的实用方法的详细内容,更多请关注php中文网其它相关文章!