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

身為 PHP 程式設(shè)計(jì)師，您可能需要操作日期/時(shí)間。

開(kāi)始使用第三方函式庫(kù)？真的嗎？

雖然堅(jiān)持使用本機(jī) API 來(lái)掌握技能並了解語(yǔ)言的工作原理通常是一個(gè)很好的做法，但讓我們務(wù)實(shí)一些。

Carbon 是一個(gè)功能強(qiáng)大的函式庫(kù)，它擴(kuò)充了 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');

回到基礎(chǔ)

Carbon 擴(kuò)充了原生 API，但 DateTime 物件已經(jīng)提供了計(jì)算日期和時(shí)間的工具：

$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');

您可以傳遞字串來(lái)取得特定輸出或計(jì)算間隔和週期。

那麼，為什麼要使用碳等附加層呢？

更好的可讀性

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

該函式庫(kù)對(duì)於日期比較來(lái)說(shuō)方便且強(qiáng)大，但很容易出現(xiàn)各種錯(cuò)誤。

輕鬆本地化

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

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

處理溢出

預(yù)設(shè)的 PHP DateTime 行為在添加或減去月份時(shí)可能會(huì)產(chǎn)生誤導(dǎo)。它可以溢出！

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

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

您也可以在操作年或月時(shí)在每個(gè)方法中配置溢出（例如，subMonthsNoOverflow、addMonthsWithOverflow）。

單元測(cè)試日期

由於可變性，日期在單元測(cè)試中可能會(huì)出現(xiàn)問(wèn)題。

Carbon 提供了先進(jìn)的模擬功能，確保測(cè)試保持一致且可靠。

這可以防止隨機(jī)錯(cuò)誤破壞 CI/CD 管道。

如何避免日期/時(shí)間的常見(jiàn)陷阱

無(wú)論您是否使用 Carbon，都有一些實(shí)用的方法可以減少潛在的錯(cuò)誤和不一致：

不要消除錯(cuò)誤

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

但是，實(shí)現(xiàn)有時(shí)可以消除嚴(yán)重錯(cuò)誤：

$dateInput = '2dsds';
$timestamp = strtotime($dateInput);
echo date('Y-m-d', $timestamp); // Defaults back to 1970-01-01

以下程式碼並不是改進(jìn)，即使它使用 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"

所以，總是驗(yàn)證日期/時(shí)間：

$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 建立後無(wú)法變更。大多數(shù)時(shí)候，您不需要更改初始日期。

如果程式碼的其他部分依賴該實(shí)例，則可能會(huì)引入嚴(yán)重的錯(cuò)誤。

不可變格式可以防止此類副作用，並且通常更有利於可讀性和測(cè)試。

不要忽視時(shí)區(qū)

忽略時(shí)區(qū)是有風(fēng)險(xiǎn)的：

如果您未在應(yīng)用程式中指定預(yù)設(shè)時(shí)區(qū)，則伺服器將確定它。

但是，您的應(yīng)用程式可能部署在不同時(shí)區(qū)的伺服器上。

您可能還會(huì)遇到夏令時(shí)或儲(chǔ)存格式（例如，UTC 與當(dāng)?shù)貢r(shí)間）等複雜問(wèn)題，如果程式庫(kù)鼓勵(lì)良好實(shí)踐，這可能會(huì)減輕一些痛苦。

包起來(lái)

原生 API 允許對(duì)日期和時(shí)間進(jìn)行高級(jí)操作，而 Carbon 則對(duì)其進(jìn)行了精美的擴(kuò)展。

PHP 開(kāi)發(fā)人員可以利用這個(gè)附加層來(lái)簡(jiǎn)化計(jì)算並提高可讀性。

無(wú)論您是否使用它，請(qǐng)確保您了解本機(jī) PHP DateTime 物件的預(yù)設(shè)行為。

以上是PHP：逃離日期地獄的實(shí)用方法的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！