首页 > 文章 > php教程

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

来源：dev.to

时间：2024-11-28 14:22:09 493浏览收藏

从现在开始，我们要努力学习啦！今天我给大家带来《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');