//引入

use Carbon\Carbon;

//使用

　　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::tomorrow(‘Europe/London‘); // 2016-10-14 00:00:00

　　echo Carbon::yesterday(); // 2016-10-14 00:00:00

默認情況下，Carbon 的方法返回的為一個日期時間對象。雖然它是一個對象，但是你卻可以直接使用 echo 輸出結果，因為有 __toString 魔術方法。但是如果你想把它轉為字符串，可以使用 toDateString 或 toDateTimeString 方法：

　　echo Carbon::today()->toDateTimeString();

　　echo Carbon::yesterday()->toDateTimeString();

　　echo Carbon::tomorrow()->toDateTimeString();

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

1. echo Carbon::parse(‘2016-10-15‘)->toDateTimeString(); //2016-10-15 00:00:00
2. echo Carbon::parse(‘2016-10-15‘)->toDateTimeString(); //2016-10-15 00:00:00
3. echo Carbon::parse(‘2016-10-15 00:10:25‘)->toDateTimeString(); //2016-10-15 00:10:25
5. echo Carbon::parse(‘today‘)->toDateTimeString(); //2016-10-15 00:00:00
6. echo Carbon::parse(‘yesterday‘)->toDateTimeString(); //2016-10-14 00:00:00
7. echo Carbon::parse(‘tomorrow‘)->toDateTimeString(); //2016-10-16 00:00:00
8. echo Carbon::parse(‘2 days ago‘)->toDateTimeString(); //2016-10-13 20:49:53
9. echo Carbon::parse(‘+3 days‘)->toDateTimeString(); //2016-10-18 20:49:53
10. echo Carbon::parse(‘+2 weeks‘)->toDateTimeString(); //2016-10-29 20:49:53
11. echo Carbon::parse(‘+4 months‘)->toDateTimeString(); //2017-02-15 20:49:53
12. echo Carbon::parse(‘-1 year‘)->toDateTimeString(); //2015-10-15 20:49:53
13. echo Carbon::parse(‘next wednesday‘)->toDateTimeString(); //2016-10-19 00:00:00
14. echo Carbon::parse(‘last friday‘)->toDateTimeString(); //2016-10-14 00:00:00

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

1. $year = ‘2015‘;
2. $month = ‘04‘;
3. $day = ‘12‘;
5. echo Carbon::createFromDate($year, $month, $day); //2015-04-12 20:55:59
7. $hour = ‘02‘;
8. $minute = ‘15‘:
9. $second = ‘30‘;
11. echo Carbon::create($year, $month, $day, $hour, $minute, $second); //2015-04-12 02:15:30
13. echo Carbon::createFromDate(null, 12, 25); // 年默認為當前年份

日期操作可以通過 add （增加）或 sub （減去）跟上要增加或減去的單位來完成。例如，你想給一個日期增加指定的天數，你可以使用 addDays 方法。此外還提供了一個 modify 方法，參數格式為 + 或 - 跟上值及單位。所以，如果你想給當前日期增加一年，你可以傳遞 +1 year：

1. echo Carbon::now()->addDays(25); //2016-11-09 14:00:01
2. echo Carbon::now()->addWeeks(3); //2016-11-05 14:00:01
3. echo Carbon::now()->addHours(25); //2016-10-16 15:00:01
4. echo Carbon::now()->subHours(2); //2016-10-15 12:00:01
5. echo Carbon::now()->addHours(2)->addMinutes(12); //2016-10-15 16:12:01
6. echo Carbon::now()->modify(‘+15 days‘); //2016-10-30 14:00:01
7. echo Carbon::now()->modify(‘-2 days‘); //2016-10-13 14:00:01

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

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

1. echo Carbon::now()->tzName; // America/Toronto
2. $first = Carbon::create(2012, 9, 5, 23, 26, 11);
3. $second = Carbon::create(2012, 9, 5, 20, 26, 11, ‘America/Vancouver‘);
5. echo $first->toDateTimeString(); // 2012-09-05 23:26:11
6. echo $first->tzName; // America/Toronto
7. echo $second->toDateTimeString(); // 2012-09-05 20:26:11
8. echo $second->tzName; // America/Vancouver
10. var_dump($first->eq($second)); // bool(true)
11. var_dump($first->ne($second)); // bool(false)
12. var_dump($first->gt($second)); // bool(false)
13. var_dump($first->gte($second)); // bool(true)
14. var_dump($first->lt($second)); // bool(false)
15. var_dump($first->lte($second)); // bool(true)
17. $first->setDateTime(2012, 1, 1, 0, 0, 0);
18. $second->setDateTime(2012, 1, 1, 0, 0, 0); // Remember tz is ‘America/Vancouver‘
20. var_dump($first->eq($second)); // bool(false)
21. var_dump($first->ne($second)); // bool(true)
22. var_dump($first->gt($second)); // bool(false)
23. var_dump($first->gte($second)); // bool(false)
24. var_dump($first->lt($second)); // bool(true)
25. var_dump($first->lte($second)); // bool(true)

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

1. $first = Carbon::create(2012, 9, 5, 1);
2. $second = Carbon::create(2012, 9, 5, 5);
3. var_dump(Carbon::create(2012, 9, 5, 3)->between($first, $second)); // bool(true)
4. var_dump(Carbon::create(2012, 9, 5, 5)->between($first, $second)); // bool(true)
5. var_dump(Carbon::create(2012, 9, 5, 5)->between($first, $second, false)); // bool(false)

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

1. $dt = Carbon::now();
3. $dt->isWeekday();
4. $dt->isWeekend();
5. $dt->isYesterday();
6. $dt->isToday();
7. $dt->isTomorrow();
8. $dt->isFuture();
9. $dt->isPast();
10. $dt->isLeapYear();
11. $dt->isSameDay(Carbon::now());
12. $born = Carbon::createFromDate(1987, 4, 23);
13. $noCake = Carbon::createFromDate(2014, 9, 26);
14. $yesCake = Carbon::createFromDate(2014, 4, 23);
15. $overTheHill = Carbon::now()->subYears(50);
16. var_dump($born->isBirthday($noCake)); // bool(false)
17. var_dump($born->isBirthday($yesCake)); // bool(true)
18. var_dump($overTheHill->isBirthday()); // bool(true) -> default compare it to today!

diffForHumans

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

• 當比較的時間超過當前默認時間
  • 1天前
  • 5月前
• 當用將來的時間與當前默認時間比較
  • 1小時距現在
  • 5月距現在
• 當比較的值超過另一個值
  • 1小時前
  • 5月前
• 當比較的值在另一個值之後
  • 1小時後
  • 5月後

你可以把第二個參數設置為 true 來刪除“前”、“距現在”等修飾語：diffForHumans(Carbon $other, true)。

1. echo Carbon::now()->subDays(5)->diffForHumans(); // 5天前
3. echo Carbon::now()->diffForHumans(Carbon::now()->subYear()); // 1年後
5. $dt = Carbon::createFromDate(2011, 8, 1);
7. echo $dt->diffForHumans($dt->copy()->addMonth()); // 1月前
8. echo $dt->diffForHumans($dt->copy()->subMonth()); // 11月後
10. echo Carbon::now()->addSeconds(5)->diffForHumans(); // 5秒距現在
12. echo Carbon::now()->subDays(24)->diffForHumans(); // 3周前
13. echo Carbon::now()->subDays(24)->diffForHumans(null, true); // 3周

laravel 日期與實踐處理包 Carbon