Carbon：PHP 开发者的日期时间工具箱

Carbon：PHP 开发者的日期时间工具箱

PHP 原生的 DateTime 类用起来总有些别扭，日期计算、格式转换、多语言支持每一项都要手动处理。Carbon 就是为了解决这些问题而生的。

Carbon 是一个基于 PHP DateTime 的扩展库，目前在 GitHub 上获得了 16,616 个 Star。它在原生 DateTime 的基础上，提供了更简洁的 API 来完成日期的创建、解析、计算和格式化。

用 Composer 安装一行命令搞定：

composer require nesbot/carbon

安装完成后，代码里直接引入就能用。几个常见的使用场景：

useCarbon\Carbon;// 获取当前时间echoCarbon::now()->toDateTimeString();// 日期加减$tomorrow=Carbon::now()->addDay();$lastWeek=Carbon::now()->subWeek();// 计算年龄$age=Carbon::createFromDate(1975,5,21)->age;// 判断是否周末if(Carbon::now()->isWeekend()){echo'今天休息';}

API 的设计思路很清晰，方法名就是自然语言的表达，读代码和读句子差不多。

Carbon 内置了 200 多种语言的支持，包括 500 多种地区变体。一行代码就能切换显示语言：

echoCarbon::now()->subMinutes(2)->diffForHumans();// '2 minutes ago'echoCarbon::now()->subMinutes(2)->locale('zh_CN')->diffForHumans();// '2分钟前'echoCarbon::parse('2019-07-23 14:51')->isoFormat('LLLL');// 'Tuesday, July 23, 2019 2:51 PM'

对于需要国际化展示时间的项目，这个功能省去了大量手动翻译的工作。

测试方面，Carbon 提供了 setTestNow 方法来模拟固定时间点，方便单元测试中控制日期相关的逻辑：

Carbon::setTestNow(Carbon::createFromDate(2000,1,1));// 后续所有 Carbon::now() 都返回 2000-01-01// 测试完毕后恢复Carbon::setTestNow();

这个设计避免了测试中因为系统时间变化导致的不确定性。

日期差值计算也是常用功能，Carbon 支持天、小时、分钟等多个维度的精确计算：

$daysSinceEpoch=Carbon::createFromTimestamp(0)->diffInDays();

Carbon 目前正从 briannesbitt/Carbon 迁移到 CarbonPHP/carbon 仓库，代码在两个仓库保持同步更新，使用上没有影响。

项目文档完整，社区活跃，贡献者和翻译者都在持续维护。如果你的 PHP 项目里还在用原生 DateTime 手动拼日期逻辑，可以试试 Carbon。

档完整，社区活跃，贡献者和翻译者都在持续维护。如果你的 PHP 项目里还在用原生 DateTime 手动拼日期逻辑，可以试试 Carbon。