【PHP】如何利用 nesbot/carbon 處理日期和時間
文章摘要
PHP語言在處理日期和時間時，Carbon 套件是一個非常有用的工具。Carbon 套件繼承了原生的 Datetime，並新增了許多語意化的行為，讓處理時間的難度降低許多。在這篇教學中，將會介紹 Carbon 套件的基本使用方法，以及如何在 PHP 中使用 Carbon 套件來處理日期和時間。
安裝
使用 composer 安裝 carbon
composer require nesbot/carbon
簡易使用範例：
require 'vendor/autoload.php';
use Carbon\Carbon;
printf("Now: %s", Carbon::now());
日期格式化
format($value)：將日期時間進行格式化輸出，其中格式
取得與調整時間
now()：獲得當前的日期與時間today()：獲得當天的日期tomorrow()：獲取明天的日期yesterday()：：獲取昨天的日期addYear($value)/subYear($value)：將年份增加/減少$valueaddQuarter($value)/subQuarter($value)：將季度增加/減少$valueaddMonth($value)/subMonth($value)：將月份增加/減少$valueaddDay($value)/subDay($value)：將天數增加/減少$valueaddHour($value)/subHour($value)：將小時增加/減少$valueaddMinute($value)/subMinute($value)：將分鐘增加/減少$valueaddSecond($value)/subSecond($value)：將秒數增加/減少$value
範例
use Carbon\Carbon;
/**
* ：獲得當前的日期與時間
*/
echo Carbon::now();
//印出結果：2023-10-25 07:12:30
/**
* 獲得當天的日期
*/
echo Carbon::today()->format("Y-m-d");
//印出結果：2023-10-25
/**
* 獲取明天的日期
*/
echo Carbon::tomorrow()->format("Y-m-d");
//印出結果：2023-10-26
/**
* 獲取昨天的日期
*/
echo Carbon::yesterday()->format("Y-m-d");
//印出結果： 2023-10-24
/**
* 將年份增加/減少 `$value`
*/
echo Carbon::now()->addYear(1)->format("Y-m-d H:i:s");
echo " / ";
echo Carbon::now()->subYear(1)->format("Y-m-d H:i:s");
//印出結果： 2024-10-25 07:30:52 / 2022-10-25 07:30:52
/**
* 將季度增加/減少 `$value`
*/
echo Carbon::now()->addQuarter(1)->format("Y-m-d H:i:s");
echo " / ";
echo Carbon::now()->subQuarter(1)->format("Y-m-d H:i:s");
//印出結果：2024-01-25 07:31:57 / 2023-07-25 07:31:57
/**
* 將月份增加/減少 `$value`
*/
echo Carbon::now()->subMonth(1)->format("Y-m-d H:i:s");
echo " / ";
echo Carbon::now()->addMonth(1)->format("Y-m-d H:i:s");
//印出結果：2023-09-25 07:37:37 / 2023-11-25 07:37:37
/**
* 將天數增加/減少 `$value`
*/
echo Carbon::now()->subDay(1)->format("Y-m-d H:i:s");
echo " / ";
echo Carbon::now()->addDay(1)->format("Y-m-d H:i:s");
//印出結果：2023-10-24 07:38:45 / 2023-10-26 07:38:45
/**
* 將小時增加/減少 `$value`
*/
echo Carbon::now()->subHour(1)->format("Y-m-d H:i:s");
echo " / ";
echo Carbon::now()->addHour(1)->format("Y-m-d H:i:s");
//印出結果：2023-10-25 06:48:25 / 2023-10-25 08:48:25
/**
* 將秒數增加/減少 `$value`
*/
echo Carbon::now()->subSecond(1)->format("Y-m-d H:i:s");
echo " / ";
echo Carbon::now()->addSecond(1)->format("Y-m-d H:i:s");
//印出結果：2023-10-25 07:49:58 / 2023-10-25 07:50:00
比較時間
eq($datetime)：是否等於$datetime，回傳布林值ne($datetime)：是否不等於$datetime，回傳布林值gt($datetime)：是否大於$datetime，回傳布林值lt($datetime)：是否小於$datetime，回傳布林值between($startTime, $endTime)：是否介於$startTime、$endTime之間，回傳布林值
範例
use Carbon\Carbon;
/**
* 比較兩個時間，是否相等
*/
var_dump(Carbon::today()->eq(Carbon::today()));
//印出結果：bool(true)
var_dump(Carbon::today()->eq(Carbon::now()));
//印出結果：bool(false)
/**
* 比較兩個時間，是否不相等
*/
var_dump(Carbon::today()->ne(Carbon::today()));
//印出結果：bool(false)
var_dump(Carbon::today()->ne(Carbon::tomorrow()));
//印出結果：bool(true)
/**
* 比較兩個時間，是否大於
*/
var_dump(Carbon::tomorrow()->gt(Carbon::now()));
//印出結果：bool(true)
var_dump(Carbon::now()->gt(Carbon::tomorrow()));
//印出結果：bool(false)
/**
* 比較兩個時間，是否小於
*/
var_dump(Carbon::now()->lt(Carbon::tomorrow()));
//印出結果：bool(true)
var_dump(Carbon::tomorrow()->lt(Carbon::now()));
//印出結果：bool(false)
/**
* 是否介於 `$startTime`、`$endTime` 之間
*/
var_dump(Carbon::now()->between(Carbon::yesterday(), Carbon::tomorrow()));
// 印出結果：bool(true)
var_dump(Carbon::now()->addDay(2)->between(Carbon::yesterday(), Carbon::tomorrow()));
// 印出結果：bool(false)
X