2024-11-27

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');
登录后复制

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

立即学习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 创建后无法更改。大多数时候,您不需要改变初始日期。

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

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

不要忽视时区

忽视时区是有风险的:

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

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

您可能还会遇到夏令时或存储格式(例如,utc 与当地时间)等复杂问题,而对于鼓励良好实践的库来说,这可能会减轻一些痛苦。

包起来

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

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

无论您是否使用它,请确保您了解本机 php datetime 对象的默认行为。

以上就是PHP:逃离日期地狱的实用方法的详细内容,更多请关注php中文网其它相关文章!

https://www.php.cn/faq/1113329.html

发表回复

Your email address will not be published. Required fields are marked *