介绍
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</ |