# Carbon（nesbot/carbon）-- PHP 日期时间利器化

Tue, 15 Nov 2022 00:00:00 +0000

Carbon（nesbot/carbon）– PHP 日期时间利器化

一、Carbon介绍

Carbon 是 PHP 中最流行的日期时间处理库，基于 PHP 原生的 DateTime 类封装，提供链式操作、易读 API、时区支持等强大功能。

特点：

链式调用，语义化强
支持日期时间加减、比较、格式化
支持中文等多语言友好显示
可与 Laravel、Hyperf 等框架无缝集成

官方文档：https://carbon.nesbot.com/docs/

安装：composer require nesbot/carbon

二、基本使用

2.1 获取当前时间

1$now = Carbon::now(); // 当前时间，默认系统时区
2echo $now; // 2023-09-28 15:30:12
3
4// 指定时区：
5$nowShanghai = Carbon::now('Asia/Shanghai');

2.2 日期创建

1$dt1 = Carbon::create(2023, 9, 28, 15, 30, 0); // 年, 月, 日, 时, 分, 秒
2$dt2 = Carbon::parse('2023-12-31 23:59:59');
3$dt3 = Carbon::today(); // 当天 0:00:00
4$dt4 = Carbon::tomorrow(); // 明天 0:00:00
5$dt5 = Carbon::yesterday(); // 昨天 0:00:00

2.3 日期格式化

1$now = Carbon::now();
2echo $now->toDateString(); // 2023-09-28
3echo $now->toTimeString(); // 15:30:12
4echo $now->toDateTimeString();// 2023-09-28 15:30:12
5echo $now->format('Y-m-d H:i'); // 自定义格式

2.4 日期加减操作

1$dt = Carbon::now();
2
3echo $dt->addDays(3); // 当前时间 +3天
4echo $dt->subHours(5); // 当前时间 -5小时
5echo $dt->addMonthsNoOverflow(1); // 避免月份溢出

2.5 日期比较

1$dt1 = Carbon::parse('2023-09-28');
2$dt2 = Carbon::parse('2023-10-01');
3
4if ($dt1->lt($dt2)) {
5 echo "dt1 小于 dt2";
6}
7
8echo $dt1->diffInDays($dt2); // 返回天数差
9echo $dt1->diffForHumans($dt2); // 语义化描述: "3 days before"

2.6 时区转换

1$dt = Carbon::now('UTC');
2$dtShanghai = $dt->copy()->setTimezone('Asia/Shanghai');
3echo $dtShanghai;

2.7 本地化输出

1Carbon::setLocale('zh'); // 设置中文
2
3$dt1 = Carbon::now();
4$dt2 = Carbon::parse('2025-10-01');
5
6echo $dt1->diffForHumans($dt2); // 输出: 3 天前 / 3 天后

2.8 链式操作

1$dt = Carbon::now()->addDays(5)->subHours(3)->format('Y-m-d H:i:s');
2echo $dt;

三、Carbon 高级使用技巧合集

3.1 时间区间判断

判断某个时间是否在区间内

1use Carbon\Carbon;
2
3$start = Carbon::parse('2023-09-01');
4$end = Carbon::parse('2023-09-30');
5$check = Carbon::parse('2023-09-15');
6
7if ($check->between($start, $end)) {
8 echo "时间在区间内";
9}

between($start, $end, $equal = true)

Carbon on Leanku 的博客