laravel中Carbon包的使用详解

介绍

Carbon是对PHP DateTime模块的二次扩展；提供时间格式化，时间计算的功能；

• 官方主页为 http://carbon.nesbot.com/;

• Github地址为 https://github.com/briannesbitt/Carbon;

文件结构

目录	描述
-- src	Carbon源文件
-- src\Carbon	Carbon源文件
-- src\Carbon\CarbonInterval.php	DateInterval类的二次扩展类CarbonInterval；主要用于时差计算；
-- src\Carbon\Carbon.php	DateTime类的二次扩展类Carbon；提供时间计算，格式化输出的功能；
-- src\Carbon\Exceptions	自定义异常文件夹
-- src\Carbon\Lang	语言本地化文件夹；Carbon类的diffForHumans方法会用到；
-- tests	Carbon测试用例文件
-- tests\AbstractTestCase.php	所有测试文件的父类；提供了执行前初始化和执行后清理的功能, 及其它公共的API；
-- tests\Carbon	针对src\\Carbon\\Carbon.php的测试用例组
-- tests\CarbonInterval	针对src\\Carbon\\CarbonInterval.php的测试用例组
-- tests\Localization	针对src\\Carbon\\Lang的测试用例组

API 细则

本篇涉及 API 为 Carbon 1.22.1 版本；

Carbon

用途：生成Carbon实例

方法名	参数	描述
__construct	tz(null)	根据格式化时间字符串和指定时区, 创建Carbon实例
instance（static）	DateTime $dt	根据 DateTime实例创建Carbon实例
parse（static）	tz(null)	根据格式化时间字符串和指定时区, 创建Carbon实例
create（static）	month(null), hour(null), second(null), $tz(null)	根据日期和时间创建Carbon实例 如果指定参数为null，会默认使用当前时间的对应值
createSafe（static）	month(null), hour(null), second(null), $tz(null)	根据日期和时间创建Carbon实例 如果指定参数为null，会默认使用当前时间的对应值; 指定参数不符合规范，会返回异常；
createFromDate（static）	month(null), tz(null)	根据日期创建Carbon实例如果指定参数为null，会默认使用当前时间的对应值
createFromTime（static）	minute(null), tz(null)	根据时间创建Carbon实例如果指定参数为null，会默认使用当前时间的对应值
createFromFormat（static）	time, $tz（null）	根据时间字符串及其对应的format字符串创建Carbon实例
createFromTimestamp（static）	tz(null)	根据时间戳和指定时区, 创建Carbon实例
createFromTimestampUTC（static）	$timestamp	根据时间戳和utc时区, 创建Carbon实例
now（static）	$tx(null)	根据当前时间创建Carbon实例
today（static）	$tx(null)	根据当前时间创建Carbon实例，时间重置为 0时0分0秒
tomorrow（static）	$tx(null)	根据当前时间，加一天，创建Carbon实例
yesterday（static）	$tx(null)	根据当前时间， 减一天， 创建Carbon实例
minValue（static）	''	创建系统支持的最小时间，并返回Carbon实例
maxValue（static）	''	创建系统支持的最大时间，并返回Carbon实例
copy	''	复制当前Carbon实例
fromSerialized（static）	$value	解析序列化字符串，创建Carbon实例

用途：修改Carbon实例

方法名	参数	描述
setDate	$year, $month, $day	设置当前实例的年，月，日
setDateTime	$year, $month, $day, $hour, $minute, $second(0)	设置当前实例的年，月，日，时，分，秒
setTimeFromTimeString	$time	根据 H:i:s 字符串设置当前实例时间
timestamp	$value	根据时间戳设置当前实例时间
second	$value	设置当前实例时间指定秒
minute	$value</