日期及時間處理包 Carbon 在 Laravel 中的簡單使用

在編寫 PHP 應用時常常須要處理日期和時間，這篇文章帶你瞭解一下 Carbon – 繼承自 PHP DateTime 類的 API 擴展，它使得處理日期和時間更加簡單。Laravel 中默認使用的時間處理類就是 Carbon。

1 安裝

經過 Composer 來安裝 Carbon：

PS：因爲 Laravel 項目已默認安裝了此包，因此不須要再次執行上面的命令。

2 使用

你須要經過命名空間導入 Carbon 來使用，而不需每次都提供完整的名稱。

2.1 獲取當前時間

能夠同now() 方法獲取當前的日期和時間。若是你不指定參數，它會使用 PHP 配置中的時區：

若是你想使用一個不一樣的時區，你須要傳遞一個有效的時區做爲參數：
除 now()外，還提供了today()、tomorrow()、yesterday()等靜態函數，不過，它們的時間都是 00:00:00：

以上輸出結果實際上是一個 Carbon 類型的日期時間對象：

要想獲取字符串類型的日期，可使用下面的代碼：

2.2 日期類型轉爲字符串

如上所述，默認狀況下，Carbon 的方法返回的爲一個日期時間對象。雖然它是一個對象，可是你卻能夠直接使用 echo 輸出結果，由於有 __toString魔術方法。可是若是你想把它轉爲字符串，可使用 toDateString 或 toDateTimeString方法：

2.3 日期解析

你還可使用 parse方法解析任何順序和類型的日期（結果爲 Carbon 類型的日期時間對象）：

2.4 構造日期

你還可使用單獨的年月日來構造日期：

此外，還能夠傳遞一個有效的時區做爲最後一個參數。

2.5 日期操做

日期操做能夠經過 add（增長）或 sub（減去）跟上要增長或減去的單位來完成。例如，你想給一個日期增長指定的天數，你可使用 addDays方法。此外還提供了一個modify方法，參數格式爲 +或 - 跟上值及單位。因此，若是你想給當前日期增長一年，你能夠傳遞+1 year：

2.6 日期比較

在 Carbon中你可使用下面的方法來比較日期：

• min –返回最小日期。
• max – 返回最大日期。
• eq – 判斷兩個日期是否相等。
• gt – 判斷第一個日期是否比第二個日期大。
• lt – 判斷第一個日期是否比第二個日期小。
• gte – 判斷第一個日期是否大於等於第二個日期。
• lte – 判斷第一個日期是否小於等於第二個日期。

要判斷一個日期是否介於兩個日期之間，可使用 between() 方法，第三個可選參數指定比較是否能夠相等，默認爲true：

此外還提供了一些輔助方法，你能夠從它們的名字中明白其含義：

2.7 diffForHumans

「一個月前」比「30 天前」更便於閱讀，不少日期庫都提供了這個常見的功能，日期被解析後，有下面四種可能性：

• 當比較的時間超過當前默認時間
  • 1天前
  • 5月前
• 當用未來的時間與當前默認時間比較
  • 1小時距如今
  • 5月距如今
• 當比較的值超過另外一個值
  • 1小時前
  • 5月前
• 當比較的值在另外一個值以後
  • 1小時後
  • 5月後

你能夠把第二個參數設置爲 true 來刪除「前」、「距如今」等修飾語：diffForHumans(Carbon $other, true)。

2.8 本地化

翻譯成中文，參考上一篇文章