企業(yè)的關鍵功能通常依賴于日期，例如訂閱、定期付款或預訂。

作為一名 PHP 程序員，您可能需要操作日期/時間。

開始使用第三方庫？真的嗎？

雖然堅持使用本機 API 來掌握技能并了解語言的工作原理通常是一個很好的做法，但讓我們務實一些。

Carbon 是一個功能強大的庫，它擴展了 DateTimeInterface、JsonSerialized 和其他原生 PHP 工具。

它為操作現(xiàn)有和新的日期對象提供了有用的幫助器：

// 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
}

該庫對于日期比較來說方便且強大，但很容易出現(xiàn)各種錯誤。

輕松本地化

Carbon 可以方便地處理語言環(huán)境：

$now = Carbon::now()->locale('fr_FR');
echo $now->monthName;

處理溢出

默認的 PHP DateTime 行為在添加或減去月份時可能會產生誤導。它可以溢出！

雖然您有時可能需要這種行為，但 Carbon 提供了更好的控制：

Carbon::useMonthsOverflow(false);
Carbon::resetMonthsOverflow();

您還可以在操作年或月時在每個方法中配置溢出（例如，subMonthsNoOverflow、addMonthsWithOverflow）。

單元測試日期

由于可變性，日期在單元測試中可能會出現(xiàn)問題。

Carbon 提供了先進的模擬功能，確保測試保持一致和可靠。

這可以防止隨機錯誤破壞 CI/CD 管道。

如何避免日期/時間的常見陷阱

無論您是否使用 Carbon，都有一些實用的方法可以減少潛在的錯誤和不一致：

不要消除錯誤

PHP 的最新版本引入了更好的日期/時間異常，使您能夠更一致地捕獲意外輸入。

但是，實現(xiàn)有時可以消除嚴重錯誤：

$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 創(chuàng)建后無法更改。大多數(shù)時候，您不需要改變初始日期。

如果代碼的其他部分依賴于該實例，則可能會引入嚴重的錯誤。

不可變格式可以防止此類副作用，并且通常更有利于可讀性和測試。

不要忽視時區(qū)

忽視時區(qū)是有風險的：

如果您未在應用中指定默認時區(qū)，則服務器將確定它。

但是，您的應用程序可能部署在不同時區(qū)的服務器上。

您可能還會遇到夏令時或存儲格式（例如，UTC 與當?shù)貢r間）等復雜問題，如果庫鼓勵良好實踐，這可能會減輕一些痛苦。

包起來

原生 API 允許對日期和時間進行高級操作，而 Carbon 則對其進行了精美的擴展。

PHP 開發(fā)人員可以利用這個附加層來簡化計算并提高可讀性。

無論您是否使用它，請確保您了解本機 PHP DateTime 對象的默認行為。

以上是PHP：逃離日期地獄的實用方法的詳細內容。更多信息請關注PHP中文網(wǎng)其他相關文章！