溫馨提示×
您好，登錄后才能下訂單哦！
點擊 登錄注冊 即表示同意《億速云用戶服務條款》
您好，登錄后才能下訂單哦！
這篇文章主要講解了“Laravel Carbon擴展包的作用有哪些”，文中的講解內容簡單清晰，易于學習與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學習“Laravel Carbon擴展包的作用有哪些”吧！
Carbon *繼承了PHP的 *Datetime *類和JsonSerialiable。所以 *Carbon *中沒有涉及到的，但在 *Datetime *和JsonSerializable*中已經實現的方法都是可以使用的。
class Carbon extends DateTime implements JsonSerializable
{
//code here}Carbon 類聲明在 Carbon 命名空間下，可以通過引入命名空間的方式來代替每次輸入完整的類名。
<?php use Carbon\Carbon;
要特別留意是否使用了正確的時區，比如的所有差異比較都使用或者系統設定的時區
$dtToronto = Carbon::create(2012, 1, 1, 0, 0, 0, 'America/Toronto'); $dtVancouver = Carbon::create(2012, 1, 1, 0, 0, 0, 'America/Vancouver'); echo $dtVancouver->diffInHours($dtToronto); //
以上進行的時間比較是在提供的 Carbon 實例所在的時區下完成的。例如作者所在的時區為 東京時間減13 小時，因此在下午一點后。Carbon::now(‘Asia/Tokyo’)->isToday() 將會返回 false ，如果在調用 now() 時設置時區為東京時區，接下來的操作都使用東京時區是說不過去的。所以在與 *now() *創建的實例進行比較時，默認是在當前時區下完成的。
有幾種不同的方法可以創建一個新的Carbon實例。首先是構造函數。它覆蓋父構造函數，您最好閱讀PHP手冊中的第一個參數，并了解它所接受的日期/時間字符串格式。您可能會發現自己很少使用構造函數，而是依賴于顯式靜態方法來提高可讀性
$carbon = new Carbon(); // 等同于 Carbon::now()
$carbon = new Carbon('first day of January 2008', 'America/Vancouver');
echo get_class($carbon); // 'Carbon\Carbon'
$carbon = Carbon::now(-5);//1表示英國倫敦，2表示法國巴黎您將在上面注意到，timezone(2nd)參數是作為字符串和整數而不是\DateTimeZone實例傳遞的。所有DateTimeZone參數都已被增強，因此您可以將一個DateTimeZone實例、字符串或整型偏移量傳遞給GMT，并為您創建時區。在下一個示例中再次顯示了這一點，該示例還介紹了now()函數。
$nowInLondonTz = Carbon::now(new \DateTimeZone('Europe/London'));
// 或者以字符串形式只傳時區
$nowInLondonTz = Carbon::now('Europe/London');// 或者在DST期間創建一個時區為+1到GMT的日期，然后傳遞一個整數echo Carbon::now(1)->tzName; // Europe/London如果您真的喜歡您的動態方法調用，并且對使用構造函數時所需的額外的行或難看的括號感到失望，那么您將喜歡parse方法。
echo (new Carbon('first day of December 2008'))->addWeeks(2); // 2008-12-15 00:00:00
echo Carbon::parse('first day of December 2008')->addWeeks(2); // 2008-12-15 00:00:00NOTE*:在PHP 5.4* 之前(new MyClass())->method()會報語法錯誤**, 如果你使用**PHP 5.3, 你需要創建一個變量然后再調用方法：
$date = new Carbon('first day of December 2008');
echo $date->addWeeks(2);傳遞給Carbon:::parse或new Carbon的字符串可以表示相對時間(next sunday, tomorrow, first day of next month, last year)或絕對時間(first day of December 2008, 2017-01-06)。您可以用Carbon::hasRelativeKeywords()測試一個字符串是否會產生一個相對或絕對日期。
$string = 'first day of next month';
if (strtotime($string) === false) {
echo "'$string' is not a valid date/time string.";
} elseif (Carbon::hasRelativeKeywords($string)) {
echo "'$string' is a relative valid date/time string, it will returns different dates depending on the current date.";
} else {
echo "'$string' is an absolute date/time string, it will always returns the same date.";
}為了配合now()，還存在一些靜態的實例化助手來創建廣為人知的實例。這里唯一需要注意的是，today()、tomorrow()和yesterday()除了按照預期的行為，都接受一個時區參數，每個參數的時間值都設置為00:00:00。
$now = Carbon::now();
echo $now; // 2018-07-26 16:25:49
$today = Carbon::today();
echo $today; // 2018-07-26 00:00:00
$tomorrow = Carbon::tomorrow('Europe/London');
echo $tomorrow; // 2018-07-27 00:00:00
$yesterday = Carbon::yesterday();
echo $yesterday; // 2018-07-25 00:00:00下一組靜態助手是createXXX() 函數。大多數靜態create函數允許您提供許多個或少量的參數，并為所有其他參數提供默認值。通常默認值是當前日期、時間或時區。更高的值將適當地包裝，但無效的值將拋出一個InvalidArgumentException，并附帶一條信息。錯誤消息從DateTime:::getLastErrors()調用中獲取。
Carbon::createFromDate($year, $month, $day, $tz);
Carbon::createFromTime($hour, $minute, $second, $tz);
Carbon::createFromTimeString("$hour:$minute:$second", $tz);
Carbon::create($year, $month, $day, $hour, $minute, $second, $tz);createFromDate() 的默認值是當前時間. createFromTime() 默認值是今天. create()如果不傳參數也是當前時間. 與前面一樣，$tz默認設置為當前時區，否則可以是DateTimeZone實例，也可以是字符串時區值。默認值(模擬底層PHP庫)的唯一特殊情況發生在指定了小時值但沒有分鐘或秒時，它們將默認為0。
注：***createFromTime()** will default the date to today**。小編經實戰代碼打印出來發現**createFromTime()**的默認值也是當前時間，不是今天（時分秒并不是**00:00:00**）。***
$xmasThisYear = Carbon::createFromDate(null, 12, 25); // Year默認值是今年
$Y2K = Carbon::create(2000, 1, 1, 0, 0, 0); // 等價于Carbon::createMidnightDate(2000, 1, 1)
$alsoY2K = Carbon::create(1999, 12, 31, 24);
$noonLondonTz = Carbon::createFromTime(12, 0, 0, 'Europe/London');
$teaTime = Carbon::createFromTimeString('17:00:00', 'Europe/London');
// A two digit minute could not be found
try {
Carbon::create(1975, 5, 21, 22, -2, 0); } catch(\InvalidArgumentException $x) {
echo $x->getMessage()}創建異常發生在使用負值上，而不是在溢出上，要獲取溢出上的異常，請使用createSafe()
echo Carbon::create(2000, 1, 35, 13, 0, 0);// 2000-02-04 13:00:00
//(1月有31天，4天自動加上去轉換成了2月4號)
try {
Carbon::createSafe(2000, 1, 35, 13, 0, 0);
} catch (\Carbon\Exceptions\InvalidDateException $exp) {
echo $exp->getMessage();
}// 會報錯:day : 35 is not a valid value.NOTE1:2018-02-29會產生一個異常，而2020-02-29不會產生異常，因為2020年是閏年。
NOTE2:Carbon::createSafe(2014,3,30,1,30,0,’Europe/London’);從PHP 5.4開始也會產生一個異常，因為在夏令時跳過一個小時，但是在PHP 5.4之前，它只會創建這個無效的日期。
Carbon::createFromFormat($format, $time, $tz);
createFromFormat()是最基本的php函數DateTime:::createFromFormat的包裝器。不同的是，$tz參數可以是DateTimeZone實例或字符串時區值。此外，如果格式有錯誤，這個函數將調用DateTime::getLastErrors()方法，然后拋出一個InvalidArgumentException，錯誤作為消息。如果您查看上面的createXX()函數的源代碼，它們都會調用createFromFormat()。
echo Carbon::createFromFormat('Y-m-d H', '1975-05-21 22')->toDateTimeString(); // 1975-05-21 22:00:00最后三個create函數用于使用unix時間戳。第一個將創建一個與給定的時間戳相等的Carbon實例，并將設置時區或默認為當前時區。第二個createFromTimestampUTC()是不同的，因為時區將保持UTC(GMT)。第二種方法與Carbon: createFromFormat(‘@’.$timestamp)的作用相同，但我只是讓它更明確了一點。第三個是createFromTimestampMs()，它接受以毫秒而不是秒為單位的時間戳。也允許使用負時間戳。
echo Carbon::createFromTimestamp(-1)->toDateTimeString(); // 1969-12-31 18:59:59
echo Carbon::createFromTimestamp(-1, 'Europe/London')->toDateTimeString(); // 1970-01-01 00:59:59
echo Carbon::createFromTimestampUTC(-1)->toDateTimeString(); // 1969-12-31 23:59:59echo Carbon::createFromTimestampMs(1)->format('Y-m-d\TH:i:s.uP T'); // 1969-12-31T19:00:00.001000-05:00 EST
echo Carbon::createFromTimestampMs(1, 'Europe/London')->format('Y-m-d\TH:i:s.uP T'); // 1970-01-01T01:00:00.001000+01:00 BST您還可以copy()在現有Carbon實例上創建。如預期的那樣，日期、時間和時區值都被復制到新實例。
$dt = Carbon::now(); echo $dt->diffInYears($dt->copy()->addYear()); // 1
// $dt 實例沒有改變，任然是Carbon:now()
您可以在現有的Carbon實例上使用nowWithSameTz()來在相同的時區中獲取一個新的實例。
$meeting = Carbon::createFromTime(19, 15, 00, 'Africa/Johannesburg');// 19:15 in Johannesburg
echo 'Meeting starts at '.$meeting->format('H:i').' in Johannesburg.'; // Meeting starts at 19:15 in Johannesburg.// now in Johannesburg
echo "It's ".$meeting->nowWithSameTz()->format('H:i').' right now in Johannesburg.'; // It's 09:37 right now in Johannesburg.最后，如果您發現自己從另一個庫繼承了\DateTime實例，不要害怕!您可以通過友好的instance()方法創建一個Carbon實例。或者使用更靈活的方法make()，它可以從DateTime、Carbon或string返回一個新的Carbon實例，否則它只返回null。
$dt = new \DateTime('first day of January 2008'); // <== instance from another API
$carbon = Carbon::instance($dt);
echo get_class($carbon); // 'Carbon\Carbon'
echo $carbon->toDateTimeString(); // 2008-01-01 00:00:00關于微秒的簡要說明。PHP DateTime對象允許您設置一個微秒值，但是忽略它的所有日期數學。現在，1.12.0的Carbon在實例化或復制操作過程中支持微秒，并在默認情況下使用format()方法。
$dt = Carbon::parse('1975-05-21 22:23:00.123456');
echo $dt->micro; //
echo $dt->copy()->micro; //在PHP 7.1之前 DateTime微秒未添加到“now”實例，并且之后不能更改，這意味著:
$date = new DateTime('now');
echo $date->format('u');
// display current microtime in PHP >= 7.1 (expect a bug in PHP 7.1.3 only)// display 000000 before PHP 7.1
$date = new DateTime('2001-01-01T00:00:00.123456Z');
echo $date->format('u');
// display 123456 in all PHP versions$date->modify('00:00:00.987654');echo $date->format('u');// display 987654 in PHP >= 7.1// display 123456 before PHP 7.1為了解決這個限制，我們在PHP < 7.1中調用了microseconds，但是這個特性在需要時可以被禁用(PHP >= 7.1):
Carbon::useMicrosecondsFallback(false);var_dump(Carbon::isMicrosecondsFallbackEnabled()); // false echo Carbon::now()->micro; // 0 in PHP < 7.1, microtime in PHP >= 7.1Carbon::useMicrosecondsFallback(true); // default value var_dump(Carbon::isMicrosecondsFallbackEnabled()); // trueecho Carbon::now()->micro; // microtime in all PHP version
是否需要遍歷一些日期以找到最早或最近的日期?不知道如何設置初始最大值/最小值?現在有兩個助手可以幫助你做出簡單的決定:
echo Carbon::maxValue(); // '9999-12-31 23:59:59'echo Carbon::minValue(); // '0001-01-01 00:00:00'
最小和最大值主要取決于系統(32位或64位)。
使用32位OS系統或32位版本的PHP(您可以在PHP中使用PHP_INT_SIZE == 4來檢查它)，最小值是0-unix-timestamp(1970-01-01 00:00:00)，最大值是常量PHP_INT_MAX給出的時間戳。
使用64位OS系統和64位PHP版本，最小值為01-01 00:00，最大值為9999-12-31 23:59:59。
不幸的是，基類DateTime沒有任何本地化支持。為了開始本地化支持，還添加了一個formatLocalized($format)方法。實現使用當前實例時間戳對strftime進行調用。如果您首先使用PHP函數setlocale()設置當前的語言環境，那么返回的字符串將被格式化為正確的語言環境。
$newLocale = setlocale(LC_TIME, 'German');
if ($newLocale === false) {
echo '"German" locale is not installed on your machine, it may have a different name a different name on your machine or you may need to install it.';
}echo $dt->formatLocalized('%A %d %B %Y'); // Mittwoch 21 Mai 1975
setlocale(LC_TIME, 'English');
echo $dt->formatLocalized('%A %d %B %Y'); // Wednesday 21 May 1975
setlocale(LC_TIME, ''); // reset localediffForHumans()也被定位。您可以通過使用靜態Carbon::setLocale()函數來設置Carbon locale()，并使用Carbon::getLocale()獲取當前的設置。
Carbon::setLocale('de');
echo Carbon::getLocale(); // de
echo Carbon::now()->addYear()->diffForHumans(); // in 1 Jahr
Carbon::setLocale('en');
echo Carbon::getLocale(); // en或者，您可以將一些代碼與給定的語言環境隔離:
Carbon::executeWithLocale('de', function ($newLocale) {
// You can optionally get $newLocale as the first argument of the closure
// It will be set to the new locale or false if the locale was not found.
echo Carbon::now()->addYear()->diffForHumans();
}); // in 1 Jahr
// outside the function the locale did not change
echo Carbon::getLocale(); // en
// or same using a return statement$french = Carbon::executeWithLocale('fr', function () {return Carbon::now()->addYear()->diffForHumans();});
echo $french; // dans 1 an有些語言需要打印utf8編碼(主要以. utf8結尾的語言環境包)。在本例中，您可以使用靜態方法"php
Carbon::setUtf8()對對utf8字符集的formatlocalized()調用的結果進行編碼。 setlocale(LC_TIME, 'Spanish');
$dt = Carbon::create(2016, 01, 06, 00, 00, 00);
Carbon::setUtf8(false);
echo $dt->formatLocalized('%A %d %B %Y'); // mi?rcoles 06 enero 2016
Carbon::setUtf8(true);
echo $dt->formatLocalized('%A %d %B %Y'); // miércoles 06 enero 2016
Carbon::setUtf8(false);
setlocale(LC_TIME, '');在Linux上
如果您在翻譯方面有問題，請檢查系統中安裝的地區(本地和生產)。
區域設置-列出已啟用的區域設置。
sudo locale-gen fr_FR。UTF-8安裝一個新的語言環境。
sudo dpkg-reconfigure locale來發布所有啟用的locale。
并重啟系統。
您可以通過以下方式自定義現有語言:
Carbon::setLocale('en');
$translator = Carbon::getTranslator();
$translator->setMessages('en', array(
'day' => ':count boring day|:count boring days',
));
$date1 = Carbon::create(2018, 1, 1, 0, 0, 0);
$date2 = Carbon::create(2018, 1, 4, 4, 0, 0);
echo $date1->diffForHumans($date2, true, false, 2); // 3 boring days 4 hours$translator->resetMessages('en'); // reset language customizations for en language請注意，您還可以使用另一個轉換器Carbon::setTranslator($custom)，只要給定的轉換器繼承了Symfony\Component\Translation\TranslatorInterface。 因此，對格式本地化、getter(如localeMonth、localedayayofweek和短變體)的語言環境支持是由安裝在操作系統中的語言環境驅動的。對于其他翻譯，由于碳社區的支持，它在內部得到了支持。您可以使用以下方法檢查支持的內容:
echo implode(', ', array_slice(Carbon::getAvailableLocales(), 0, 3)).'...'; // af, ar, ar_Shakl...
// Support diff syntax (before, after, from now, ago)
var_dump(Carbon::localeHasDiffSyntax('en')); // bool(true)
var_dump(Carbon::localeHasDiffSyntax('zh_TW')); // bool(true)
// Support 1-day diff words (just now, yesterday, tomorrow)
var_dump(Carbon::localeHasDiffOneDayWords('en')); // bool(true)
var_dump(Carbon::localeHasDiffOneDayWords('zh_TW')); // bool(false)
// Support 2-days diff words (before yesterday, after tomorrow)var_dump(Carbon::localeHasDiffTwoDayWords('en')); // bool(true)
var_dump(Carbon::localeHasDiffTwoDayWords('zh_TW')); // bool(false)
// Support short units (1y = 1 year, 1mo = 1 month, etc.)
var_dump(Carbon::localeHasShortUnits('en')); // bool(true)var_dump(Carbon::localeHasShortUnits('zh_TW')); // bool(false)// Support period syntax (X times, every X, from X, to X)var_dump(Carbon::localeHasPeriodSyntax('en')); // bool(true)var_dump(Carbon::localeHasPeriodSyntax('zh_TW')); // bool(false)以下是最后一個碳版本支持的73個地區的概述:
注意，如果您使用Laravel 5.5+，語言環境將根據當前的最后一個App:setLocale execution自動設置。所以擴散人類將是透明的。您可能仍然需要在某些中間件中運行setlocale以使formatlocalizedworking正確。
測試方法允許您在創建“現在”實例時設置要返回的Carbon實例(real或mock)。所提供的實例將在以下條件下具體返回:
對static now()方法的調用，例如
:now()
當一個空(或空字符串)被傳遞給構造函數或parse()時，ex.new Carbon(空)
當字符串“now”傳遞給構造函數或parse()時，ex. new Carbon(‘now’)
給定的實例也將作為diff方法的默認相對時間。
$knownDate = Carbon::create(2001, 5, 21, 12); // create testing date
Carbon::setTestNow($knownDate); // set the mock (of course this could be a real mock object)
echo Carbon::getTestNow(); // 2001-05-21 12:00:00
echo Carbon::now(); // 2001-05-21 12:00:00
echo new Carbon(); // 2001-05-21 12:00:00
echo Carbon::parse(); // 2001-05-21 12:00:00
echo new Carbon('now'); // 2001-05-21 12:00:00
echo Carbon::parse('now'); // 2001-05-21 12:00:00
echo Carbon::create(2001, 4, 21, 12)->diffForHumans(); // 1 month agovar_dump(Carbon::hasTestNow()); // bool(true)
Carbon::setTestNow(); // clear the mock
var_dump(Carbon::hasTestNow()); // bool(false)echo Carbon::now(); // 2018-07-05 03:37:12一個更有意義的完整例子:
class SeasonalProduct
{
protected $price;
public function __construct($price)
{
$this->price = $price;
}
public function getPrice() {
$multiplier = 1;
if (Carbon::now()->month == 12) {
$multiplier = 2;
}
return $this->price * $multiplier;}}
$product = new SeasonalProduct(100);
Carbon::setTestNow(Carbon::parse('first day of March 2000'));
echo $product->getPrice(); //Carbon::setTestNow(Carbon::parse('first day of December 2000'));
echo $product->getPrice(); //
Carbon::setTestNow(Carbon::parse('first day of May 2000'));
echo $product->getPrice(); //
Carbon::setTestNow();根據給定的“now”實例，還可以對相關短語進行嘲笑。
$knownDate = Carbon::create(2001, 5, 21, 12); // create testing date
Carbon::setTestNow($knownDate); // set the mock
echo new Carbon('tomorrow'); // 2001-05-22 00:00:00 ... notice the time !
echo new Carbon('yesterday'); // 2001-05-20 00:00:00
echo new Carbon('next wednesday'); // 2001-05-23 00:00:00
echo new Carbon('last friday'); // 2001-05-18 00:00:00
echo new Carbon('this thursday'); // 2001-05-24 00:00:00
Carbon::setTestNow(); // always clear it !被認為是相對修飾語的單詞列表如下:
+
-
ago
first
next
last
this
today
tomorrow
yesterday
請注意，與next()、previous()和modify()方法類似，這些相對修飾符中的一些將把時間設置為00:00。
Carbon: parse($time， $tz)和new Carbon($time， $tz)都可以將時區作為第二個參數。 echo Carbon::parse('2012-9-5 23:26:11.223', 'Europe/Paris')->timezone->getName(); // Europe/Parisgetter方法是通過PHP的__get()方法實現的。這使您能夠像訪問屬性而不是函數調用那樣訪問值。
$dt = Carbon::parse('2012-10-5 23:26:11.123789');
// 這些getter方法都將返回int類型
var_dump($dt->year); // int(2012)var_dump($dt->month); // int(10)
var_dump($dt->day); // int(5)
var_dump($dt->hour); // int(23)
var_dump($dt->minute); // int(26)
var_dump($dt->second); // int(11)var_dump($dt->micro); // int(123789)// dayOfWeek 返回一個數值 0 (sunday) 到 6 (saturday)
var_dump($dt->dayOfWeek); // int(5)// dayOfWeekIso 返回一個數值 1 (monday) 到 7 (sunday)
var_dump($dt->dayOfWeekIso); // int(5)
setlocale(LC_TIME, 'German');var_dump($dt->englishDayOfWeek); // string(6) "Friday"var_dump($dt->shortEnglishDayOfWeek); // string(3) "Fri"var_dump($dt->localeDayOfWeek); // string(7) "Freitag"var_dump($dt->shortLocaleDayOfWeek); // string(2) "Fr"var_dump($dt->englishMonth); // string(7) "October"var_dump($dt->shortEnglishMonth); // string(3) "Oct"var_dump($dt->localeMonth); // string(7) "Oktober"var_dump($dt->shortLocaleMonth); // string(3) "Okt"setlocale(LC_TIME, '');var_dump($dt->dayOfYear); // int(278)var_dump($dt->weekNumberInMonth);// weekNumberInMonth consider weeks from monday to sunday, so the week 1 will// contain 1 day if the month start with a sunday, and up to 7 if it starts with a mondayvar_dump($dt->weekOfMonth); // int(1)// weekOfMonth will returns 1 for the 7 first days of the month, then 2 from the 8th to// the 14th, 3 from the 15th to the 21st, 4 from 22nd to 28th and 5 above
var_dump($dt->weekOfYear); // int(40)
var_dump($dt->daysInMonth); // int(31)
var_dump($dt->timestamp); // int(1349493971)
var_dump(Carbon::createFromDate(1975, 5, 21)->age); // int(43) calculated vs now in the same tzvar_dump($dt->quarter); // int(4)
// Returns an int of seconds difference from UTC (+/- sign included)
var_dump(Carbon::createFromTimestampUTC(0)->offset); // int(0)
var_dump(Carbon::createFromTimestamp(0)->offset); // int(-18000)
// Returns an int of hours difference from UTC (+/- sign included)
var_dump(Carbon::createFromTimestamp(0)->offsetHours); // int(-5)// Indicates if day light savings time is on
var_dump(Carbon::createFromDate(2012, 1, 1)->dst); // bool(false)
var_dump(Carbon::createFromDate(2012, 9, 1)->dst); // bool(true)
// Indicates if the instance is in the same timezone as the local timezone
var_dump(Carbon::now()->local); // bool(true)var_dump(Carbon::now('America/Vancouver')->local); // bool(false)// Indicates if the instance is in the UTC timezonevar_dump(Carbon::now()->utc); // bool(false)
var_dump(Carbon::now('Europe/London')->utc); // bool(false)
var_dump(Carbon::createFromTimestampUTC(0)->utc); // bool(true)
// Gets the DateTimeZone instanceecho get_class(Carbon::now()->timezone); // DateTimeZone
echo get_class(Carbon::now()->tz); // DateTimeZone// Gets the DateTimeZone instance name, shortcut for ->timezone->getName()echo Carbon::now()->timezoneName; // America/Toronto
echo Carbon::now()->tzName; // America/Toronto下面的setter是通過PHP的__set()方法實現的。值得注意的是，除了顯式地設置時區之外，任何設置程序都不會更改實例的時區。具體地說，設置時間戳不會將相應的時區設置為UTC。
$dt = Carbon::now();$dt->year = 1975;
$dt->month = 13; //強制 year++ 然后 month = 1
$dt->month = 5;
$dt->day = 21;
$dt->hour = 22;
$dt->minute = 32;
$dt->second = 5;
$dt->timestamp = 169957925; // 這不會改變時區
// 通過DateTimeZone實例或字符串設置時區
$dt->timezone = new DateTimeZone('Europe/London');$dt->timezone = 'Europe/London';$dt->tz = 'Europe/London';對于setter沒有可選參數，但是函數定義中有足夠的多樣性，因此無論如何都不需要它們。值得注意的是，除了顯式地設置時區之外，任何設置程序都不會更改實例的時區。具體地說，設置時間戳不會將相應的時區設置為UTC。
$dt = Carbon::now();$dt->year(1975)->month(5)->day(21)->hour(22)->minute(32)->second(5)->toDateTimeString();
$dt->setDate(1975, 5, 21)->setTime(22, 32, 5)->toDateTimeString();
$dt->setDate(1975, 5, 21)->setTimeFromTimeString('22:32:05')->toDateTimeString();
$dt->setDateTime(1975, 5, 21, 22, 32, 5)->toDateTimeString();
$dt->timestamp(169957925)->timezone('Europe/London');
$dt->tz('America/Toronto')->setTimezone('America/Vancouver');您還可以將日期和時間與其他DateTime/Carbon對象分開設置:
$source1 = new Carbon('2010-05-16 22:40:10');
$dt = new Carbon('2001-01-01 01:01:01');
$dt->setTimeFrom($source1);echo $dt; // 2001-01-01 22:40:10
$source2 = new DateTime('2013-09-01 09:22:56');$dt->setDateFrom($source2);echo $dt; // 2013-09-01 22:40:10實現了PHP函數isset()。這是在一些外部系統(例如Twig)在使用屬性之前驗證屬性的存在時完成的。這是使用isset()或empty()方法完成的。在PHP站點:isset()、isset()、empty()上，您可以閱讀更多關于這些內容的信息。
var_dump(isset(Carbon::now()->iDoNotExist)); // bool(false) var_dump(isset(Carbon::now()->hour)); // bool(true) var_dump(empty(Carbon::now()->iDoNotExist)); // bool(true) var_dump(empty(Carbon::now()->year)); // bool(false)
所有可用的toXXXString()方法都依賴于基類方法DateTime: format()。您將注意到__toString()方法的定義，它允許在字符串上下文中使用時將一個Carbon實例打印為一個漂亮的日期時間字符串。
$dt = Carbon::create(1975, 12, 25, 14, 15, 16);
var_dump($dt->toDateTimeString() == $dt); // bool(true) => uses __toString()
echo $dt->toDateString(); // 1975-12-25
echo $dt->toFormattedDateString(); // Dec 25, 1975
echo $dt->toTimeString(); // 14:15:16
echo $dt->toDateTimeString(); // 1975-12-25 14:15:16
echo $dt->toDayDateTimeString(); // Thu, Dec 25, 1975 2:15 PM// ... of course format() is still availableecho $dt->format('l jS \\of F Y h:i:s A'); // Thursday 25th of December 1975 02:15:16 PM
// The reverse hasFormat method allows you to test if a string looks like a given format
var_dump($dt->hasFormat('Thursday 25th December 1975 02:15:16 PM', 'l jS F Y h:i:s A')); // bool(true)您還可以設置默認的__toString()格式(默認為Y-m-d H
s)，這是在發生類型雜耍時使用的格式。
Carbon::setToStringFormat('jS \o\f F, Y g:i:s a');
echo $dt; // 25th of December, 1975 2:15:16 pmCarbon::resetToStringFormat();
echo $dt; // 1975-12-25 14:15:16NOTE:對于本地化支持，請參閱本地化部分。
下面是DateTime類中提供的公共格式的包裝器。
$dt = Carbon::createFromFormat('Y-m-d H:i:s.u', '2019-02-01 03:45:27.612584');
// $dt->toAtomString() is the same as $dt->format(DateTime::ATOM);
echo $dt->toAtomString(); // 2019-02-01T03:45:27-05:00
echo $dt->toCookieString(); // Friday, 01-Feb-2019 03:45:27 EST
echo $dt->toIso8601String(); // 2019-02-01T03:45:27-05:00
// Be aware we chose to use the full-extended format of the ISO 8601 norm
// Natively, DateTime::ISO8601 format is not compatible with ISO-8601 as it// is explained here in the PHP documentation:
// https://php.net/manual/class.datetime.php#datetime.constants.iso8601
// We consider it as a PHP mistake and chose not to provide method for this
// format, but you still can use it this way:
echo $dt->format(DateTime::ISO8601); // 2019-02-01T03:45:27-0500
echo $dt->toIso8601ZuluString(); // 2019-02-01T08:45:27Z
echo $dt->toRfc822String(); // Fri, 01 Feb 19 03:45:27 -0500echo $dt->toRfc850String(); // Friday, 01-Feb-19 03:45:27 EST
echo $dt->toRfc1036String(); // Fri, 01 Feb 19 03:45:27 -0500
echo $dt->toRfc1123String(); // Fri, 01 Feb 2019 03:45:27 -0500
echo $dt->toRfc2822String(); // Fri, 01 Feb 2019 03:45:27 -0500
echo $dt->toRfc3339String(); // 2019-02-01T03:45:27-05:00
echo $dt->toRfc7231String(); // Fri, 01 Feb 2019 08:45:27 GMT
echo $dt->toRssString(); // Fri, 01 Feb 2019 03:45:27 -0500
echo $dt->toW3cString(); // 2019-02-01T03:45:27-05:00
var_dump($dt->toArray());/*
array(12) {
["year"]=>
int(2019)
["month"]=>
int(2)
["day"]=>
int(1)
["dayOfWeek"]=>
int(5)
["dayOfYear"]=>
int(31)
["hour"]=>
int(3)
["minute"]=>
int(45)
["second"]=>
int(27)
["micro"]=>
int(612584)
["timestamp"]=>
int(1549010727)
["formatted"]=>
string(19) "2019-02-01 03:45:27"
["timezone"]=>
object(DateTimeZone)#118 (2) {
["timezone_type"]=>
int(3)
["timezone"]=>
string(15) "America/Toronto"
}
}
*/通過以下函數提供了簡單的比較。請記住，比較是在UTC時區進行的，所以事情并不總是像看上去的那樣。
echo Carbon::now()->tzName; // America/Toronto $first = Carbon::create(2012, 9, 5, 23, 26, 11); $second = Carbon::create(2012, 9, 5, 20, 26, 11, 'America/Vancouver'); echo $first->toDateTimeString(); // 2012-09-05 23:26:11 echo $first->tzName; // America/Toronto echo $second->toDateTimeString(); // 2012-09-05 20:26:11echo $second->tzName; // America/Vancouver var_dump($first->eq($second)); // bool(true)var_dump($first->ne($second)); // bool(false) var_dump($first->gt($second)); // bool(false)var_dump($first->gte($second)); // bool(true) var_dump($first->lt($second)); // bool(false)var_dump($first->lte($second)); // bool(true) $first->setDateTime(2012, 1, 1, 0, 0, 0); $second->setDateTime(2012, 1, 1, 0, 0, 0); // Remember tz is 'America/Vancouver' var_dump($first->eq($second)); // bool(false) var_dump($first->ne($second)); // bool(true) var_dump($first->gt($second)); // bool(false) var_dump($first->gte($second)); // bool(false) var_dump($first->lt($second)); // bool(true) var_dump($first->lte($second)); // bool(true) // All have verbose aliases and PHP equivalent code: var_dump($first->eq($second)); // bool(false) var_dump($first->equalTo($second)); // bool(false) var_dump($first == $second); // bool(false)var_dump($first->ne($second)); // bool(true) var_dump($first->notEqualTo($second)); // bool(true)var_dump($first != $second); // bool(true)var_dump($first->gt($second)); // bool(false) var_dump($first->greaterThan($second)); // bool(false)var_dump($first > $second); // bool(false) var_dump($first->gte($second)); // bool(false) var_dump($first->greaterThanOrEqualTo($second)); // bool(false) var_dump($first >= $second); // bool(false)var_dump($first->lt($second)); // bool(true)var_dump($first->lessThan($second)); // bool(true)var_dump($first < $second); // bool(true) var_dump($first->lte($second)); // bool(true) var_dump($first->lessThanOrEqualTo($second)); // bool(true) var_dump($first <= $second); // bool(true)
這些方法使用PHP $date1 == $date2提供的自然比較，因此在PHP 7.1之前，所有方法都將忽略milli/micro-seconds，然后從7.1開始考慮它們。
要確定當前實例是否在其他兩個實例之間，可以使用恰當命名的between()方法。第三個參數表示是否應該進行相等的比較。默認值是true，它決定了它的中間值還是等于邊界。
$first = Carbon::create(2012, 9, 5, 1); $second = Carbon::create(2012, 9, 5, 5); var_dump(Carbon::create(2012, 9, 5, 3)->between($first, $second)); // bool(true) var_dump(Carbon::create(2012, 9, 5, 5)->between($first, $second)); // bool(true) var_dump(Carbon::create(2012, 9, 5, 5)->between($first, $second, false)); // bool(false)
哇!你忘記了min()和max()了嗎?不。這也被適當命名的min()和max()方法或minimum()和maximum()別名所覆蓋。與往常一樣，如果指定為null，則默認參數現在為。
$dt1 = Carbon::createMidnightDate(2012, 1, 1); $dt2 = Carbon::createMidnightDate(2014, 1, 30); echo $dt1->min($dt2); // 2012-01-01 00:00:00 echo $dt1->minimum($dt2); // 2012-01-01 00:00:00 $dt1 = Carbon::createMidnightDate(2012, 1, 1); $dt2 = Carbon::createMidnightDate(2014, 1, 30); echo $dt1->max($dt2); // 2014-01-30 00:00:00 echo $dt1->maximum($dt2); // 2014-01-30 00:00:00// now is the default param $dt1 = Carbon::createMidnightDate(2000, 1, 1); echo $dt1->max(); // 2018-07-05 03:37:12 echo $dt1->maximum(); // 2018-07-05 03:37:12$dt1 = Carbon::createMidnightDate(2010, 4, 1);$dt2 = Carbon::createMidnightDate(2010, 3, 28); $dt3 = Carbon::createMidnightDate(2010, 4, 16); // returns the closest of two date (no matter before or after) echo $dt1->closest($dt2, $dt3); // 2010-03-28 00:00:00 echo $dt2->closest($dt1, $dt3); // 2010-04-01 00:00:00 echo $dt3->closest($dt2, $dt1); // 2010-04-01 00:00:00 // returns the farthest of two date (no matter before or after) echo $dt1->farthest($dt2, $dt3); // 2010-04-16 00:00:00 echo $dt2->farthest($dt1, $dt3); // 2010-04-16 00:00:00. echo $dt3->farthest($dt2, $dt1); // 2010-03-28 00:00:00
為了處理最常用的情況，這里有一些簡單的幫助函數，希望它們的名稱能很明顯地反映出來。對于以某種方式與now() (ex.istoday()))進行比較的方法，now()是在與實例相同的時區創建的。
$dt = Carbon::now();
$dt2 = Carbon::createFromDate(1987, 4, 23);
$dt->isSameAs('w', $dt2); // w is the date of the week, so this will return true if $dt and $dt2
// the same day of week (both monday or both sunday, etc.)
// you can use any format and combine as much as you want.$dt->isFuture();
$dt->isPast();$dt->isSameYear($dt2);
$dt->isCurrentYear();
$dt->isNextYear();
$dt->isLastYear();
$dt->isLongYear(); // see https://en.wikipedia.org/wiki/ISO_8601#Week_dates
$dt->isLeapYear();$dt->isSameQuarter($dt2); // same quarter (3 months) no matter the year of the given date$dt->isSameQuarter($dt2, true); // same quarter of the same year of the given date/*
Alternatively, you can run Carbon::compareYearWithMonth() to compare both quarter and year by default,
In this case you can use $dt->isSameQuarter($dt2, false) to compare ignoring the year
Run Carbon::compareYearWithMonth(false) to reset to the default behavior
Run Carbon::shouldCompareYearWithMonth() to get the current setting
*/$dt->isCurrentQuarter();
$dt->isNextQuarter(); // date is in the next quarter
$dt->isLastQuarter(); // in previous quarter
$dt->isSameMonth($dt2); // same month no matter the year of the given date
$dt->isSameMonth($dt2, true); // same month of the same year of the given date/*
As for isSameQuarter, you can run Carbon::compareYearWithMonth() to compare both month and year by default,
In this case you can use $dt->isSameMonth($dt2, false) to compare ignoring the year
Run Carbon::compareYearWithMonth(false) to reset to the default behavior
Run Carbon::shouldCompareYearWithMonth() to get the current setting
*/
$dt->isCurrentMonth();
$dt->isNextMonth();
$dt->isLastMonth();
$dt->isWeekday();$dt->isWeekend();
$dt->isMonday();
$dt->isTuesday();$dt->isWednesday();
$dt->isThursday();
$dt->isFriday();
$dt->isSaturday();
$dt->isSunday();$dt->isDayOfWeek(Carbon::SATURDAY); // is a saturday$dt->isLastOfMonth(); // is the last day of the month
$dt->isSameDay($dt2); // Same day of same month of same year
$dt->isCurrentDay();
$dt->isYesterday();
$dt->isToday();$dt->isTomorrow();
$dt->isNextWeek();$dt->isLastWeek();
$dt->isSameHour($dt2);
$dt->isCurrentHour();$dt->isSameMinute($dt2);$dt->isCurrentMinute();$dt->isSameSecond($dt2);
$dt->isCurrentSecond();$dt->isStartOfDay(); // check if hour is 00:00:00$dt->isMidnight(); // check if hour is 00:00:00 (isStartOfDay alias)
$dt->isEndOfDay(); // check if hour is 23:59:59
$dt->isMidday(); // check if hour is 12:00:00 (or other midday hour set with Carbon::setMidDayAt())$born = Carbon::createFromDate(1987, 4, 23);$noCake = Carbon::createFromDate(2014, 9, 26);$yesCake = Carbon::createFromDate(2014, 4, 23);
$overTheHill = Carbon::now()->subYears(50);var_dump($born->isBirthday($noCake)); // bool(false)
var_dump($born->isBirthday($yesCake)); // bool(true)
var_dump($overTheHill->isBirthday()); // bool(true) -> default compare it to today!默認的DateTime提供了幾種不同的方法來方便地添加和減少時間。有modify()、add()和sub()。modify()使用一個魔術date/time格式字符串“last day of next month”，它解析并應用修改，而add()和sub()則期望一個不那么明顯的日期間隔實例(例如新的\日期間隔(‘P6YT5M’)將意味著6年5分鐘)。希望使用這些流暢的函數將會更加清晰，并且在幾個星期內沒有看到您的代碼后更容易閱讀。當然，我不會讓您選擇，因為基類函數仍然可用。
$dt = Carbon::create(2012, 1, 31, 0);echo $dt->toDateTimeString(); // 2012-01-31 00:00:00 echo $dt->addCenturies(5); // 2512-01-31 00:00:00 echo $dt->addCentury(); // 2612-01-31 00:00:00 echo $dt->subCentury(); // 2512-01-31 00:00:00 echo $dt->subCenturies(5); // 2012-01-31 00:00:00echo $dt->addYears(5); // 2017-01-31 00:00:00 echo $dt->addYear(); // 2018-01-31 00:00:00 echo $dt->subYear(); // 2017-01-31 00:00:00 echo $dt->subYears(5); // 2012-01-31 00:00:00 echo $dt->addQuarters(2); // 2012-07-31 00:00:00echo $dt->addQuarter(); // 2012-10-31 00:00:00 echo $dt->subQuarter(); // 2012-07-31 00:00:00 echo $dt->subQuarters(2); // 2012-01-31 00:00:00 echo $dt->addMonths(60); // 2017-01-31 00:00:00 echo $dt->addMonth(); // 2017-03-03 00:00:00 equivalent of $dt->month($dt->month + 1); so it wrapsecho $dt->subMonth(); // 2017-02-03 00:00:00 echo $dt->subMonths(60); // 2012-02-03 00:00:00 echo $dt->addDays(29); // 2012-03-03 00:00:00echo $dt->addDay(); // 2012-03-04 00:00:00 echo $dt->subDay(); // 2012-03-03 00:00:00echo $dt->subDays(29); // 2012-02-03 00:00:00echo $dt->addWeekdays(4); // 2012-02-09 00:00:00 echo $dt->addWeekday(); // 2012-02-10 00:00:00echo $dt->subWeekday(); // 2012-02-09 00:00:00 echo $dt->subWeekdays(4); // 2012-02-03 00:00:00 echo $dt->addWeeks(3); // 2012-02-24 00:00:00 echo $dt->addWeek(); // 2012-03-02 00:00:00 echo $dt->subWeek(); // 2012-02-24 00:00:00 echo $dt->subWeeks(3); // 2012-02-03 00:00:00 echo $dt->addHours(24); // 2012-02-04 00:00:00 echo $dt->addHour(); // 2012-02-04 01:00:00echo $dt->subHour(); // 2012-02-04 00:00:00 echo $dt->subHours(24); // 2012-02-03 00:00:00echo $dt->addMinutes(61); // 2012-02-03 01:01:00echo $dt->addMinute(); // 2012-02-03 01:02:00 echo $dt->subMinute(); // 2012-02-03 01:01:00 echo $dt->subMinutes(61); // 2012-02-03 00:00:00echo $dt->addSeconds(61); // 2012-02-03 00:01:01echo $dt->addSecond(); // 2012-02-03 00:01:02 echo $dt->subSecond(); // 2012-02-03 00:01:01 echo $dt->subSeconds(61); // 2012-02-03 00:00:00
為了好玩，您還可以將負值傳遞給addXXX()，實際上這就是subXXX()實現的方式。 附注:如果你忘記并使用addDay(5) 或subYear(3)，我支持你; 默認情況下，Carbon依賴于底層父類PHP DateTime行為。因此，增加或減少月份可能會溢出，例如:
$dt = Carbon::create(2017, 1, 31, 0);echo $dt->copy()->addMonth(); // 2017-03-03 00:00:00 echo $dt->copy()->subMonths(2); // 2016-12-01 00:00:00
為了防止溢出Carbon:usemonthverflow (false)
Carbon::useMonthsOverflow(false); $dt = Carbon::createMidnightDate(2017, 1, 31); echo $dt->copy()->addMonth(); // 2017-02-28 00:00:00 echo $dt->copy()->subMonths(2); // 2016-11-30 00:00:00 // Call the method with true to allow overflow again Carbon::resetMonthsOverflow(); // same as Carbon::useMonthsOverflow(true);
方法Carbon:::shouldOverflowMonths()允許您知道當前是否啟用了溢出。您也可以使用->addMonthsNoOverflow， ->subMonthsNoOverflow， ->addMonthsWithOverflow， -> submonth withoverflow(或單數方法，不含s至“month”)，顯式add/sub，無論當前模式如何，都可以添加或不添加溢出。
Carbon::useMonthsOverflow(false); $dt = Carbon::createMidnightDate(2017, 1, 31); echo $dt->copy()->addMonthWithOverflow(); // 2017-03-03 00:00:00 // plural addMonthsWithOverflow() method is also availableecho $dt->copy()->subMonthsWithOverflow(2); // 2016-12-01 00:00:00 // singular subMonthWithOverflow() method is also available echo $dt->copy()->addMonthNoOverflow(); // 2017-02-28 00:00:00 // plural addMonthsNoOverflow() method is also available echo $dt->copy()->subMonthsNoOverflow(2); // 2016-11-30 00:00:00 // singular subMonthNoOverflow() method is also available echo $dt->copy()->addMonth(); // 2017-02-28 00:00:00echo $dt->copy()->subMonths(2); // 2016-11-30 00:00:00Carbon::useMonthsOverflow(true);$dt = Carbon::createMidnightDate(2017, 1, 31); echo $dt->copy()->addMonthWithOverflow(); // 2017-03-03 00:00:00 echo $dt->copy()->subMonthsWithOverflow(2); // 2016-12-01 00:00:00 echo $dt->copy()->addMonthNoOverflow(); // 2017-02-28 00:00:00 echo $dt->copy()->subMonthsNoOverflow(2); // 2016-11-30 00:00:00echo $dt->copy()->addMonth(); // 2017-03-03 00:00:00 echo $dt->copy()->subMonths(2); // 2016-12-01 00:00:00Carbon::resetMonthsOverflow();
從1.23.0版本開始，在以下年份也可以使用溢出控制:
Carbon::useYearsOverflow(false); $dt = Carbon::createMidnightDate(2020, 2, 29); var_dump(Carbon::shouldOverflowYears()); // bool(false) echo $dt->copy()->addYearWithOverflow(); // 2021-03-01 00:00:00 // plural addYearsWithOverflow() method is also available echo $dt->copy()->subYearsWithOverflow(2); // 2018-03-01 00:00:00// singular subYearWithOverflow() method is also availableecho $dt->copy()->addYearNoOverflow(); // 2021-02-28 00:00:00// plural addYearsNoOverflow() method is also available echo $dt->copy()->subYearsNoOverflow(2); // 2018-02-28 00:00:00// singular subYearNoOverflow() method is also available echo $dt->copy()->addYear(); // 2021-02-28 00:00:00 echo $dt->copy()->subYears(2); // 2018-02-28 00:00:00Carbon::useYearsOverflow(true);$dt = Carbon::createMidnightDate(2020, 2, 29); var_dump(Carbon::shouldOverflowYears()); // bool(true) echo $dt->copy()->addYearWithOverflow(); // 2021-03-01 00:00:00 echo $dt->copy()->subYearsWithOverflow(2); // 2018-03-01 00:00:00echo $dt->copy()->addYearNoOverflow(); // 2021-02-28 00:00:00 echo $dt->copy()->subYearsNoOverflow(2); // 2018-02-28 00:00:00 echo $dt->copy()->addYear(); // 2021-03-01 00:00:00echo $dt->copy()->subYears(2); // 2018-03-01 00:00:00Carbon::resetYearsOverflow();
由于Carbon繼承了DateTime，它繼承了它的方法，如diff()，它將第二個date對象作為參數，并返回一個DateInterval實例。
我們還提供了diffAsCarbonInterval()，類似于diff()，但返回一個CarbonInterval實例。檢查CarbonInterval 章節了解更多信息。每個單元的Carbon添加了diff方法，如diffInYears()、diffInMonths()等。diffAsCarbonInterval()和diffIn*()方法都可以使用兩個可選參數:date to compare with(如果缺失，now是默認值)，以及一個絕對布爾選項(默認為true)，無論哪個日期大于另一個，該方法都返回一個絕對值。如果設置為false，則在調用方法的實例大于比較日期(第一個參數或now)時返回負值。注意，diff()原型是不同的:它的第一個參數(date)是強制性的，第二個參數(絕對選項)默認為false。
這些函數總是返回在指定的時間內表示的總差異。這與基類diff()函數不同，該函數的時間間隔為122秒，通過DateInterval實例返回2分零2秒。diffInMinutes()函數只返回2，而diffInSeconds()將返回122。所有的值都被截斷而不是四舍五入。下面的每個函數都有一個默認的第一個參數，該參數是要比較的Carbon實例，如果您想使用now()，則為null。第二個參數也是可選的，如果您希望返回值是絕對值，或者如果傳遞的日期小于當前實例，則返回值可能具有-(負)符號的相對值。這將默認為true，返回絕對值。
echo Carbon::now('America/Vancouver')->diffInSeconds(Carbon::now('Europe/London')); //
$dtOttawa = Carbon::createMidnightDate(2000, 1, 1, 'America/Toronto');
$dtVancouver = Carbon::createMidnightDate(2000, 1, 1, 'America/Vancouver');
echo $dtOttawa->diffInHours($dtVancouver); //echo $dtVancouver->diffInHours($dtOttawa); //
echo $dtOttawa->diffInHours($dtVancouver, false); //
echo $dtVancouver->diffInHours($dtOttawa, false); // -3
$dt = Carbon::createMidnightDate(2012, 1, 31);
echo $dt->diffInDays($dt->copy()->addMonth()); //echo $dt->diffInDays($dt->copy()->subMonth(), false); // -31$dt = Carbon::createMidnightDate(2012, 4, 30);
echo $dt->diffInDays($dt->copy()->addMonth()); //echo $dt->diffInDays($dt->copy()->addWeek()); //
$dt = Carbon::createMidnightDate(2012, 1, 1);echo $dt->diffInMinutes($dt->copy()->addSeconds(59)); //
echo $dt->diffInMinutes($dt->copy()->addSeconds(60)); //echo $dt->diffInMinutes($dt->copy()->addSeconds(119)); //
echo $dt->diffInMinutes($dt->copy()->addSeconds(120)); //
echo $dt->addSeconds(120)->secondsSinceMidnight(); //
$interval = $dt->diffAsCarbonInterval($dt->copy()->subYears(3), false);
echo ($interval->invert ? 'minus ' : 'plus ') . $interval->years; // minus 3關于夏令時(DST)的重要注意，默認情況下，PHP DateTime不考慮DST，這意味著，像2014年3月30日這樣只有23小時的一天在倫敦將被計算為24小時。
$date = new DateTime('2014-03-30 00:00:00', new DateTimeZone('Europe/London')); // DST offecho $date->modify('+25 hours')->format('H:i'); // 01:00 (DST on, 24 hours only have been actually added)Carbon也遵循這種行為，增加/減少/降低秒/分鐘/小時。但是我們提供了使用時間戳進行實時工作的方法:
$date = new Carbon('2014-03-30 00:00:00', 'Europe/London'); // DST offecho $date->addRealHours(25)->format('H:i'); // 02:00 (DST on)
echo $date->diffInRealHours('2014-03-30 00:00:00'); //
echo $date->diffInHours('2014-03-30 00:00:00'); //
echo $date->diffInRealMinutes('2014-03-30 00:00:00'); //
echo $date->diffInMinutes('2014-03-30 00:00:00'); //
echo $date->diffInRealSeconds('2014-03-30 00:00:00'); //
echo $date->diffInSeconds('2014-03-30 00:00:00'); //
echo $date->subRealHours(25)->format('H:i'); // 00:00 (DST off)同樣的方法可以使用addRealMinutes()、subRealMinutes()、addRealSeconds()、subRealSeconds()和所有它們的唯一快捷方式:addRealHour()、subRealHour()、addrealmin()、subRealMinute()、addRealSecond()、subRealSecond()。
還有特殊的過濾器函數diffindaysfilter()、diffinhoursfilter()和difffilter()，以幫助您按天數、小時或自定義間隔過濾差異。例如，計算兩個實例之間的周末天數:
$dt = Carbon::create(2014, 1, 1);
$dt2 = Carbon::create(2014, 12, 31);
$daysForExtraCoding = $dt->diffInDaysFiltered(function(Carbon $date) {
return $date->isWeekend();
}, $dt2);
echo $daysForExtraCoding; //
$dt = Carbon::create(2014, 1, 1)->endOfDay();
$dt2 = $dt->copy()->startOfDay();
$littleHandRotations = $dt->diffFiltered(CarbonInterval::minute(), function(Carbon $date) {return $date->minute === 0;}, $dt2, true); // true as last parameter returns absolute value
echo $littleHandRotations; //$date = Carbon::now()->addSeconds(3666);echo $date->diffInSeconds(); //
echo $date->diffInMinutes(); //
echo $date->diffInHours(); //echo $date->diffInDays(); //$date = Carbon::create(2016, 1, 5, 22, 40, 32);
echo $date->secondsSinceMidnight(); //echo $date->secondsUntilEndOfDay(); //
$date1 = Carbon::createMidnightDate(2016, 1, 5);$date2 = Carbon::createMidnightDate(2017, 3, 15);echo $date1->diffInDays($date2); //
echo $date1->diffInWeekdays($date2); //echo $date1->diffInWeekendDays($date2); //
echo $date1->diffInWeeks($date2); //
echo $date1->diffInMonths($date2); //
echo $date1->diffInYears($date2); //所有的diffIn*濾波方法都采用1個可調用濾波器作為必要參數，一個date對象作為可選的第二個參數，如果缺失，使用now。您也可以將true作為第三個參數傳遞，以獲得絕對值。
對于周/周末的高級處理，使用以下工具:
echo implode(', ', Carbon::getDays()); // Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
$saturday = new Carbon('first saturday of 2019');$sunday = new Carbon('first sunday of 2019');
$monday = new Carbon('first monday of 2019');
echo implode(', ', Carbon::getWeekendDays()); // 6, 0
var_dump($saturday->isWeekend()); // bool(true)
var_dump($sunday->isWeekend()); // bool(true)
var_dump($monday->isWeekend()); // bool(false)
Carbon::setWeekendDays(array(Carbon::SUNDAY,Carbon::MONDAY,
)); //自定義設置“周末”
echo implode(', ', Carbon::getWeekendDays()); // 0, 1
var_dump($saturday->isWeekend()); // bool(false),周六返回falsevar_dump($sunday->isWeekend()); // bool(true)var_dump($monday->isWeekend()); // bool(true)，周一返回trueCarbon::setWeekendDays(array(Carbon::SATURDAY,
Carbon::SUNDAY,
));// weekend days and start/end of week or not linked
Carbon::setWeekStartsAt(Carbon::FRIDAY);
Carbon::setWeekEndsAt(Carbon::WEDNESDAY); // and it does not need neither to precede the startvar_dump(Carbon::getWeekStartsAt() === Carbon::FRIDAY); // bool(true)
var_dump(Carbon::getWeekEndsAt() === Carbon::WEDNESDAY); // bool(true)echo $saturday->copy()->startOfWeek()->toRfc850String(); // Friday, 06-Jul-18 00:00:00 EDT
echo $saturday->copy()->endOfWeek()->toRfc850String(); // Wednesday, 11-Jul-18 23:59:59 EDT
Carbon::setWeekStartsAt(Carbon::MONDAY);
Carbon::setWeekEndsAt(Carbon::SUNDAY);
echo $saturday->copy()->startOfWeek()->toRfc850String(); // Monday, 02-Jul-18 00:00:00 EDT
echo $saturday->copy()->endOfWeek()->toRfc850String(); // Sunday, 08-Jul-18 23:59:59 EDT對人類來說，一個月前比30天前更容易閱讀。這是在大多數日期庫中常見的函數，所以我也想在這里添加它。函數的唯一參數是另一個要對其進行diff的Carbon實例，當然，如果沒有指定，它默認為now()。
此方法將在相對于實例的差值和傳入實例的差值之后添加短語。有4個可能性:
當將過去的值與現在的默認值進行比較時:
1小時前
5個月前
當將未來的值與現在的默認值進行比較時:
從現在開始的1小時
從現在開始的5個月
當比較一個過去的值與另一個值時:
前1小時
5個月前
當比較未來的價值與另一個價值時:
1小時后
5個月后
您還可以將true作為第二個參數傳遞，以便從現在開始刪除修飾符，等等:diffforhuman ($other, true)。
如果在所使用的語言環境:diffforhuman ($other, false, true)中可用，您可以將true作為第三個參數傳遞給它，以使用簡短語法。
您可以將1和6之間的數字作為第4個參數傳遞給diffforhuman ($other, false, false, 4)。
$other實例可以是DateTime、Carbon實例或任何實現DateTimeInterface的對象，如果傳遞了一個字符串，它將被解析為獲取一個Carbon實例，如果傳遞了null，那么將使用Carbon: now()。
// The most typical usage is for comments
// The instance is the date the comment was created and its being compared to default now()
echo Carbon::now()->subDays(5)->diffForHumans(); // 5 days agoecho Carbon::now()->diffForHumans(Carbon::now()->subYear()); // 1 year after
$dt = Carbon::createFromDate(2011, 8, 1);
echo $dt->diffForHumans($dt->copy()->addMonth()); // 1 month before
echo $dt->diffForHumans($dt->copy()->subMonth()); // 1 month after
echo Carbon::now()->addSeconds(5)->diffForHumans(); // 5 seconds from nowecho Carbon::now()->subDays(24)->diffForHumans(); // 3 weeks ago（21-27都返回這個，一個周的單位是7天，小于7直接舍去）echo Carbon::now()->subDays(24)->diffForHumans(null, true); // 3 weeks（21-27都返回這個，一個周的單位是7天，小于7直接舍去）echo Carbon::parse('2019-08-03')->diffForHumans('2019-08-13'); // 1 week before(時間間隔7-13天都是返回這個，一個周的單位是7天，小于7直接舍去）echo Carbon::parse('2000-01-01 00:50:32')->diffForHumans('@946684800'); // 5 hours after(同理，都是舍去的)echo Carbon::create(2018, 2, 26, 4, 29, 43)->diffForHumans(Carbon::create(2016, 6, 21, 0, 0, 0), false, false, 6); // 1 year 8 months 5 days 4 hours 29 minutes 43 seconds after您還可以在調用diffforhuman()之前使用Carbon::setLocale(‘fr’)更改字符串的locale。有關更多細節，請參見本地化部分。
可以通過以下方式啟用/禁用diffforhuman()選項:
Carbon::enableHumanDiffOption(Carbon::NO_ZERO_DIFF); var_dump((bool) (Carbon::getHumanDiffOptions() & Carbon::NO_ZERO_DIFF)); // bool(true) Carbon::disableHumanDiffOption(Carbon::NO_ZERO_DIFF); var_dump((bool) (Carbon::getHumanDiffOptions() & Carbon::NO_ZERO_DIFF)); // bool(false)
可用的選項是:
Carbon::NO_ZERO_DIFF(默認啟用):將空diff變為1秒Carbon::JUST_NOW在默認情況下是禁用的):從現在開始變為“剛才” Carbon:ONE_DAY_WORDS(默認禁用):將“從現在/之前1天”變為“昨天/明天”Carbon::TWO_DAY_WORDS(默認禁用):將“從現在/之前2天”變為“昨天/之后”
Carbon::JUST_NOW，Carbon::ONE_DAY_WORDS和Carbon::TWO_DAY_WORDS現在只能使用en和fr語言，其他語言將會恢復到以前的行為，直到添加缺失的翻譯。
使用管道操作符一次啟用/禁用多個選項，例如:ONE_DAY_WORDS | Carbon::TWO_DAY_WORDS
您還可以使用setHumanDiffOptions($options)禁用所有選項，然后只激活作為參數傳遞的選項。
這些方法組對當前實例進行了有益的修改。他們中的大多數方法的名字都是不言自明的……或者至少應該是這樣。您還會注意到startOfXXX()、next()和previous()方法將時間設置為00:00,endOfXXX()方法將時間設置為23:59:59。
唯一稍有不同的是average()函數。它將實例移動到其本身和提供的碳參數之間的中間日期。
$dt = Carbon::create(2012, 1, 31, 15, 32, 45); echo $dt->startOfMinute(); // 2012-01-31 15:32:00$dt = Carbon::create(2012, 1, 31, 15, 32, 45); echo $dt->endOfMinute(); // 2012-01-31 15:32:59 $dt = Carbon::create(2012, 1, 31, 15, 32, 45); echo $dt->startOfHour(); // 2012-01-31 15:00:00$dt = Carbon::create(2012, 1, 31, 15, 32, 45); echo $dt->endOfHour(); // 2012-01-31 15:59:59 $dt = Carbon::create(2012, 1, 31, 15, 32, 45);echo Carbon::getMidDayAt(); // 12獲取正午時間 echo $dt->midDay(); // 2012-01-31 12:00:00 Carbon::setMidDayAt(13); //設置正午時間為13點 echo Carbon::getMidDayAt(); // echo $dt->midDay(); // 2012-01-31 13:00:00 Carbon::setMidDayAt(12); $dt = Carbon::create(2012, 1, 31, 12, 0, 0);echo $dt->startOfDay(); // 2012-01-31 00:00:00 $dt = Carbon::create(2012, 1, 31, 12, 0, 0); echo $dt->endOfDay(); // 2012-01-31 23:59:59 $dt = Carbon::create(2012, 1, 31, 12, 0, 0); echo $dt->startOfMonth(); // 2012-01-01 00:00:00$dt = Carbon::create(2012, 1, 31, 12, 0, 0); echo $dt->endOfMonth(); // 2012-01-31 23:59:59$dt = Carbon::create(2012, 1, 31, 12, 0, 0); echo $dt->startOfYear(); // 2012-01-01 00:00:00$dt = Carbon::create(2012, 1, 31, 12, 0, 0); echo $dt->endOfYear(); // 2012-12-31 23:59:59$dt = Carbon::create(2012, 1, 31, 12, 0, 0);echo $dt->startOfDecade(); // 2010-01-01 00:00:00 十年（“年代？”）的開始1990，2000，2010，2010 $dt = Carbon::create(2012, 1, 31, 12, 0, 0); echo $dt->endOfDecade(); // 2019-12-31 23:59:59$dt = Carbon::create(2012, 1, 31, 12, 0, 0); echo $dt->startOfCentury(); // 2001-01-01 00:00:00 世紀的開始？為什么不是2000-01-01 00:00:00？？？可能老外就是這個定義的吧…… $dt = Carbon::create(2012, 1, 31, 12, 0, 0);echo $dt->endOfCentury(); // 2100-12-31 23:59:59 世紀的結束？為什么不是2099-12-31 23:59:59？？？ $dt = Carbon::create(2012, 1, 31, 12, 0, 0); echo $dt->startOfWeek(); // 2012-01-30 00:00:00var_dump($dt->dayOfWeek == Carbon::MONDAY); // bool(true) : ISO8601 week starts on Monday ISO8601標準每周的開始是周一，老外好像認為每周的開始是周日…… $dt = Carbon::create(2012, 1, 31, 12, 0, 0);echo $dt->endOfWeek(); // 2012-02-05 23:59:59var_dump($dt->dayOfWeek == Carbon::SUNDAY); // bool(true) : ISO8601 week ends on Sunday $dt = Carbon::create(2012, 1, 31, 12, 0, 0); echo $dt->next(Carbon::WEDNESDAY); // 2012-02-01 00:00:00 傳了參數表示“下一個周三”，不傳表示“明天” var_dump($dt->dayOfWeek == Carbon::WEDNESDAY); // bool(true) $dt = Carbon::create(2012, 1, 1, 12, 0, 0); echo $dt->next(); // 2012-01-08 00:00:00 $dt = Carbon::create(2012, 1, 31, 12, 0, 0); echo $dt->previous(Carbon::WEDNESDAY); // 2012-01-25 00:00:00 傳了參數表示“上一個周三”，不傳表示“昨天”var_dump($dt->dayOfWeek == Carbon::WEDNESDAY); // bool(true) $dt = Carbon::create(2012, 1, 1, 12, 0, 0);echo $dt->previous(); // 2011-12-25 00:00:00$start = Carbon::create(2014, 1, 1, 0, 0, 0); $end = Carbon::create(2014, 1, 30, 0, 0, 0); echo $start->average($end); // 2014-01-15 12:00:00 (1+30)/2 = 15 int運算 echo Carbon::create(2014, 5, 30, 0, 0, 0)->firstOfMonth(); // 2014-05-01 00:00:00 這個月的第一天 echo Carbon::create(2014, 5, 30, 0, 0, 0)->firstOfMonth(Carbon::MONDAY); // 2014-05-05 00:00:00 這個月的第一個周一echo Carbon::create(2014, 5, 30, 0, 0, 0)->lastOfMonth(); // 2014-05-31 00:00:00 這個月的最后一天 echo Carbon::create(2014, 5, 30, 0, 0, 0)->lastOfMonth(Carbon::TUESDAY); // 2014-05-27 00:00:00 這個月的最后一個周二 echo Carbon::create(2014, 5, 30, 0, 0, 0)->nthOfMonth(2, Carbon::SATURDAY); // 2014-05-10 00:00:00 這個月的第“2”個“周六”，2和周六是參數 echo Carbon::create(2014, 5, 30, 0, 0, 0)->firstOfQuarter(); // 2014-04-01 00:00:00 這個季度的第一天（5月是第二個季度，所以是4月1號） echo Carbon::create(2014, 5, 30, 0, 0, 0)->firstOfQuarter(Carbon::MONDAY); // 2014-04-07 00:00:00 這個季度的第一個周一 echo Carbon::create(2014, 5, 30, 0, 0, 0)->lastOfQuarter(); // 2014-06-30 00:00:00 這個季度的最后一天 echo Carbon::create(2014, 5, 30, 0, 0, 0)->lastOfQuarter(Carbon::TUESDAY); // 2014-06-24 00:00:00 這個季度的最后一個周二echo Carbon::create(2014, 5, 30, 0, 0, 0)->nthOfQuarter(2, Carbon::SATURDAY); // 2014-04-12 00:00:00 這個季度的第“2”個“周六”，2和周六是參數echo Carbon::create(2014, 5, 30, 0, 0, 0)->startOfQuarter(); // 2014-04-01 00:00:00 這個季度的開始 echo Carbon::create(2014, 5, 30, 0, 0, 0)->endOfQuarter(); // 2014-06-30 23:59:59 這個季度的結束echo Carbon::create(2014, 5, 30, 0, 0, 0)->firstOfYear(); // 2014-01-01 00:00:00 同上…… echo Carbon::create(2014, 5, 30, 0, 0, 0)->firstOfYear(Carbon::MONDAY); // 2014-01-06 00:00:00 echo Carbon::create(2014, 5, 30, 0, 0, 0)->lastOfYear(); // 2014-12-31 00:00:00 echo Carbon::create(2014, 5, 30, 0, 0, 0)->lastOfYear(Carbon::TUESDAY); // 2014-12-30 00:00:00echo Carbon::create(2014, 5, 30, 0, 0, 0)->nthOfYear(2, Carbon::SATURDAY); // 2014-01-11 00:00:00 echo Carbon::create(2018, 2, 23, 0, 0, 0)->nextWeekday(); // 2018-02-26 00:00:00 下周一echo Carbon::create(2018, 2, 23, 0, 0, 0)->previousWeekday(); // 2018-02-22 00:00:00 這周的上一個工作日 echo Carbon::create(2018, 2, 21, 0, 0, 0)->nextWeekendDay(); // 2018-02-24 00:00:00 即將要過的周末的第一天（即這星期的周六，如果今天是周六，則結果是周日） echo Carbon::create(2018, 2, 21, 0, 0, 0)->previousWeekendDay(); // 2018-02-18 00:00:00 剛過完的周末的最后一個（即上一周的周日，如果今天是周日，則結果是周六）
下面的常數是在Carbon中定義的。
// These getters specifically return integers, ie intval()
var_dump(Carbon::SUNDAY); // int(0)
var_dump(Carbon::MONDAY); // int(1)
var_dump(Carbon::TUESDAY); // int(2)
var_dump(Carbon::WEDNESDAY); // int(3)
var_dump(Carbon::THURSDAY); // int(4)
var_dump(Carbon::FRIDAY); // int(5)
var_dump(Carbon::SATURDAY); // int(6)
var_dump(Carbon::YEARS_PER_CENTURY); // int(100)var_dump(Carbon::YEARS_PER_DECADE); // int(10)
var_dump(Carbon::MONTHS_PER_YEAR); // int(12)var_dump(Carbon::WEEKS_PER_YEAR); // int(52)var_dump(Carbon::DAYS_PER_WEEK); // int(7)
var_dump(Carbon::HOURS_PER_DAY); // int(24)
var_dump(Carbon::MINUTES_PER_HOUR); // int(60)
var_dump(Carbon::SECONDS_PER_MINUTE); // int(60)$dt = Carbon::createFromDate(2012, 10, 6);
if ($dt->dayOfWeek === Carbon::SATURDAY) {
echo 'Place bets on Ottawa Senators Winning!';
}Carbon實例能被序列化的。
$dt = Carbon::create(2012, 12, 25, 20, 30, 00, 'Europe/Moscow');
echo serialize($dt); // O:13:"Carbon\Carbon":3:{s:4:"date";s:26:"2012-12-25 20:30:00.000000";s:13:"timezone_type";i:3;s:8:"timezone";s:13:"Europe/Moscow";}
// 等同于:echo $dt->serialize(); // O:13:"Carbon\Carbon":3:{s:4:"date";s:26:"2012-12-25 20:30:00.000000";s:13:"timezone_type";i:3;s:8:"timezone";s:13:"Europe/Moscow";}$dt = 'O:13:"Carbon\Carbon":3:{s:4:"date";s:26:"2012-12-25 20:30:00.000000";s:13:"timezone_type";i:3;s:8:"timezone";s:13:"Europe/Moscow";}';
echo unserialize($dt)->format('Y-m-d\TH:i:s.uP T'); // 2012-12-25T20:30:00.000000+04:00 MSK// 等同于:echo Carbon::fromSerialized($dt)->format('Y-m-d\TH:i:s.uP T'); // 2012-12-25T20:30:00.000000+04:00 MSKCarbon實例可以從JSON編碼和解碼(這些特性只能從PHP 5.4+中獲得，參見下面關于PHP 5.3的注釋)。
$dt = Carbon::create(2012, 12, 25, 20, 30, 00, 'Europe/Moscow');
echo json_encode($dt);
// {"date":"2012-12-25 20:30:00.000000","timezone_type":3,"timezone":"Europe\/Moscow"}
$json = '{"date":"2012-12-25 20:30:00.000000","timezone_type":3,"timezone":"Europe\/Moscow"}';
$dt = Carbon::__set_state(json_decode($json, true));echo $dt->format('Y-m-d\TH:i:s.uP T');
// 2012-12-25T20:30:00.000000+04:00 MSK您可以使用serializeUsing()自定義序列化。
$dt = Carbon::create(2012, 12, 25, 20, 30, 00, 'Europe/Moscow');
Carbon::serializeUsing(function ($date) {
return $date->getTimestamp();
});
echo json_encode($dt);
/*
1356453000
*/// Call serializeUsing with null to reset the serializer:Carbon::serializeUsing(null);jsonSerialize()方法返回中間通過“json_encode”將其轉換為字符串，它還允許您使用PHP 5.3兼容性。
$dt = Carbon::create(2012, 12, 25, 20, 30, 00, 'Europe/Moscow');
echo json_encode($dt->jsonSerialize());// {"date":"2012-12-25 20:30:00.000000","timezone_type":3,"timezone":"Europe\/Moscow"}
// This is equivalent to the first json_encode example but works with PHP 5.3.
// And it can be used separately:
var_dump($dt->jsonSerialize());
// array(3) {
["date"]=>
string(26) "2012-12-25 20:30:00.000000"
["timezone_type"]=>
int(3)["timezone"]=>
string(13) "Europe/Moscow"
}如果您習慣于使用Laravel和對象(如響應或集合)，您可能熟悉這個宏概念。Carbon macro()的工作方式與Laravel宏特性相同，它將方法名作為第一個參數，閉包作為第二個參數。這使得閉包操作可以作為一個具有給定名稱的方法在所有Carbon實例(也可以作為Carbon static方法)上使用。
在PHP 5.4中，$this可用于閉包中引用當前實例。對于PHP 5.3的兼容性，我們還向閉包添加了一個“$self”屬性。例子:
Carbon::macro('diffFromYear', function ($year, $self = null) {// 這個塊是為了在獨立的Carbon上與PHP版本< 5.4和Laravel兼容if (!isset($self) && isset($this)) {
$self = $this;
}
//兼容性塊的結束。
return $self->diffForHumans(Carbon::create($year, 1, 1, 0, 0, 0), false, false, 3);
});
echo Carbon::parse('2020-01-12 12:00:00')->diffFromYear(2019); // 1 year 1 week 4 days after兼容性塊允許您確保宏的完全兼容性。一個關于Illuminate\Support\Carbon (Laravel包裝類)的宏將不會被定義，正如上面在PHP 5.3 $this中提到的，這個不會被定義。要使宏在任何地方都能工作，只需粘貼這個if語句測試如果它是定義的，而不是$self然后復制它，然后在函數體中使用$self。
不管您是否省略了一些可選參數，只要$self有這個名稱，并且是最后一個參數:
Carbon::macro('diffFromYear', function ($year, $absolute = false, $short = false, $parts = 1, $self = null) {
// compatibility chunk
if (!isset($self) && isset($this)) {
$self = $this;
}return $self->diffForHumans(Carbon::create($year, 1, 1, 0, 0, 0), $absolute, $short, $parts);
});echo Carbon::parse('2020-01-12 12:00:00')->diffFromYear(2019); // 1 year after
echo Carbon::parse('2020-01-12 12:00:00')->diffFromYear(2019, true); // 1 year
echo Carbon::parse('2020-01-12 12:00:00')->diffFromYear(2019, true, true); // 1yr
echo Carbon::parse('2020-01-12 12:00:00')->diffFromYear(2019, true, true, 5); // 1yr 1w 4d 12h還可以將宏分組到類中，并與mixin()一起應用
Class BeerDayCarbonMixin {
public function nextBeerDay()
{
return function ($self = null) {
// compatibility chunk
if (!isset($self) && isset($this)) {
$self = $this;
}return $self->modify('next wednesday');
};
}
public function previousBeerDay(){
return function ($self = null) {// compatibility chunkif (!isset($self) && isset($this)) {$self = $this;
}return $self->modify('previous wednesday');
};
}
}Carbon::mixin(new BeerDayCarbonMixin());$date = Carbon::parse('First saturday of December 2018');
echo $date->previousBeerDay(); // 2018-11-28 00:00:00
echo $date->nextBeerDay(); // 2018-12-05 00:00:00您可以用hasMacro()檢查是否可用宏(包括mixin)
var_dump(Carbon::hasMacro('previousBeerDay')); // bool(true)
var_dump(Carbon::hasMacro('diffFromYear')); // bool(true)
var_dump(Carbon::hasMacro('dontKnowWhat')); // bool(false)你猜怎么著?在CarbonInterval和CarbonPeriod類上也可以使用所有的宏方法。
CarbonInterval::macro('twice', function ($self = null) {
return $self->times(2);
});
echo CarbonInterval::day()->twice()->forHumans(); // 2 days
echo CarbonInterval::hours(2)->minutes(15)->twice()->forHumans(true); // 4h 30m
CarbonPeriod::macro('countWeekdays', function ($self = null) {
return $self->filter('isWeekday')->count();
});
echo CarbonPeriod::create('2017-11-01', '2017-11-30')->countWeekdays(); //echo CarbonPeriod::create('2017-12-01', '2017-12-31')->countWeekdays(); //以下是社區提出的一些有用的宏:
Carbon::macro('isHoliday', function ($self = null) {
// compatibility chunk
if (!isset($self) && isset($this)) {
$self = $this;
}
return in_array($self->format('d/m'), [
'25/12', // Christmas
'01/01', // New Year// ...
]);
});
var_dump(Carbon::createMidnightDate(2012, 12, 25)->isHoliday()); // bool(true)var_dump(Carbon::createMidnightDate(2017, 6, 25)->isHoliday()); // bool(false)
var_dump(Carbon::createMidnightDate(2021, 1, 1)->isHoliday()); // bool(true)檢查cmixin/業務日以獲得更完整的業務日處理程序。
Class CurrentDaysCarbonMixin {
/**
* Get the all dates of week
. *
* [[@return](https://learnku.com/users/31554)](https://learnku.com/users/31554) array
*/
public static function getCurrentWeekDays()
{
return function ($self = null) {// compatibility chunkif (!isset($self) && isset($this)) {
$self = $this;}
$startOfWeek = ($self ?: static::now())->startOfWeek()->subDay();
$weekDays = array();
for ($i = 0; $i < static::DAYS_PER_WEEK; $i++) {
$weekDays[] = $startOfWeek->addDay()->startOfDay()->copy();
}
return $weekDays;
};
}/**
* Get the all dates of month
*
*/public static function getCurrentMonthDays()
{return function ($self = null) {// compatibility chunkif (!isset($self) && isset($this)) {
$self = $this;
}$startOfMonth = ($self ?: static::now())->startOfMonth()->subDay();$endOfMonth = ($self ?: static::now())->endOfMonth()->format('d');
$monthDays = array();
for ($i = 0; $i < $endOfMonth; $i++)
{
$monthDays[] = $startOfMonth->addDay()->startOfDay()->copy();
}
return $monthDays;
};
}
}
Carbon::mixin(new CurrentDaysCarbonMixin());
function dumpDateList($dates) {echo substr(implode(', ', $dates), 0, 100).'...';
}dumpDateList(Carbon::getCurrentWeekDays()); // 2018-07-02 00:00:00, 2018-07-03 00:00:00, 2018-07-04 00:00:00, 2018-07-05 00:00:00, 2018-07-06 00:00...
dumpDateList(Carbon::getCurrentMonthDays()); // 2018-07-01 00:00:00, 2018-07-02 00:00:00, 2018-07-03 00:00:00, 2018-07-04 00:00:00, 2018-07-05 00:00...
dumpDateList(Carbon::now()->subMonth()->getCurrentWeekDays()); // 2018-06-04 00:00:00, 2018-06-05 00:00:00, 2018-06-06 00:00:00, 2018-06-07 00:00:00, 2018-06-08 00:00...
dumpDateList(Carbon::now()->subMonth()->getCurrentMonthDays()); // 2018-06-01 00:00:00, 2018-06-02 00:00:00, 2018-06-03 00:00:00, 2018-06-04 00:00:00, 2018-06-05 00:00...
Carbon::macro('toAtomStringWithNoTimezone', function ($self = null) {
// compatibility chunk
if (!isset($self) && isset($this)) {
$self = $this;
}
return $self->format('Y-m-d\TH:i:s');
});
echo Carbon::parse('2021-06-16 20:08:34')->toAtomStringWithNoTimezone(); // 2021-06-16T20:08:34
*Credit: afrojuju1 (#1063).*
Carbon::macro('easterDate', function ($year) {
return Carbon::createMidnightDate($year, 3, 21)->addDays(easter_days($year));
});
echo Carbon::easterDate(2015)->format('d/m'); // 05/04
echo Carbon::easterDate(2016)->format('d/m'); // 27/03
echo Carbon::easterDate(2017)->format('d/m'); // 16/04
echo Carbon::easterDate(2018)->format('d/m'); // 01/04
echo Carbon::easterDate(2019)->format('d/m'); // 21/04查看cmixin/工作日以獲得更完整的假日處理程序。
Carbon::macro('range', function ($startDate, $endDate) {
return new DatePeriod($startDate, new DateInterval('P1D'), $endDate);
});
foreach (Carbon::range(Carbon::createMidnightDate(2019, 3, 28), Carbon::createMidnightDate(2019, 4, 3)) as $date) {
echo "$date\n";
}
/*
2019-03-28 00:00:00
2019-03-29 00:00:00
2019-03-30 00:00:00
2019-03-31 00:00:00
. 2019-04-01 00:00:00
2019-04-02 00:00:00
*/
class UserTimezoneCarbonMixin
{
public $userTimeZone;
/**
* Set user timezone, will be used before format function to apply current user timezone
*
* @param $timezone
*/
public function setUserTimezone()
{
$mixin = $this;
return function ($timezone) use ($mixin) {$mixin->userTimeZone = $timezone;
};
}
/**
* Returns date formatted according to given format.
*
* @param string $format
. *
*
* @link http://php.net/manual/en/datetime.format.php
*/public function tzFormat()
{
$mixin = $this;return function ($format, $self = null) use ($mixin) {
// compatibility chunk
if (!isset($self) && isset($this)) {
$self = $this;
}if (!is_null($mixin->userTimeZone)) {
$self->timezone($mixin->userTimeZone);
}
return $self->format($format);
};
}
}Carbon::mixin(new UserTimezoneCarbonMixin());
Carbon::setUserTimezone('Europe/Berlin');
echo Carbon::createFromTime(12, 0, 0, 'UTC')->tzFormat('H:i'); // 14:00echo Carbon::createFromTime(15, 0, 0, 'UTC')->tzFormat('H:i'); // 17:00
Carbon::setUserTimezone('America/Toronto');
echo Carbon::createFromTime(12, 0, 0, 'UTC')->tzFormat('H:i'); // 08:00
echo Carbon::createFromTime(15, 0, 0, 'UTC')->tzFormat('H:i'); // 11:00CarbonInterval類繼承了PHP DateInterval類。
<?php class CarbonInterval extends \DateInterval
{
// code here
}你可以通過以下方式創建實例
echo CarbonInterval::year(); // 1 year echo CarbonInterval::months(3); // 3 monthsecho CarbonInterval::days(3)->seconds(32); // 3 days 32 seconds echo CarbonInterval::weeks(3); // 3 weeks echo CarbonInterval::days(23); // 3 weeks 2 days echo CarbonInterval::create(2, 0, 5, 1, 1, 2, 7); // 2 years 5 weeks 1 day 1 hour 2 minutes 7 seconds
如果您發現自己從另一個庫繼承了\DateInterval實例，不要害怕!您可以通過一個友好的instance()函數創建一個CarbonInterval實例。
$di = new \DateInterval('P1Y2M'); // <== instance from another API$ci = CarbonInterval::instance($di);echo get_class($ci); // 'Carbon\CarbonInterval'
echo $ci; // 1 year 2 months其他的幫助程序，但是要注意實現提供了幫助程序來處理幾周，但是只節省了幾天。數周是根據當前實例的總天數計算的。
echo CarbonInterval::year()->years; //
echo CarbonInterval::year()->dayz; //
echo CarbonInterval::days(24)->dayz; //
echo CarbonInterval::days(24)->daysExcludeWeeks; //
echo CarbonInterval::weeks(3)->days(14)->weeks; // 2 <-- days setter overwrites the current value
echo CarbonInterval::weeks(3)->weeks; //
echo CarbonInterval::minutes(3)->weeksAndDays(2, 5); // 2 weeks 5 days 3 minutesCarbonInterval擴展DateInterval，您可以使用ISO-8601的持續時間格式創建這兩種格式:
$ci = CarbonInterval::create('P1Y2M3D');
$ci = new CarbonInterval('PT0S');借助fromString()方法，可以從友好的字符串創建Carbon intervals。
CarbonInterval::fromString('2 minutes 15 seconds');
CarbonInterval::fromString('2m 15s'); // or abbreviated注意這個月縮寫為“mo”以區別于分鐘和整個語法不區分大小寫。
它還有一個方便的for human()，它被映射為__toString()實現，用于為人類打印間隔。
CarbonInterval::setLocale('fr');
echo CarbonInterval::create(2, 1)->forHumans(); // 2 ans 1 mois
echo CarbonInterval::hour()->seconds(3); // 1 heure 3 secondes
CarbonInterval::setLocale('en');如您所見，您可以使用CarbonInterval::setLocale(‘fr’)更改字符串的語言環境。
至于Carbon，您可以使用make方法從其他區間或字符串返回一個新的CarbonInterval實例:
$dateInterval = new DateInterval('P2D');$carbonInterval = CarbonInterval::month();
echo CarbonInterval::make($dateInterval)->forHumans(); // 2 days
echo CarbonInterval::make($carbonInterval)->forHumans(); // 1 month
echo CarbonInterval::make('PT3H')->forHumans(); // 3 hours
echo CarbonInterval::make('1h 15m')->forHumans(); // 1 hour 15 minutes// Pass true to get short format
echo CarbonInterval::make('1h 15m')->forHumans(true); // 1h 15m本機DateInterval分別添加和相乘，因此:
$interval = CarbonInterval::make('7h 55m');
$interval->add(CarbonInterval::make('17h 35m'));
$interval->times(3);
echo $interval->forHumans(); // 72 hours 270 minutes從單位到單位的輸入中得到純計算。將分鐘級聯成小時、小時級聯成天等。使用級聯方法:
echo $interval->forHumans(); // 72 hours 270 minutes echo $interval->cascade()->forHumans(); // 3 days 4 hours 30 minutes
默認的因素有:
1分鐘= 60秒
1小時=60分鐘
1天=24小時
1周= 7天
1個月= 4周
1年= 12個月
CarbonIntervals 沒有上下文，所以它們不能更精確(沒有DST、沒有閏年、沒有實際的月長或年長)。但是你可以完全定制這些因素。例如處理工作時間日志:
$cascades = CarbonInterval::getCascadeFactors(); // save initial factors
CarbonInterval::setCascadeFactors(array(
'minute' => array(60, 'seconds')
'hour' => array(60, 'minutes'),
'day' => array(8, 'hours'),
'week' => array(5, 'days'),
// in this example the cascade won't go farther than week unit
));
echo CarbonInterval::fromString('20h')->cascade()->forHumans(); // 2 days 4 hours
echo CarbonInterval::fromString('10d')->cascade()->forHumans(); // 2 weeks
echo CarbonInterval::fromString('3w 18d 53h 159m')->cascade()->forHumans(); // 7 weeks 4 days 7 hours 39 minutes
// You can see currently set factors with getFactor:
echo CarbonInterval::getFactor('minutes', /* per */ 'hour'); //
echo CarbonInterval::getFactor('days', 'week'); // 5
// And common factors can be get with short-cut methods:
echo CarbonInterval::getDaysPerWeek(); //echo CarbonInterval::getHoursPerDay(); //
echo CarbonInterval::getMinutesPerHours(); //echo CarbonInterval::getSecondsPerMinutes(); //
CarbonInterval::setCascadeFactors($cascades); // restore original factors是否可能將間隔轉換為給定的單元(使用提供的級聯因子)。
echo CarbonInterval::days(3)->hours(5)->total('hours'); //
echo CarbonInterval::days(3)->hours(5)->totalHours; //
echo CarbonInterval::months(6)->totalWeeks; //echo CarbonInterval::year()->totalDays; //您還可以使用spec()獲得inverval的ISO 8601規范
echo CarbonInterval::days(3)->hours(5)->spec(); // P3DT5H
也可以從DateInterval對象獲取它，因為它是靜態助手:
echo CarbonInterval::getDateIntervalSpec(new DateInterval('P3DT6M10S')); // P3DT6M10S使用compare()和comparedateinterval()方法可以對日期間隔列表進行排序:
$halfDay = CarbonInterval::hours(12);
$oneDay = CarbonInterval::day();
$twoDay = CarbonInterval::days(2);
echo CarbonInterval::compareDateIntervals($oneDay, $oneDay); //
echo $oneDay->compare($oneDay); //
echo CarbonInterval::compareDateIntervals($oneDay, $halfDay); //
echo $oneDay->compare($halfDay); //
echo CarbonInterval::compareDateIntervals($oneDay, $twoDay); // -1
echo $oneDay->compare($twoDay); // -1
$list = array($twoDay, $halfDay, $oneDay);usort($list, array('Carbon\CarbonInterval', 'compareDateIntervals'));
echo implode(', ', $list); // 12 hours, 1 day, 2 days最后，通過使用互補參數調用toPeriod()，可以將一個CarbonInterval實例轉換為一個CarbonPeriod實例。
我聽到你問什么是CarbonPeriod 實例。哦!完美過渡到下一章。
CarbonPeriod是一個友好的DatePeriod版本，具有許多快捷方式。
// Create a new instance:
$period = new CarbonPeriod('2018-04-21', '3 days', '2018-04-27');
// Use static constructor:
$period = CarbonPeriod::create('2018-04-21', '3 days', '2018-04-27');
// Use the fluent setters:
$period = CarbonPeriod::since('2018-04-21')->days(3)->until('2018-04-27');
// Start from a CarbonInterval:
$period = CarbonInterval::days(3)->toPeriod('2018-04-21', '2018-04-27');CarbonPeriod可以通過多種方式構建:
開始日期、結束日期和可選間隔(默認為1天)，
起始日期，遞歸次數和可選區間，
ISO 8601間隔規范。
日期可以是DateTime/Carbon實例，絕對字符串如“2007-10-15 15:00”或相對字符串，例如“next monday”。Interval可以作為DateInterval/CarbonInterval實例、ISO 8601的Interval規范(如“P4D”)或人類可讀字符串(如“4 days”)給出。
默認構造函數和create()方法在參數類型和順序方面都很容易理解，所以如果您想要更精確，建議使用fluent語法。另一方面，您可以將動態值數組傳遞給createFromArray()，它將使用給定的數組作為參數列表構造一個新實例。
CarbonPeriod實現迭代器接口。它意味著它可以直接傳遞給foreach循環:
$period = CarbonPeriod::create('2018-04-21', '3 days', '2018-04-27');
foreach ($period as $key => $date) {
if ($key) {
echo ', ';
}
echo $date->format('m-d');
}// 04-21, 04-24, 04-27// Here is what happens under the hood:$period->rewind(); // restart the iteration
while ($period->valid()) { // check if current item is valid
if ($period->key()) { // echo comma if current key is greater than 0
echo ', ';
}echo $period->current()->format('m-d'); // echo current date$period->next(); // move to the next item
}// 04-21, 04-24, 04-27參數可以在迭代過程中進行修改:
$period = CarbonPeriod::create('2018-04-29', 7);
$dates = array();
foreach ($period as $key => $date) {
if ($key === 3) {
$period->invert()->start($date); // invert() is an alias for invertDateInterval()
}
$dates[] = $date->format('m-d');
}
echo implode(', ', $dates); // 04-29, 04-30, 05-01, 05-02, 05-01, 04-30, 04-29和DatePeriod一樣，CarbonPeriod也支持ISO 8601時間間隔規范。
請注意，本機日期周期將遞歸處理為多次重復間隔。因此，在排除開始日期時，它將減少一個結果。CarbonPeriod的自定義過濾器的引入使得知道結果的數量變得更加困難。由于這個原因，我們稍微改變了實現，遞歸被視為返回日期的總體限制。
// Possible options are: CarbonPeriod::EXCLUDE_START_DATE | CarbonPeriod::EXCLUDE_END_DATE
// Default value is 0 which will have the same effect as when no options are given.
$period = CarbonPeriod::createFromIso('R4/2012-07-01T00:00:00Z/P7D', CarbonPeriod::EXCLUDE_START_DATE);
$dates = array();
foreach ($period as $date) {
$dates[] = $date->format('m-d');
}
echo implode(', ', $dates); // 07-08, 07-15, 07-22, 07-29您可以從不同的getter中檢索數據:
$period = CarbonPeriod::create('2010-05-06', '2010-05-25', CarbonPeriod::EXCLUDE_START_DATE);
$exclude = $period->getOptions() & CarbonPeriod::EXCLUDE_START_DATE;
echo $period->getStartDate(); // 2010-05-06 00:00:00
echo $period->getEndDate(); // 2010-05-25 00:00:00
echo $period->getDateInterval(); // 1 dayecho $exclude ? 'exclude' : 'include'; // exclude
var_dump($period->isStartExcluded()); // bool(true)var_dump($period->isEndExcluded()); // bool(false)echo $period->toString(); // Every 1 day from 2010-05-06 to 2010-05-25
echo $period; /*implicit toString*/ // Every 1 day from 2010-05-06 to 2010-05-25附加的getter允許您以數組的形式訪問結果:
$period = CarbonPeriod::create('2010-05-11', '2010-05-13');
echo $period->count(); // 3, equivalent to count($period)echo implode(', ', $period->toArray()); // 2010-05-11 00:00:00, 2010-05-12 00:00:00, 2010-05-13 00:00:00
echo $period->first(); // 2010-05-11 00:00:00
echo $period->last(); // 2010-05-13 00:00:00注意，如果您打算使用上述函數，將toArray()調用的結果存儲為變量并使用它是一個好主意，因為每個調用在內部執行一個完整的迭代。
想要更改參數，可以使用setter方法:
$period = CarbonPeriod::create('2010-05-01', '2010-05-14', CarbonPeriod::EXCLUDE_END_DATE);
$period->setStartDate('2010-05-11');
echo implode(', ', $period->toArray()); // 2010-05-11 00:00:00, 2010-05-12 00:00:00, 2010-05-13 00:00:00
// Second argument can be optionally used to exclude the date from the results.
$period->setStartDate('2010-05-11', false);
$period->setEndDate('2010-05-14', true);
echo implode(', ', $period->toArray()); // 2010-05-12 00:00:00, 2010-05-13 00:00:00, 2010-05-14 00:00:00
$period->setRecurrences(2);
echo implode(', ', $period->toArray()); // 2010-05-12 00:00:00, 2010-05-13 00:00:00
$period->setDateInterval('PT12H');
echo implode(', ', $period->toArray()); // 2010-05-11 12:00:00, 2010-05-12 00:00:00您可以使用setOptions()更改選項以替換所有選項，但也可以分別更改:
$period = CarbonPeriod::create('2010-05-06', '2010-05-25');var_dump($period->isStartExcluded()); // bool(false)
var_dump($period->isEndExcluded()); // bool(false)
$period->toggleOptions(CarbonPeriod::EXCLUDE_START_DATE, true); // true, false or nothing to invert the option
var_dump($period->isStartExcluded()); // bool(true)
var_dump($period->isEndExcluded()); // bool(false) (unchanged)
$period->excludeEndDate(); // specify false to include, true or omit to excludevar_dump($period->isStartExcluded()); // bool(true) (unchanged)var_dump($period->isEndExcluded()); // bool(true)
$period->excludeStartDate(false); // specify false to include, true or omit to excludevar_dump($period->isStartExcluded()); // bool(false)var_dump($period->isEndExcluded()); // bool(true)如前所述，根據ISO 8601規范，遞歸是重復間隔的數倍。因此，本機DatePeriod將根據開始日期的排除而改變返回日期的數量。與此同時，CarbonPeriod在輸入和允許自定義過濾器方面更加寬容，將遞歸作為返回日期的總體限制:
$period = CarbonPeriod::createFromIso('R4/2012-07-01T00:00:00Z/P7D');
$days = array();
foreach ($period as $date) {
$days[] = $date->format('d');
}
echo $period->getRecurrences(); //
echo implode(', ', $days); // 01, 08, 15, 22$days = array();$period->setRecurrences(3)->excludeStartDate();foreach ($period as $date) {
$days[] = $date->format('d');}
echo $period->getRecurrences(); //
echo implode(', ', $days); // 08, 15, 22
$days = array();
$period = CarbonPeriod::recurrences(3)->sinceNow();foreach ($period as $date) {$days[] = $date->format('Y-m-d');}
echo implode(', ', $days); // 2018-07-05, 2018-07-06, 2018-07-07DatePeriod返回的日期可以很容易地過濾。例如，過濾器可以用于跳過某些日期或只在工作日或周末迭代。篩選函數應該返回true以接受日期，返回false以跳過日期，但繼續搜索或CarbonPeriod::END_ITERATION以結束迭代。
$period = CarbonPeriod::between('2000-01-01', '2000-01-15');
$weekendFilter = function ($date) {
return $date->isWeekend();
};
$period->filter($weekendFilter);
$days = array();foreach ($period as $date) {
$days[] = $date->format('m-d');}
echo implode(', ', $days); // 01-01, 01-02, 01-08, 01-09, 01-15您還可以跳過循環中的一個或多個值。
$period = CarbonPeriod::between('2000-01-01', '2000-01-10');
$days = array();
foreach ($period as $date) {
$day = $date->format('m-d');
$days[] = $day;
if ($day === '01-04') {
$period->skip(3);
}
}echo implode(', ', $days); // 01-01, 01-02, 01-03, 01-04, 01-08, 01-09, 01-10getFilters()允許您在一個時間段內檢索所有存儲的過濾器。但是要注意遞歸限制和結束日期將出現在返回的數組中，因為它們作為過濾器存儲在內部。
$period = CarbonPeriod::end('2000-01-01')->recurrences(3);var_export($period->getFilters());
/*
array (
0 =>
array (
0 => 'Carbon\\CarbonPeriod::filterEndDate',
1 => NULL,
),
1 =>
array (
0 => 'Carbon\\CarbonPeriod::filterRecurrences',
1 => NULL,
),
)
*/過濾器存儲在堆棧中，可以使用一組特殊的方法進行管理:
$period = CarbonPeriod::between('2000-01-01', '2000-01-15');
$weekendFilter = function ($date) {
return $date->isWeekend();
};
var_dump($period->hasFilter($weekendFilter)); // bool(false)
$period->addFilter($weekendFilter);
var_dump($period->hasFilter($weekendFilter)); // bool(true)
$period->removeFilter($weekendFilter);var_dump($period->hasFilter($weekendFilter)); // bool(false)
// To avoid storing filters as variables you can name your filters:$period->prependFilter(function ($date) {
return $date->isWeekend();}, 'weekend');var_dump($period->hasFilter('weekend')); // bool(true)
$period->removeFilter('weekend');
var_dump($period->hasFilter('weekend')); // bool(false)添加過濾器的順序會對性能和結果產生影響，因此您可以使用addFilter()在堆棧末尾添加過濾器;您可以使用prependFilter()在開始時添加一個。甚至可以使用setfilter()替換所有的過濾器。請注意，您必須保持堆棧的正確格式，并記住關于遞歸限制和結束日期的內部過濾器。或者，您可以使用resetFilters()方法，然后逐個添加新的過濾器。
例如，當您添加一個限制嘗試日期數量的自定義過濾器時，如果您在工作日過濾器之前或之后添加它，那么結果將是不同的。
// Note that you can pass a name of any Carbon method starting with "is", including macros
$period = CarbonPeriod::between('2018-05-03', '2018-05-25')->filter('isWeekday');
$attempts = 0;$attemptsFilter = function () use (&$attempts) {
return ++$attempts <= 5 ? true : CarbonPeriod::END_ITERATION;
};
$period->prependFilter($attemptsFilter, 'attempts');
$days = array();
foreach ($period as $date) {$days[] = $date->format('m-d');
}
echo implode(', ', $days); // 05-03, 05-04, 05-07
$attempts = 0;
$period->removeFilter($attemptsFilter)->addFilter($attemptsFilter, 'attempts');$days = array();
foreach ($period as $date) {
$days[] = $date->format('m-d');
}
echo implode(', ', $days); // 05-03, 05-04, 05-07, 05-08, 05-09注意，內置的遞歸過濾器不是這樣工作的。相反，它基于當前鍵，每個條目只增加一次，無論在找到有效日期之前需要檢查多少個日期。如果您將它放在堆棧的開頭或末尾，那么這個技巧將使它的工作方式相同。
為了簡化CarbonPeriod的構建，添加了一些別名:
// "start", "since", "sinceNow":
CarbonPeriod::start('2017-03-10') == CarbonPeriod::create()->setStartDate('2017-03-10');
// Same with optional boolean argument $inclusive to change the option about include/exclude start date:
CarbonPeriod::start('2017-03-10', true) == CarbonPeriod::create()->setStartDate('2017-03-10', true);
// "end", "until", "untilNow":
CarbonPeriod::end('2017-03-20') == CarbonPeriod::create()->setEndDate('2017-03-20');
// Same with optional boolean argument $inclusive to change the option about include/exclude end date:
CarbonPeriod::end('2017-03-20', true) == CarbonPeriod::create()->setEndDate('2017-03-20', true);
// "dates", "between":
CarbonPeriod::dates(..., ...) == CarbonPeriod::create()->setDates(..., ...);// "recurrences", "times":CarbonPeriod::recurrences(5) == CarbonPeriod::create()->setRecurrences(5);
// "options":CarbonPeriod::options(...) == CarbonPeriod::create()->setOptions(...);// "toggle":CarbonPeriod::toggle(..., true) == CarbonPeriod::create()->toggleOptions(..., true);// "filter", "push":CarbonPeriod::filter(...) == CarbonPeriod::create()->addFilter(...);// "prepend":
CarbonPeriod::prepend(...) == CarbonPeriod::create()->prependFilter(...);
// "filters":CarbonPeriod::filters(...) == CarbonPeriod::create()->setFilters(...);
// "interval", "each", "every", "step", "stepBy":CarbonPeriod::interval(...) == CarbonPeriod::create()->setDateInterval(...);// "invert":
CarbonPeriod::invert() == CarbonPeriod::create()->invertDateInterval();// "year", "months", "month", "weeks", "week", "days", "dayz", "day",// "hours", "hour", "minutes", "minute", "seconds", "second":
CarbonPeriod::hours(5) == CarbonPeriod::create()->setDateInterval(new CarbonInterval::hours(5));可以很容易地將CarbonPeriod轉換為人類可讀的字符串和ISO 8601規范:
$period = CarbonPeriod::create('2000-01-01 12:00', '3 days 12 hours', '2000-01-15 12:00');
echo $period->toString(); // Every 3 days 12 hours from 2000-01-01 12:00:00 to 2000-01-15 12:00:00
echo $period->toIso8601String(); // 2000-01-01T12:00:00-05:00/P3DT12H/2000-01-15T12:00:00-05:00感謝各位的閱讀，以上就是“Laravel Carbon擴展包的作用有哪些”的內容了，經過本文的學習后，相信大家對Laravel Carbon擴展包的作用有哪些這一問題有了更深刻的體會，具體使用情況還需要大家實踐驗證。這里是億速云，小編將為大家推送更多相關知識點的文章，歡迎關注！
免責聲明：本站發布的內容（圖片、視頻和文字）以原創、轉載和分享為主，文章觀點不代表本網站立場，如果涉及侵權請聯系站長郵箱：is@yisu.com進行舉報，并提供相關證據，一經查實，將立刻刪除涉嫌侵權內容。
