前言
我們大家在編寫 PHP 應用時經常需要處理日期和時間,這篇文章帶你了解一下 Carbon – 繼承自 PHP DateTime 類的 API 擴展,它使得處理日期和時間更加簡單。
Laravel 中默認使用的時間處理類就是 Carbon。
<?php namespace Carbon; class Carbon extends \DateTime { // code here }
你可以在 Carbon 命名空間的 Carbon 類中看到上面聲明的代碼片段。
安裝
可以通過 Composer 來安裝 Carbon:
composer require nesbot/carbon
PS:由于 Laravel 項目已默認安裝了此包,所以不需要再次執行上面的命令。
使用
你需要通過命名空間導入 Carbon 來使用,而不需每次都提供完整的名稱。
use Carbon\Carbon;
獲取當前時間
可以同 now() 方法獲取當前的日期和時間。如果你不指定參數,它會使用 PHP 配置中的時區:
<?php echo Carbon::now(); //2016-10-14 20:21:20 ?>
如果你想使用一個不同的時區,你需要傳遞一個有效的時區作為參數:
// 直接使用字符串 echo Carbon::now('Europe/London'); //2016-10-14 20:21:20 // 或者 echo Carbon::now(new DateTimeZone('Europe/London'));
除 now()
外,還提供了 today()
、tomorrow()
、yesterday()
等靜態函數,不過,它們的時間都是 00:00:00 :
echo Carbon::now(); // 2016-10-14 15:18:34 echo Carbon::today(); // 2016-10-14 00:00:00 echo Carbon::tomorrow('Europe/London'); // 2016-10-14 00:00:00 echo Carbon::yesterday(); // 2016-10-14 00:00:00
以上輸出結果其實是一個 Carbon 類型的日期時間對象:
Carbon {#179 ▼ +"date": "2016-06-14 00:00:00.000000" +"timezone_type": 3 +"timezone": "UTC" }
要想獲取字符串類型的日期,可以使用下面的代碼:
echo Carbon::today()->toDateTimeString(); echo Carbon::yesterday()->toDateTimeString(); echo Carbon::tomorrow()->toDateTimeString();
日期類型轉為字符串
如上所述,默認情況下,Carbon 的方法返回的為一個日期時間對象。雖然它是一個對象,但是你卻可以直接使用 echo 輸出結果,因為有 __toString 魔術方法。但是如果你想把它轉為字符串,可以使用 toDateString 或 toDateTimeString 方法:
echo Carbon::now()->toDateString(); //2016-10-14 echo Carbon::now()->toDateTimeString(); //2016-10-14 20:22:50
日期解析
你還可以使用 parse 方法解析任何順序和類型的日期(結果為 Carbon 類型的日期時間對象):
echo Carbon::parse('2016-10-15')->toDateTimeString(); //2016-10-15 00:00:00 echo Carbon::parse('2016-10-15')->toDateTimeString(); //2016-10-15 00:00:00 echo Carbon::parse('2016-10-15 00:10:25')->toDateTimeString(); //2016-10-15 00:10:25 echo Carbon::parse('today')->toDateTimeString(); //2016-10-15 00:00:00 echo Carbon::parse('yesterday')->toDateTimeString(); //2016-10-14 00:00:00 echo Carbon::parse('tomorrow')->toDateTimeString(); //2016-10-16 00:00:00 echo Carbon::parse('2 days ago')->toDateTimeString(); //2016-10-13 20:49:53 echo Carbon::parse('+3 days')->toDateTimeString(); //2016-10-18 20:49:53 echo Carbon::parse('+2 weeks')->toDateTimeString(); //2016-10-29 20:49:53 echo Carbon::parse('+4 months')->toDateTimeString(); //2017-02-15 20:49:53 echo Carbon::parse('-1 year')->toDateTimeString(); //2015-10-15 20:49:53 echo Carbon::parse('next wednesday')->toDateTimeString(); //2016-10-19 00:00:00 echo Carbon::parse('last friday')->toDateTimeString(); //2016-10-14 00:00:00
構造日期
你還可以使用單獨的年月日來構造日期:
$year = '2015'; $month = '04'; $day = '12'; echo Carbon::createFromDate($year, $month, $day); //2015-04-12 20:55:59 $hour = '02'; $minute = '15': $second = '30'; echo Carbon::create($year, $month, $day, $hour, $minute, $second); //2015-04-12 02:15:30 echo Carbon::createFromDate(null, 12, 25); // 年默認為當前年份
此外,還可以傳遞一個有效的時區作為最后一個參數。
日期操作
【網站聲明】本站除付費源碼經過測試外,其他素材未做測試,不保證完整性,網站上部分源碼僅限學習交流,請勿用于商業用途。如損害你的權益請聯系客服QQ:2655101040 給予處理,謝謝支持。