PHP：逃離日期地獄的實用方法-php教程-PHP中文網

PHP：逃離日期地獄的實用方法

DDD

發布： 2024-11-30 09:14:19

原創

249 人瀏覽過

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

身為 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');

登入後複製