摘要:介紹是對(duì)模塊的二次擴(kuò)展提供時(shí)間格式化,時(shí)間計(jì)算的功能官方主頁(yè)為地址為文件結(jié)構(gòu)目錄描述源文件源文件類(lèi)的二次擴(kuò)展類(lèi)主要用于時(shí)差計(jì)算類(lèi)的二次擴(kuò)展類(lèi)提供時(shí)間計(jì)算,格式化輸出的功能自定義異常文件夾語(yǔ)言本地化文件夾類(lèi)的方法會(huì)用到
介紹
Carbon是對(duì)PHP DateTime模塊的二次擴(kuò)展;提供時(shí)間格式化,時(shí)間計(jì)算的功能;
官方主頁(yè)為 http://carbon.nesbot.com/;
Github地址為 https://github.com/briannesbitt/Carbon;
文件結(jié)構(gòu)目錄 | 描述 |
---|---|
-- src | Carbon源文件 |
-- srcCarbon | Carbon源文件 |
-- srcCarbonCarbonInterval.php | DateInterval類(lèi)的二次擴(kuò)展類(lèi)CarbonInterval;主要用于時(shí)差計(jì)算; |
-- srcCarbonCarbon.php | DateTime類(lèi)的二次擴(kuò)展類(lèi)Carbon;提供時(shí)間計(jì)算,格式化輸出的功能; |
-- srcCarbonExceptions | 自定義異常文件夾 |
-- srcCarbonLang | 語(yǔ)言本地化文件夾;Carbon類(lèi)的diffForHumans方法會(huì)用到; |
-- tests | Carbon測(cè)試用例文件 |
-- testsAbstractTestCase.php | 所有測(cè)試文件的父類(lèi);提供了執(zhí)行前初始化和執(zhí)行后清理的功能, 及其它公共的API; |
-- testsCarbon | 針對(duì)srcCarbonCarbon.php的測(cè)試用例組 |
-- testsCarbonInterval | 針對(duì)srcCarbonCarbonInterval.php的測(cè)試用例組 |
-- testsLocalization | 針對(duì)srcCarbonLang的測(cè)試用例組 |
本篇涉及 API 為 Carbon 1.22.1 版本;
Carbon 用途:生成Carbon實(shí)例方法名 | 參數(shù) | 描述 |
---|---|---|
__construct | $time(null), $tz(null) | 根據(jù)格式化時(shí)間字符串和指定時(shí)區(qū), 創(chuàng)建Carbon實(shí)例 |
instance(static) | DateTime $dt | 根據(jù) DateTime實(shí)例創(chuàng)建Carbon實(shí)例 |
parse(static) | $time(null), $tz(null) | 根據(jù)格式化時(shí)間字符串和指定時(shí)區(qū), 創(chuàng)建Carbon實(shí)例 |
create(static) | $year(null), $month(null), $day(null), $hour(null), $minute(null), $second(null), $tz(null) | 根據(jù)日期和時(shí)間創(chuàng)建Carbon實(shí)例 如果指定參數(shù)為null,會(huì)默認(rèn)使用當(dāng)前時(shí)間的對(duì)應(yīng)值 |
createSafe(static) | $year(null), $month(null), $day(null), $hour(null), $minute(null), $second(null), $tz(null) | 根據(jù)日期和時(shí)間創(chuàng)建Carbon實(shí)例 如果指定參數(shù)為null,會(huì)默認(rèn)使用當(dāng)前時(shí)間的對(duì)應(yīng)值; 指定參數(shù)不符合規(guī)范,會(huì)返回異常; |
createFromDate(static) | $year(null), $month(null), $day(null), $tz(null) | 根據(jù)日期創(chuàng)建Carbon實(shí)例如果指定參數(shù)為null,會(huì)默認(rèn)使用當(dāng)前時(shí)間的對(duì)應(yīng)值 |
createFromTime(static) | $hour(null), $minute(null), $minute(null), $tz(null) | 根據(jù)時(shí)間創(chuàng)建Carbon實(shí)例如果指定參數(shù)為null,會(huì)默認(rèn)使用當(dāng)前時(shí)間的對(duì)應(yīng)值 |
createFromFormat(static) | $format, $time, $tz(null) | 根據(jù)時(shí)間字符串及其對(duì)應(yīng)的format字符串創(chuàng)建Carbon實(shí)例 |
createFromTimestamp(static) | $timestamp, $tz(null) | 根據(jù)時(shí)間戳和指定時(shí)區(qū), 創(chuàng)建Carbon實(shí)例 |
createFromTimestampUTC(static) | $timestamp | 根據(jù)時(shí)間戳和utc時(shí)區(qū), 創(chuàng)建Carbon實(shí)例 |
now(static) | $tx(null) | 根據(jù)當(dāng)前時(shí)間創(chuàng)建Carbon實(shí)例 |
today(static) | $tx(null) | 根據(jù)當(dāng)前時(shí)間創(chuàng)建Carbon實(shí)例,時(shí)間重置為 0時(shí)0分0秒 |
tomorrow(static) | $tx(null) | 根據(jù)當(dāng)前時(shí)間,加一天,創(chuàng)建Carbon實(shí)例 |
yesterday(static) | $tx(null) | 根據(jù)當(dāng)前時(shí)間, 減一天, 創(chuàng)建Carbon實(shí)例 |
minValue(static) | "" | 創(chuàng)建系統(tǒng)支持的最小時(shí)間,并返回Carbon實(shí)例 |
maxValue(static) | "" | 創(chuàng)建系統(tǒng)支持的最大時(shí)間,并返回Carbon實(shí)例 |
copy | "" | 復(fù)制當(dāng)前Carbon實(shí)例 |
fromSerialized(static) | $value | 解析序列化字符串,創(chuàng)建Carbon實(shí)例 |
方法名 | 參數(shù) | 描述 |
---|---|---|
setDate | $year, $month, $day | 設(shè)置當(dāng)前實(shí)例的年,月,日 |
setDateTime | $year, $month, $day, $hour, $minute, $second(0) | 設(shè)置當(dāng)前實(shí)例的年,月,日,時(shí),分,秒 |
setTimeFromTimeString | $time | 根據(jù) H:i:s 字符串設(shè)置當(dāng)前實(shí)例時(shí)間 |
timestamp | $value | 根據(jù)時(shí)間戳設(shè)置當(dāng)前實(shí)例時(shí)間 |
second | $value | 設(shè)置當(dāng)前實(shí)例時(shí)間指定秒 |
minute | $value | 設(shè)置當(dāng)前實(shí)例時(shí)間指定分鐘 |
hour | $value | 設(shè)置當(dāng)前實(shí)例時(shí)間指定小時(shí) |
day | $value | 設(shè)置當(dāng)前實(shí)例時(shí)間指定天 |
month | $value | 設(shè)置當(dāng)前實(shí)例時(shí)間指月份 |
year | $value | 設(shè)置當(dāng)前實(shí)例時(shí)間指定年份 |
startOfDay | "" | 重置當(dāng)前實(shí)例時(shí)間為 0時(shí)0分0秒 |
endOfDay | "" | 重置當(dāng)前實(shí)例時(shí)間為 23時(shí)59分59秒 |
startOfWeek | "" | 重置當(dāng)前實(shí)例時(shí)間為 本周的第一天,同時(shí)設(shè)置 0時(shí)0分0秒 |
endOfWeek | "" | 重置當(dāng)前實(shí)例時(shí)間為 本周的最后一天,同時(shí)設(shè)置 23時(shí)59分59秒 |
startOfMonth | "" | 重置當(dāng)前實(shí)例時(shí)間為 本月第一天,同時(shí)設(shè)置 0時(shí)0分0秒 |
endOfMonth | "" | 重置當(dāng)前實(shí)例時(shí)間為 本月最后一天,同時(shí)設(shè)置 23時(shí)59分59秒 |
startOfQuarter | "" | 重置當(dāng)前實(shí)例時(shí)間為 本季度第一天,同時(shí)設(shè)置 0時(shí)0分0秒 |
endOfQuarter | "" | 重置當(dāng)前實(shí)例時(shí)間為 本季度最后一天,同時(shí)設(shè)置 23時(shí)59分59秒 |
startOfYear | "" | 重置當(dāng)前實(shí)例時(shí)間為 本年第一天,同時(shí)設(shè)置 0時(shí)0分0秒 |
endOfYear | "" | 重置當(dāng)前實(shí)例時(shí)間為 本年最后一天,同時(shí)設(shè)置 23時(shí)59分59秒 |
startOfDecade | "" | 重置當(dāng)前實(shí)例時(shí)間為 所在十年的第一天,同時(shí)設(shè)置 0時(shí)0分0秒 |
endOfDecade | "" | 重置當(dāng)前實(shí)例時(shí)間為 所在十年的最后一天,同時(shí)設(shè)置 23時(shí)59分59秒 |
startOfCentury | "" | 重置當(dāng)前實(shí)例時(shí)間為 本世紀(jì)的第一天,同時(shí)設(shè)置 0時(shí)0分0秒 |
endOfCentury | "" | 重置當(dāng)前實(shí)例時(shí)間為 本世紀(jì)的最后一天,同時(shí)設(shè)置 23時(shí)59分59秒 |
next | $dayOfWeek(null) | 重置當(dāng)前實(shí)例時(shí)間為 下一個(gè)指定dayOfWeek,同時(shí)設(shè)置 0時(shí)0分0秒 |
previous | $dayOfWeek(null) | 重置當(dāng)前實(shí)例時(shí)間為 上一個(gè)指定dayOfWeek,同時(shí)設(shè)置 0時(shí)0分0秒 |
nextWeekday | "" | 重置當(dāng)前實(shí)例時(shí)間為 下一個(gè)工作日,同時(shí)設(shè)置 0時(shí)0分0秒 |
previousWeekday | "" | 重置當(dāng)前實(shí)例時(shí)間為 上一個(gè)工作日,同時(shí)設(shè)置 0時(shí)0分0秒 |
nextWeekendDay | "" | 重置當(dāng)前實(shí)例時(shí)間為 下一個(gè)雙休日,同時(shí)設(shè)置 0時(shí)0分0秒 |
previousWeekendDay | "" | 重置當(dāng)前實(shí)例時(shí)間為 上一個(gè)雙休日,同時(shí)設(shè)置 0時(shí)0分0秒 |
firstOfMonth | $dayOfWeek(null) | 重置當(dāng)前實(shí)例時(shí)間為 本月第一周的指定dayOfWeek,同時(shí)設(shè)置 0時(shí)0分0秒 |
nthOfMonth | $nth, $dayOfWeek | 重置當(dāng)前實(shí)例時(shí)間為 本月第n周的指定dayOfWeek,同時(shí)設(shè)置 0時(shí)0分0秒 |
lastOfMonth | $dayOfWeek(null) | 重置當(dāng)前實(shí)例時(shí)間為 本月最后一周的指定dayOfWeek,同時(shí)設(shè)置 0時(shí)0分0秒 |
firstOfQuarter | $dayOfWeek(null) | 重置當(dāng)前實(shí)例時(shí)間為 當(dāng)前季度第一周的指定dayOfWeek,同時(shí)設(shè)置 0時(shí)0分0秒 |
nthOfQuarter | $nth, $dayOfWeek | 重置當(dāng)前實(shí)例時(shí)間為 當(dāng)前季度第n周的指定dayOfWeek,同時(shí)設(shè)置 0時(shí)0分0秒 |
lastOfQuarter | $dayOfWeek(null) | 重置當(dāng)前實(shí)例時(shí)間為 當(dāng)前季度最后一周的指定dayOfWeek,同時(shí)設(shè)置 0時(shí)0分0秒 |
firstOfYear | $dayOfWeek(null) | 重置當(dāng)前實(shí)例時(shí)間為 本年第一周的指定dayOfWeek,同時(shí)設(shè)置 0時(shí)0分0秒 |
nthOfYear | $nth, $dayOfWeek | 重置當(dāng)前實(shí)例時(shí)間為 本年第n周的指定dayOfWeek,同時(shí)設(shè)置 0時(shí)0分0秒 |
lastOfYear | $dayOfWeek(null) | 重置當(dāng)前實(shí)例時(shí)間為 本年最后一周的指定dayOfWeek,同時(shí)設(shè)置 0時(shí)0分0秒 |
average | Carbon $dt | 重置當(dāng)前實(shí)例時(shí)間為 與指定Carbon對(duì)象的中間時(shí)刻 |
modify | $modify | 按modify字符串重置當(dāng)前實(shí)例時(shí)間 |
方法名 | 參數(shù) | 描述 |
---|---|---|
__toString | "" | 按變量$toStringFormat的格式輸出 |
toDateString | "" | 日期格式化輸出 |
toTimeString | "" | 時(shí)間格式化輸出 |
toDateTimeString | "" | 日期時(shí)間格式化輸出 |
toDayDateTimeString | "" | 格式化輸出如 "Fri, Jan 3, 2013 10:50 PM" |
toAtomString | "" | 格式化輸出如 "2012-10-20T14:12:26+00:00" |
toCookieString | "" | 格式化輸出如 "Friday, 02-Jan-2012 14:20:39 UTC" |
toIso8601String | "" | 同 toAtomString |
toRfc822String | "" | 格式化輸出如 "Mon, 15 Aug 05 15:52:01 +0000" |
toRfc850String | "" | 格式化輸出如 "Monday, 15-Aug-05 15:52:01 UTC" |
toRfc1036String | "" | 格式化輸出如 "2005-08-15T15:52:01+0000" |
toRfc1123String | "" | 格式化輸出如 "Mon, 15 Aug 2005 15:52:01 +0000" |
toRfc2822String | "" | 格式化輸出如 "Mon, 15 Aug 05 15:52:01 +0000" |
toRfc3339String | "" | 同 toAtomString |
toRssString | "" | 格式化輸出如 "Mon, 15 Aug 2005 15:52:01 +0000" |
toW3cString | "" | 格式化輸出如 "2005-08-15T15:52:01+00:00" |
toFormattedDateString | "" | 格式化輸出如 "Jan 11, 1999" |
formatLocalized | $format | 指定格式本地化輸出 |
方法名 | 參數(shù) | 描述 |
---|---|---|
eq | Carbon $dt | 判斷當(dāng)前Carbon實(shí)例與指定Carbon對(duì)象時(shí)間是否一樣 |
equalTo | Carbon $dt | 同 eq 方法 |
ne | Carbon $dt | 判斷當(dāng)前Carbon實(shí)例與指定Carbon對(duì)象時(shí)間是否不相同 |
notEqualTo | Carbon $dt | 同 ne 方法 |
gt | Carbon $dt | 判斷當(dāng)前Carbon實(shí)例是否大于指定Carbon對(duì)象時(shí)間 |
greaterThan | Carbon $dt | 同 gt 方法 |
gte | Carbon $dt | 判斷當(dāng)前Carbon實(shí)例是否大于等于指定Carbon對(duì)象時(shí)間 |
greaterThanOrEqualTo | Carbon $dt | 同 gte 方法 |
lt | Carbon $dt | 判斷當(dāng)前Carbon實(shí)例是否小于指定Carbon對(duì)象時(shí)間 |
lessThan | Carbon $dt | 同 lt 方法 |
lte | Carbon $dt | 判斷當(dāng)前Carbon實(shí)例是否小于等于指定Carbon對(duì)象時(shí)間 |
lessThanOrEqualTo | Carbon $dt | 同 lte 方法 |
between | Carbon $dt1, Carbon $dt2, $equal(true) | 判斷當(dāng)前Carbon實(shí)例是否在指定Carbon對(duì)象時(shí)間之間, 第三個(gè)參數(shù)表示是否可以等于指定Carbon對(duì)象 |
min | Carbon $dt | 獲取當(dāng)前實(shí)例與指定Carbon對(duì)象中,最小的對(duì)象 |
minimum | Carbon $dt | 同min |
max | Carbon $dt | 獲取當(dāng)前實(shí)例與指定Carbon對(duì)象中,最大的對(duì)象 |
maximum | Carbon $dt | 同max |
closest | Carbon $dt1, Carbon $dt2 | 獲取最接近當(dāng)前實(shí)例時(shí)間的Carbon對(duì)象 |
farthest | Carbon $dt1, Carbon $dt2 | 獲取最不接近當(dāng)前實(shí)例時(shí)間的Carbon對(duì)象 |
isSameAs | $format, Carbon $dt | 判斷當(dāng)前實(shí)例與指定Carbon對(duì)象的format格式化結(jié)果是否相同 |
isSameDay | Carbon $dt | 判斷當(dāng)前實(shí)例與指定Carbon對(duì)象是否是同一天 |
isSameMonth | Carbon $dt(null), $ofSameYear(false) | 判斷當(dāng)前實(shí)例與指定Carbon對(duì)象月份是否相同 |
isBirthday | Carbon $dt | 判斷當(dāng)前實(shí)例與指定Carbon對(duì)象月日數(shù)是否相同 |
isSameYear | Carbon $dt | 判斷當(dāng)前實(shí)例與指定Carbon對(duì)象年份是否相同 |
isSunday | "" | 判斷當(dāng)前實(shí)例是否是周日 |
isMonday | "" | 判斷當(dāng)前實(shí)例是否是周一 |
isTuesday | "" | 判斷當(dāng)前實(shí)例是否是周二 |
isWednesday | "" | 判斷當(dāng)前實(shí)例是否是周三 |
isThursday | "" | 判斷當(dāng)前實(shí)例是否是周四 |
isFriday | "" | 判斷當(dāng)前實(shí)例是否是周五 |
isSaturday | "" | 判斷當(dāng)前實(shí)例是否是周六 |
isYesterday | "" | 判斷當(dāng)前實(shí)例是否是昨天 |
isToday | "" | 判斷當(dāng)前實(shí)例是否是今天 |
isTomorrow | "" | 判斷當(dāng)前實(shí)例是否是明天 |
isWeekday | "" | 判斷當(dāng)前實(shí)例是否屬于工作日 |
isWeekend | "" | 判斷當(dāng)前實(shí)例是否屬于周末雙休 |
isLastWeek | "" | 判斷當(dāng)前實(shí)例是否屬于上周 |
isNextWeek | "" | 判斷當(dāng)前實(shí)例是否屬于下一周 |
isLastMonth | "" | 判斷當(dāng)前實(shí)例是否屬于上一個(gè)月 |
isCurrentMonth | "" | 判斷當(dāng)前實(shí)例是否屬于當(dāng)前月 |
isNextMonth | "" | 判斷當(dāng)前實(shí)例是否屬于下一個(gè)月 |
isLastYear | "" | 判斷當(dāng)前實(shí)例是否屬于去年 |
isCurrentYear | "" | 判斷當(dāng)前實(shí)例是否屬于當(dāng)前年 |
isNextYear | "" | 判斷當(dāng)前實(shí)例是否屬于下一年 |
isLeapYear | "" | 判斷當(dāng)前實(shí)例是否屬于閏年 |
isLongYear | "" | 判斷當(dāng)前實(shí)例是否屬于長(zhǎng)年,即一年不只有52個(gè)星期 |
isPast | "" | 判斷當(dāng)前實(shí)例是否屬于過(guò)去 |
isFuture | "" | 判斷當(dāng)前實(shí)例是否屬于未來(lái) |
方法名 | 參數(shù) | 描述 |
---|---|---|
addSecond | $value(1) | 當(dāng)前實(shí)例添加指定數(shù)量的秒數(shù),返回當(dāng)前實(shí)例 |
subSecond | $value(1) | 當(dāng)前實(shí)例減去指定數(shù)量的秒數(shù),返回當(dāng)前實(shí)例 |
addSeconds | $value | 同addSecond |
subSeconds | $value | 同subSecond |
addMinute | $value(1) | 當(dāng)前實(shí)例添加指定數(shù)量的分鐘數(shù),返回當(dāng)前實(shí)例 |
subMinute | $value(1) | 當(dāng)前實(shí)例減去指定數(shù)量的分鐘數(shù),返回當(dāng)前實(shí)例 |
addMinutes | $value | 同addMinute |
subMinutes | $value | 同subMinute |
addHour | $value(1) | 當(dāng)前實(shí)例添加指定數(shù)量的小時(shí)數(shù),返回當(dāng)前實(shí)例 |
subHour | $value(1) | 當(dāng)前實(shí)例減去指定數(shù)量的小時(shí)數(shù),返回當(dāng)前實(shí)例 |
addHours | $value | 同addHour |
subHours | $value | 同subHour |
addDay | $value(1) | 當(dāng)前實(shí)例添加指定數(shù)量的天數(shù),返回當(dāng)前實(shí)例 |
subDay | $value(1) | 當(dāng)前實(shí)例減去指定數(shù)量的天數(shù),返回當(dāng)前實(shí)例 |
addDays | $value | 同addDay |
subDays | $value | 同subDay |
addWeekday | $value(1) | 當(dāng)前實(shí)例添加指定數(shù)量的工作日數(shù),返回當(dāng)前實(shí)例 |
subWeekday | $value(1) | 當(dāng)前實(shí)例減去指定數(shù)量的工作日數(shù),返回當(dāng)前實(shí)例 |
addWeekdays | $value | 同addWeekday |
subWeekdays | $value | 同subWeekday |
addWeek | $value(1) | 當(dāng)前實(shí)例添加指定數(shù)量的星期數(shù),返回當(dāng)前實(shí)例 |
subWeek | $value(1) | 當(dāng)前實(shí)例減去指定數(shù)量的星期數(shù),返回當(dāng)前實(shí)例 |
addWeeks | $value | 同addWeek |
subWeeks | $value | 同subWeek |
addMonth | $value(1) | 當(dāng)前實(shí)例添加指定數(shù)量的月數(shù),返回當(dāng)前實(shí)例 |
subMonth | $value(1) | 當(dāng)前實(shí)例減去指定數(shù)量的月數(shù),返回當(dāng)前實(shí)例 |
addMonths | $value | 同addMonth |
subMonths | $value | 同subMonth |
addMonthWithOverflow(1) | $value(1) | 當(dāng)前實(shí)例添加指定數(shù)量的月數(shù)(可溢出),返回當(dāng)前實(shí)例 |
subMonthWithOverflow(1) | $value(1) | 當(dāng)前實(shí)例添加指定數(shù)量的月數(shù)(可溢出),返回當(dāng)前實(shí)例 |
addMonthsWithOverflow | $value | 同addMonthWithOverflow |
subMonthsWithOverflow | $value | 同subMonthWithOverflow |
addMonthNoOverflow(1) | $value(1) | 當(dāng)前實(shí)例添加指定數(shù)量的月數(shù)(不可溢出),返回當(dāng)前實(shí)例 |
subMonthNoOverflow(1) | $value(1) | 當(dāng)前實(shí)例添加指定數(shù)量的月數(shù)(不可溢出),返回當(dāng)前實(shí)例 |
addMonthsNoOverflow | $value | 同addMonthNoOverflow |
subMonthsNoOverflow | $value | 同subMonthNoOverflow |
addQuarter(1) | $value(1) | 當(dāng)前實(shí)例添加指定數(shù)量的季度數(shù),返回當(dāng)前實(shí)例 |
subQuarter(1) | $value(1) | 當(dāng)前實(shí)例減去指定數(shù)量的季度數(shù),返回當(dāng)前實(shí)例 |
addQuarters | $value | 同addQuarter |
subQuarters | $value | 同subQuarter |
addYear(1) | $value(1) | 當(dāng)前實(shí)例添加指定數(shù)量的年數(shù),返回當(dāng)前實(shí)例 |
subYear(1) | $value(1) | 當(dāng)前實(shí)例減去指定數(shù)量的年數(shù),返回當(dāng)前實(shí)例 |
addYears | $value | 同addYear |
subYears | $value | 同subYear |
addCentury(1) | $value(1) | 當(dāng)前實(shí)例添加指定數(shù)量的世紀(jì)數(shù),返回當(dāng)前實(shí)例 |
subCentury(1) | $value(1) | 當(dāng)前實(shí)例減去指定數(shù)量的世紀(jì)數(shù),返回當(dāng)前實(shí)例 |
addCenturies | $value | 同addCentury |
subCenturies | $value | 同subCentury |
方法名 | 參數(shù) | 描述 |
---|---|---|
diffInSeconds | Carbon $dt(null), $abs(true) | 獲取指定Carbon對(duì)象與當(dāng)前實(shí)例時(shí)間的秒數(shù)差,前者 - 后者; abs表示是否返回絕對(duì)值 |
secondsSinceMidnight | "" | 獲取當(dāng)前實(shí)例時(shí)間的 0時(shí)0分0秒 與當(dāng)前實(shí)例時(shí)間的秒差 |
secondsUntilEndOfDay | "" | 獲取當(dāng)前實(shí)例時(shí)間的 23時(shí)59分59秒 與當(dāng)前實(shí)例時(shí)間的秒差 |
diffInMinutes | Carbon $dt(null), $abs(true) | 獲取指定Carbon對(duì)象與當(dāng)前實(shí)例時(shí)間的分鐘差, 取整 |
diffInHours | Carbon $dt(null), $abs(true) | 獲取指定Carbon對(duì)象與當(dāng)前實(shí)例時(shí)間的小時(shí)差, 取整 |
diffInHoursFiltered | Closure $callback, Carbon $dt(null), $abs(true) | 獲取指定Carbon對(duì)象與當(dāng)前實(shí)例時(shí)間的(通過(guò)回調(diào)函數(shù)較驗(yàn)的)小時(shí)差, 取整 |
diffInDays | Carbon $dt(null), $abs(true) | 獲取指定Carbon對(duì)象與當(dāng)前實(shí)例時(shí)間的天數(shù)差, 取整 |
diffInDaysFiltered | Closure $callback, Carbon $dt(null), $abs(true) | 獲取指定Carbon對(duì)象與當(dāng)前實(shí)例時(shí)間的(通過(guò)回調(diào)函數(shù)較驗(yàn)的)天數(shù)差, 取整 |
diffInWeekdays | Carbon $dt(null), $abs(true) | 獲取指定Carbon對(duì)象與當(dāng)前實(shí)例時(shí)間的工作日數(shù)差, 取整 |
diffInWeekendDays | Carbon $dt(null), $abs(true) | 獲取指定Carbon對(duì)象與當(dāng)前實(shí)例時(shí)間的雙休日數(shù)差, 取整 |
diffInWeeks | Carbon $dt(null), $abs(true) | 獲取指定Carbon對(duì)象與當(dāng)前實(shí)例時(shí)間的星期數(shù)差, 取整 |
diffInMonths | Carbon $dt(null), $abs(true) | 獲取指定Carbon對(duì)象與當(dāng)前實(shí)例時(shí)間的月數(shù)差, 取整 |
diffInYears | Carbon $dt(null), $abs(true) | 獲取指定Carbon對(duì)象與當(dāng)前實(shí)例時(shí)間的年數(shù)差, 取整 |
diffFiltered | CarbonInterval $ci, Closure $callback, Carbon $dt(null), $abs(true) | 獲取指定Carbon對(duì)象與當(dāng)前實(shí)例時(shí)間的(通過(guò)回調(diào)函數(shù)較驗(yàn)的)$ci差, 取整 |
diffForHumans | Carbon $other(null), $absolute(false), $short(false) | 獲取指定Carbon對(duì)象與當(dāng)前實(shí)例時(shí)間的時(shí)間差,以便于人類(lèi)閱讀的格式呈現(xiàn) |
方法名 | 參數(shù) | 描述 |
---|---|---|
getDays(static) | "" | 獲取days of the week |
getWeekStartsAt(static) | "" | 獲取一周的第一天 |
setWeekStartsAt(static) | $day | 設(shè)置一周的第一天 |
getWeekEndsAt(static) | "" | 獲取一周的最后一天 |
setWeekEndsAt(static) | $day | 設(shè)置一周的最后一天 |
getWeekendDays(static) | "" | 獲取雙休日(數(shù)組) |
setWeekendDays(static) | $days | 設(shè)置雙休日 |
getTranslator(static) | "" | 獲取translator實(shí)例 |
setTranslator(static) | TranslatorInterface $translator | 設(shè)置translator實(shí)例 |
getLocale(static) | "" | 獲取當(dāng)前本地化語(yǔ)言 |
setLocale(static) | $locale | 設(shè)置當(dāng)前本地化語(yǔ)言 |
timezone | $value | 設(shè)置時(shí)區(qū) |
tz | $value | 設(shè)置時(shí)區(qū) |
setTimezone | $value | 設(shè)置時(shí)區(qū) |
setToStringFormat(static) | $format | 設(shè)置變量$toStringFormat |
resetToStringFormat(static) | "" | 設(shè)置變量$toStringFormat為默認(rèn)值 |
setTestNow(static) | $testNow(null) | 設(shè)置變量$testNow,測(cè)試專(zhuān)用,初始化時(shí)的$now |
getTestNow(static) | "" | 獲取變量$testNow |
hasTestNow(static) | "" | 判斷$testNow是否為空 |
方法名 | 參數(shù) | 描述 |
---|---|---|
setUtf8(static) | $utf8 | 設(shè)置是否采用 utf8 編碼方式 |
getLastErrors(static) | "" | 獲取無(wú)效時(shí)間的錯(cuò)誤格式模板 |
serialize | "" | 返回當(dāng)前實(shí)例的序列化字符串 |
hasRelativeKeywords(static) | $time | 判斷字符串中是否有指定的關(guān)鍵字 |
shouldOverflowMonths(static) | "" | 獲取變量$monthsOverflow |
useMonthsOverflow(static) | $monthsOverflow(true) | 設(shè)置變量$monthsOverflow |
resetMonthsOverflow(static) | "" | 重置變量$monthsOverflow為 true |
__get | $name | 魔術(shù)方法 |
__isset | $name | 魔術(shù)方法 |
__set | $name, $value | 魔術(shù)方法 |
方法名 | 參數(shù) | 描述 |
---|---|---|
__construct | $years(1), $months(null), $weeks(null), $days(null), $hours(null), $minutes(null), $seconds(null) | 創(chuàng)建CarbonInterval實(shí)例 |
create(static) | $years(1), $months(null), $weeks(null), $days(null), $hours(null), $minutes(null), $seconds(null) | 創(chuàng)建CarbonInterval實(shí)例 |
second(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
seconds(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
minute(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
minutes(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
hour(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
hours(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
day(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
days(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
dayz(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
week(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
weeks(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
month(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
months(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
year(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
years(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
instance(static) | $value | 創(chuàng)建 CarbonInterval 實(shí)例 |
方法名 | 參數(shù) | 描述 |
---|---|---|
translator(static) | "" | 初始化translator實(shí)例 |
getTranslator(static) | "" | 獲取translator實(shí)例 |
setTranslator(static) | TranslatorInterface $translator | 設(shè)置translator實(shí)例 |
getLocale(static) | "" | 獲取當(dāng)前本地化語(yǔ)言 |
setLocale(static) | $locale | 設(shè)置當(dāng)前本地化語(yǔ)言 |
方法名 | 參數(shù) | 描述 |
---|---|---|
add | DateInterval $interval | 將指定DateInterval的時(shí)間疊加到當(dāng)前實(shí)例 |
方法名 | 參數(shù) | 描述 |
---|---|---|
spec | "" | 獲取規(guī)范的間隔描述字符串 |
forHumans | "" | 獲取便于人類(lèi)閱讀的間隔描述字符串 |
__toString | "" | 同forHumans |
方法名 | 參數(shù) | 描述 |
---|---|---|
__get | "" | 魔術(shù)方法;可操作變量有years/months/dayz/hours/minutes/seconds/weeks/daysExcludeWeeks/dayzExcludeWeeks |
__set | "" | 魔術(shù)方法;可操作變量有years/months/dayz/hours/minutes/seconds/weeks/daysExcludeWeeks/dayzExcludeWeeks |
__call | "" | 魔術(shù)方法;可操作方法有years/year/months/month/weeks/week/days/dayz/day/hours/hour/minutes/minute/seconds/second |
weeksAndDays | $weeks, $days | 為當(dāng)前實(shí)例的dayz變量賦值為($weeks * Carbon::DAYS_PER_WEEK) + $days |
文章版權(quán)歸作者所有,未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請(qǐng)注明本文地址:http://m.specialneedsforspecialkids.com/yun/22985.html
摘要:它是專(zhuān)門(mén)用來(lái)處理和時(shí)間相關(guān)的類(lèi),除了這里用到的實(shí)例化時(shí)間計(jì)算時(shí)間等,還有很多實(shí)用的功能,在參考資料中有相關(guān)鏈接,可以查看。 導(dǎo)語(yǔ) 這個(gè)需求是這樣的,我的電飯鍋有定時(shí)功能,第二天早上想要喝粥的話,就要設(shè)置倒計(jì)時(shí),每次就要算一下要設(shè)置多少時(shí)間,干脆就寫(xiě)個(gè)代碼好了。很簡(jiǎn)單的功能,不值得寫(xiě)一篇,另一個(gè)目的其實(shí)是記錄一下從開(kāi)發(fā)到提交 GitHub 的流程。代碼可查看 GitHub。 本地開(kāi)發(fā) 先...
摘要:下面是一個(gè)例子這個(gè)庫(kù)要求你至少安裝了和其中的一個(gè),這可能意味著,在大多數(shù)主機(jī)提供商提供的主機(jī)上它可能用不了。借助它,你可以忘記如何書(shū)寫(xiě)乏味的有一個(gè)姊妹庫(kù)叫,是一個(gè)基于的實(shí)現(xiàn)。 showImg(http://segmentfault.com/img/bVbJml); 作為一個(gè)PHP開(kāi)發(fā)者,現(xiàn)在是一個(gè)令人激動(dòng)的時(shí)刻。每天有許許多多有用的庫(kù)分發(fā)出來(lái),在 Github 上很容易發(fā)現(xiàn)和使用這些庫(kù)...
摘要:原文地址中文文檔介紹是的日期處理類(lèi)庫(kù)。例如作者所在的時(shí)區(qū)為東京時(shí)間減小時(shí),因此在下午一點(diǎn)后。最后提到的這兩個(gè)方法都是處理時(shí)間戳的。以下是當(dāng)前支持的時(shí)間轉(zhuǎn)換字值得注意的是像和方法等相關(guān)的修改會(huì)把日期的時(shí)間部分設(shè)置成。 原文地址 : Carbon中文文檔 介紹 Carbon 是php的日期處理類(lèi)庫(kù)(A simple PHP API extension for DateTime.)。 Car...
摘要:是的日期處理類(lèi)庫(kù)。另外可以默認(rèn)設(shè)置方法所要顯示的時(shí)間日期格式。一些特殊的過(guò)濾方法,像和可以幫助你過(guò)濾時(shí)間差中的或者一個(gè)自定義的時(shí)間間隔。對(duì)于人們來(lái)說(shuō)一月前比天前更加易與理解。中定義了以下常量。 Introduction Carbon 是php的日期處理類(lèi)庫(kù)(A simple PHP API extension for DateTime.)。Carbon 繼承了PHP的 Datetime...
摘要:本文翻譯改編自的十八個(gè)最佳實(shí)踐這篇文章并不是什么由改編的原則模式等。只是為了讓你注意你在現(xiàn)實(shí)生活的項(xiàng)目中最常忽略的內(nèi)容。單一職責(zé)原則正在幫助你避免重復(fù)。當(dāng)然,這也包括了模板的范圍等。此外,也擁有很棒的內(nèi)置工具,比如軟刪除事件范圍等。 showImg(https://segmentfault.com/img/remote/1460000015166532); 本文翻譯改編自 Larave...
閱讀 3473·2023-04-25 18:52
閱讀 2485·2021-11-22 15:31
閱讀 1224·2021-10-22 09:54
閱讀 3011·2021-09-29 09:42
閱讀 607·2021-09-26 09:55
閱讀 912·2021-09-13 10:28
閱讀 1103·2019-08-30 15:56
閱讀 2110·2019-08-30 15:55