LaravelCarbon扩展包的作用有哪些

这篇文章主要讲解了“Laravel Carbon扩展包的作用有哪些”，文中的讲解内容简单清晰，易于学习与理解，下面请大家跟着小编的思路慢慢深入，一起来研究和学习“Laravel Carbon扩展包的作用有哪些”吧！

创新互联建站于2013年创立，是专业互联网技术服务公司，拥有项目网站设计、成都做网站网站策划，项目实施与项目整合能力。我们以让每一个梦想脱颖而出为使命，1280元博州做网站,已为上家服务,为博州各地企业和个人服务,联系电话:18980820575

Introduction

Carbon *继承了PHP的 *Datetime *类和JsonSerialiable。所以 *Carbon *中没有涉及到的，但在 *Datetime *和JsonSerializable*中已经实现的方法都是可以使用的。

 class  Carbon  extends  DateTime  implements  JsonSerializable

 {

 //code here}

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() *创建的实例进行比较时，默认是在当前时区下完成的。
Instantiation
有几种不同的方法可以创建一个新的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:00
NOTE*:在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。
Localization
不幸的是，基类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 locale
diffForHumans()也被定位。您可以通过使用静态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正确。
Testing Aids
测试方法允许您在创建“现在”实例时设置要返回的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/Paris
Getters
getter方法是通过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
Setters
下面的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';
Fluent Setters
对于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
IsSet
实现了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)
String Formatting
所有可用的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 Hs)，这是在发生类型杂耍时使用的格式。
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:16
NOTE:对于本地化支持，请参阅本地化部分。
Common Formats
下面是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"

 }

 }

*/
Comparison
通过以下函数提供了简单的比较。请记住，比较是在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!
Addition and Subtraction
默认的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() m            
            
                                

                    当前名称：LaravelCarbon扩展包的作用有哪些                    

                    本文网址：http://chengdu.cdxwcx.cn/article/gsecsp.html

甜橘子，专注成都网站制作网站设计与营销型网站建设与优化

首页

网站建设

网站制作案例

解决方案

网站设计报价

网站制作动态

关于我们

联系我们

成都网站建设设计将想法与焦点和您一起共享

LaravelCarbon扩展包的作用有哪些

Introduction

Instantiation

Localization

Testing Aids

Getters

Setters

Fluent Setters

IsSet

String Formatting

Common Formats

Comparison

Addition and Subtraction

其他资讯

[unity3d]unity中几个系统自带的函数的执行顺序-创新互联

iOS开发OC基础：延展Extension-创新互联

Java如何转换Excel为其他常见文档格式-创新互联

域名注册需要钱吗-创新互联

Qt中怎么通过自定义表头实现过滤功能-创新互联

甜橘子，专注成都网站制作网站设计与营销型网站建设与优化

成都网站建设设计 将想法与焦点和您一起共享

LaravelCarbon扩展包的作用有哪些

Introduction

Instantiation

Localization

Testing Aids

Getters

Setters

Fluent Setters

IsSet

String Formatting

Common Formats

Comparison

Addition and Subtraction

其他资讯

[unity3d]unity中几个系统自带的函数的执行顺序-创新互联

iOS开发OC基础：延展Extension-创新互联

Java如何转换Excel为其他常见文档格式-创新互联

域名注册需要钱吗-创新互联

Qt中怎么通过自定义表头实现过滤功能-创新互联

成都网站建设设计将想法与焦点和您一起共享