广告：宝塔Linux面板高效运维的服务器管理软件 点击【 https://www.bt.cn/p/uNLv1L 】立即购买

下面由Laravel教程栏目带大家推荐介绍关于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: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**）。***

  <?php use  Carbon\Carbon;0

创建异常发生在使用负值上，而不是在溢出上，要获取溢出上的异常，请使用createSafe()

  <?php use  Carbon\Carbon;1

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之前，它只会创建这个无效的日期。

  <?php use  Carbon\Carbon;2

createFromFormat()是最基本的php函数DateTime:::createFromFormat的包装器。不同的是，$tz参数可以是DateTimeZone实例或字符串时区值。此外，如果格式有错误，这个函数将调用DateTime::getLastErrors()方法，然后抛出一个InvalidArgumentException，错误作为消息。如果您查看上面的createXX()函数的源代码，它们都会调用createFromFormat()。

  <?php use  Carbon\Carbon;3

最后三个create函数用于使用unix时间戳。第一个将创建一个与给定的时间戳相等的Carbon实例，并将设置时区或默认为当前时区。第二个createFromTimestampUTC()是不同的，因为时区将保持UTC(GMT)。第二种方法与Carbon: createFromFormat(‘@’.$timestamp)的作用相同，但我只是让它更明确了一点。第三个是createFromTimestampMs()，它接受以毫秒而不是秒为单位的时间戳。也允许使用负时间戳。

  <?php use  Carbon\Carbon;4

您还可以copy()在现有Carbon实例上创建。如预期的那样，日期、时间和时区值都被复制到新实例。

  <?php use  Carbon\Carbon;5

// $dt 实例没有改变，任然是Carbon:now()

您可以在现有的Carbon实例上使用nowWithSameTz()来在相同的时区中获取一个新的实例。

  <?php use  Carbon\Carbon;6

最后，如果您发现自己从另一个库继承了\DateTime实例，不要害怕!您可以通过友好的instance()方法创建一个Carbon实例。或者使用更灵活的方法make()，它可以从DateTime、Carbon或string返回一个新的Carbon实例，否则它只返回null。

  <?php use  Carbon\Carbon;7

关于微秒的简要说明。PHP DateTime对象允许您设置一个微秒值，但是忽略它的所有日期数学。现在，1.12.0的Carbon在实例化或复制操作过程中支持微秒，并在默认情况下使用format()方法。

  <?php use  Carbon\Carbon;8

在PHP 7.1之前 DateTime微秒未添加到“now”实例，并且之后不能更改，这意味着:

  <?php use  Carbon\Carbon;9

为了解决这个限制，我们在PHP < 7.1中调用了microseconds，但是这个特性在需要时可以被禁用(PHP >= 7.1):

 $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);  //0

是否需要遍历一些日期以找到最早或最近的日期?不知道如何设置初始最大值/最小值?现在有两个助手可以帮助你做出简单的决定:

 $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);  //1

最小和最大值主要取决于系统(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()设置当前的语言环境，那么返回的字符串将被格式化为正确的语言环境。

 $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);  //2

diffForHumans()也被定位。您可以通过使用静态Carbon::setLocale()函数来设置Carbon locale()，并使用Carbon::getLocale()获取当前的设置。

 $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);  //3

或者，您可以将一些代码与给定的语言环境隔离:

 $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);  //4

有些语言需要打印utf8编码(主要以. utf8结尾的语言环境包)。在本例中，您可以使用静态方法"php

 $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);  //5

在Linux上

如果您在翻译方面有问题，请检查系统中安装的地区(本地和生产)。

区域设置-列出已启用的区域设置。

sudo locale-gen fr_FR。UTF-8安装一个新的语言环境。

sudo dpkg-reconfigure locale来发布所有启用的locale。

并重启系统。

您可以通过以下方式自定义现有语言:

 $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);  //6

请注意，您还可以使用另一个转换器Carbon::setTranslator($custom)，只要给定的转换器继承了Symfony\Component\Translation\TranslatorInterface。 因此，对格式本地化、getter(如localeMonth、localedayayofweek和短变体)的语言环境支持是由安装在操作系统中的语言环境驱动的。对于其他翻译，由于碳社区的支持，它在内部得到了支持。您可以使用以下方法检查支持的内容:

 $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);  //7

以下是最后一个碳版本支持的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方法的默认相对时间。

 $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);  //8

一个更有意义的完整例子:

 $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);  //9

根据给定的“now”实例，还可以对相关短语进行嘲笑。

 $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表示法国巴黎0

被认为是相对修饰语的单词列表如下:

请注意，与next()、previous()和modify()方法类似，这些相对修饰符中的一些将把时间设置为00:00。

 $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表示法国巴黎1

getter方法是通过PHP的__get()方法实现的。这使您能够像访问属性而不是函数调用那样访问值。

 $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表示法国巴黎2

下面的setter是通过PHP的__set()方法实现的。值得注意的是，除了显式地设置时区之外，任何设置程序都不会更改实例的时区。具体地说，设置时间戳不会将相应的时区设置为UTC。

 $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表示法国巴黎3

对于setter没有可选参数，但是函数定义中有足够的多样性，因此无论如何都不需要它们。值得注意的是，除了显式地设置时区之外，任何设置程序都不会更改实例的时区。具体地说，设置时间戳不会将相应的时区设置为UTC。

 $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表示法国巴黎4

您还可以将日期和时间与其他DateTime/Carbon对象分开设置:

 $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表示法国巴黎5

实现了PHP函数isset()。这是在一些外部系统(例如Twig)在使用属性之前验证属性的存在时完成的。这是使用isset()或empty()方法完成的。在PHP站点:isset()、isset()、empty()上，您可以阅读更多关于这些内容的信息。

 $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表示法国巴黎6

所有可用的toXXXString()方法都依赖于基类方法DateTime: format()。您将注意到__toString()方法的定义，它允许在字符串上下文中使用时将一个Carbon实例打印为一个漂亮的日期时间字符串。

 $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表示法国巴黎7

您还可以设置默认的__toString()格式(默认为Y-m-d Hs)，这是在发生类型杂耍时使用的格式。

 $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表示法国巴黎8

NOTE:对于本地化支持，请参阅本地化部分。

下面是DateTime类中提供的公共格式的包装器。

 $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表示法国巴黎9

通过以下函数提供了简单的比较。请记住，比较是在UTC时区进行的，所以事情并不总是像看上去的那样。

  $nowInLondonTz =  Carbon::now(new \DateTimeZone('Europe/London'));  // 或者以字符串形式只传时区  $nowInLondonTz =  Carbon::now('Europe/London');// 或者在DST期间创建一个时区为+1到GMT的日期，然后传递一个整数echo Carbon::now(1)->tzName;  // Europe/London0

这些方法使用PHP $date1 == $date2提供的自然比较，因此在PHP 7.1之前，所有方法都将忽略milli/micro-seconds，然后从7.1开始考虑它们。

要确定当前实例是否在其他两个实例之间，可以使用恰当命名的between()方法。第三个参数表示是否应该进行相等的比较。默认值是true，它决定了它的中间值还是等于边界。

  $nowInLondonTz =  Carbon::now(new \DateTimeZone('Europe/London'));  // 或者以字符串形式只传时区  $nowInLondonTz =  Carbon::now('Europe/London');// 或者在DST期间创建一个时区为+1到GMT的日期，然后传递一个整数echo Carbon::now(1)->tzName;  // Europe/London1

哇!你忘记了min()和max()了吗?不。这也被适当命名的min()和max()方法或minimum()和maximum()别名所覆盖。与往常一样，如果指定为null，则默认参数现在为。

  $nowInLondonTz =  Carbon::now(new \DateTimeZone('Europe/London'));  // 或者以字符串形式只传时区  $nowInLondonTz =  Carbon::now('Europe/London');// 或者在DST期间创建一个时区为+1到GMT的日期，然后传递一个整数echo Carbon::now(1)->tzName;  // Europe/London2

为了处理最常用的情况，这里有一些简单的帮助函数，希望它们的名称能很明显地反映出来。对于以某种方式与now() (ex.istoday()))进行比较的方法，now()是在与实例相同的时区创建的。

  $nowInLondonTz =  Carbon::now(new \DateTimeZone('Europe/London'));  // 或者以字符串形式只传时区  $nowInLondonTz =  Carbon::now('Europe/London');// 或者在DST期间创建一个时区为+1到GMT的日期，然后传递一个整数echo Carbon::now(1)->tzName;  // Europe/London3

默认的DateTime提供了几种不同的方法来方便地添加和减少时间。有modify()、add()和sub()。modify()使用一个魔术date/time格式字符串“last day of next month”，它解析并应用修改，而add()和sub()则期望一个不那么明显的日期间隔实例(例如新的\日期间隔(‘P6YT5M’)将意味着6年5分钟)。希望使用这些流畅的函数将会更加清晰，并且在几个星期内没有看到您的代码后更容易阅读。当然，我不会让您选择，因为基类函数仍然可用。

  $nowInLondonTz =  Carbon::now(new \DateTimeZone('Europe/London'));  // 或者以字符串形式只传时区  $nowInLondonTz =  Carbon::now('Europe/London');// 或者在DST期间创建一个时区为+1到GMT的日期，然后传递一个整数echo Carbon::now(1)->tzName;  // Europe/London4

为了好玩，您还可以将负值传递给addXXX()，实际上这就是subXXX()实现的方式。 附注:如果你忘记并使用addDay(5) 或subYear(3)，我支持你; 默认情况下，Carbon依赖于底层父类PHP DateTime行为。因此，增加或减少月份可能会溢出，例如:

  $nowInLondonTz =  Carbon::now(new \DateTimeZone('Europe/London'));  // 或者以字符串形式只传时区  $nowInLondonTz =  Carbon::now('Europe/London');// 或者在DST期间创建一个时区为+1到GMT的日期，然后传递一个整数echo Carbon::now(1)->tzName;  // Europe/London5

为了防止溢出Carbon:usemonthverflow (false)

  $nowInLondonTz =  Carbon::now(new \DateTimeZone('Europe/London'));  // 或者以字符串形式只传时区  $nowInLondonTz =  Carbon::now('Europe/London');// 或者在DST期间创建一个时区为+1到GMT的日期，然后传递一个整数echo Carbon::now(1)->tzName;  // Europe/London6

方法Carbon:::shouldOverflowMonths()允许您知道当前是否启用了溢出。您也可以使用->addMonthsNoOverflow， ->subMonthsNoOverflow， ->addMonthsWithOverflow， -> submonth withoverflow(或单数方法，不含s至“month”)，显式add/sub，无论当前模式如何，都可以添加或不添加溢出。

  $nowInLondonTz =  Carbon::now(new \DateTimeZone('Europe/London'));  // 或者以字符串形式只传时区  $nowInLondonTz =  Carbon::now('Europe/London');// 或者在DST期间创建一个时区为+1到GMT的日期，然后传递一个整数echo Carbon::now(1)->tzName;  // Europe/London7

从1.23.0版本开始，在以下年份也可以使用溢出控制:

  $nowInLondonTz =  Carbon::now(new \DateTimeZone('Europe/London'));  // 或者以字符串形式只传时区  $nowInLondonTz =  Carbon::now('Europe/London');// 或者在DST期间创建一个时区为+1到GMT的日期，然后传递一个整数echo Carbon::now(1)->tzName;  // Europe/London8

由于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，返回绝对值。

  $nowInLondonTz =  Carbon::now(new \DateTimeZone('Europe/London'));  // 或者以字符串形式只传时区  $nowInLondonTz =  Carbon::now('Europe/London');// 或者在DST期间创建一个时区为+1到GMT的日期，然后传递一个整数echo Carbon::now(1)->tzName;  // Europe/London9

关于夏令时(DST)的重要注意，默认情况下，PHP DateTime不考虑DST，这意味着，像2014年3月30日这样只有23小时的一天在伦敦将被计算为24小时。

 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:000

Carbon也遵循这种行为，增加/减少/降低秒/分钟/小时。但是我们提供了使用时间戳进行实时工作的方法:

 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:001

同样的方法可以使用addRealMinutes()、subRealMinutes()、addRealSeconds()、subRealSeconds()和所有它们的唯一快捷方式:addRealHour()、subRealHour()、addrealmin()、subRealMinute()、addRealSecond()、subRealSecond()。

还有特殊的过滤器函数diffindaysfilter()、diffinhoursfilter()和difffilter()，以帮助您按天数、小时或自定义间隔过滤差异。例如，计算两个实例之间的周末天数:

 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:002

所有的diffIn*滤波方法都采用1个可调用滤波器作为必要参数，一个date对象作为可选的第二个参数，如果缺失，使用now。您也可以将true作为第三个参数传递，以获得绝对值。

对于周/周末的高级处理，使用以下工具:

 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:003

对人类来说，一个月前比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()。

 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:004

您还可以在调用diffforhuman()之前使用Carbon::setLocale(‘fr’)更改字符串的locale。有关更多细节，请参见本地化部分。

可以通过以下方式启用/禁用diffforhuman()选项:

 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:005

可用的选项是:

 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:006

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()函数。它将实例移动到其本身和提供的碳参数之间的中间日期。

 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:007

下面的常数是在Carbon中定义的。

 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:008

Carbon实例能被序列化的。

 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:009

Carbon实例可以从JSON编码和解码(这些特性只能从PHP 5.4+中获得，参见下面关于PHP 5.3的注释)。

  $date =  new  Carbon('first day of December 2008');    echo $date->addWeeks(2);0

您可以使用serializeUsing()自定义序列化。

  $date =  new  Carbon('first day of December 2008');    echo $date->addWeeks(2);1

jsonSerialize()方法返回中间通过“json_encode”将其转换为字符串，它还允许您使用PHP 5.3兼容性。

  $date =  new  Carbon('first day of December 2008');    echo $date->addWeeks(2);2

如果您习惯于使用Laravel和对象(如响应或集合)，您可能熟悉这个宏概念。Carbon macro()的工作方式与Laravel宏特性相同，它将方法名作为第一个参数，闭包作为第二个参数。这使得闭包操作可以作为一个具有给定名称的方法在所有Carbon实例(也可以作为Carbon static方法)上使用。

在PHP 5.4中，$this可用于闭包中引用当前实例。对于PHP 5.3的兼容性，我们还向闭包添加了一个“$self”属性。例子:

  $date =  new  Carbon('first day of December 2008');    echo $date->addWeeks(2);3

兼容性块允许您确保宏的完全兼容性。一个关于Illuminate\Support\Carbon (Laravel包装类)的宏将不会被定义，正如上面在PHP 5.3 $this中提到的，这个不会被定义。要使宏在任何地方都能工作，只需粘贴这个if语句测试如果它是定义的，而不是$self然后复制它，然后在函数体中使用$self。

不管您是否省略了一些可选参数，只要$self有这个名称，并且是最后一个参数:

  $date =  new  Carbon('first day of December 2008');    echo $date->addWeeks(2);4

还可以将宏分组到类中，并与mixin()一起应用

  $date =  new  Carbon('first day of December 2008');    echo $date->addWeeks(2);5

您可以用hasMacro()检查是否可用宏(包括mixin)

  $date =  new  Carbon('first day of December 2008');    echo $date->addWeeks(2);6

你猜怎么着?在CarbonInterval和CarbonPeriod类上也可以使用所有的宏方法。

  $date =  new  Carbon('first day of December 2008');    echo $date->addWeeks(2);7

以下是社区提出的一些有用的宏:

  $date =  new  Carbon('first day of December 2008');    echo $date->addWeeks(2);8

检查cmixin/业务日以获得更完整的业务日处理程序。

  $date =  new  Carbon('first day of December 2008');    echo $date->addWeeks(2);9

查看cmixin/工作日以获得更完整的假日处理程序。

  $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."; }0

CarbonInterval类继承了PHP DateInterval类。

  $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."; }1

你可以通过以下方式创建实例

  $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."; }2

如果您发现自己从另一个库继承了\DateInterval实例，不要害怕!您可以通过一个友好的instance()函数创建一个CarbonInterval实例。

  $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."; }3

其他的帮助程序，但是要注意实现提供了帮助程序来处理几周，但是只节省了几天。数周是根据当前实例的总天数计算的。

  $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."; }4

借助fromString()方法，可以从友好的字符串创建Carbon intervals。

  $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."; }5

注意这个月缩写为“mo”以区别于分钟和整个语法不区分大小写。

它还有一个方便的for human()，它被映射为__toString()实现，用于为人类打印间隔。

  $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."; }6

如您所见，您可以使用CarbonInterval::setLocale(‘fr’)更改字符串的语言环境。

至于Carbon，您可以使用make方法从其他区间或字符串返回一个新的CarbonInterval实例:

  $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."; }7

本机DateInterval分别添加和相乘，因此:

  $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."; }8

从单位到单位的输入中得到纯计算。将分钟级联成小时、小时级联成天等。使用级联方法:

  $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."; }9

默认的因素有:

1分钟= 60秒

1小时=60分钟

1天=24小时

1周= 7天

1个月= 4周

1年= 12个月

CarbonIntervals 没有上下文，所以它们不能更精确(没有DST、没有闰年、没有实际的月长或年长)。但是你可以完全定制这些因素。例如处理工作时间日志:

 $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:000

是否可能将间隔转换为给定的单元(使用提供的级联因子)。

 $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:001

您还可以使用spec()获得inverval的ISO 8601规范

 $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:002

也可以从DateInterval对象获取它，因为它是静态助手:

 $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:003

使用compare()和comparedateinterval()方法可以对日期间隔列表进行排序:

 $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:004

最后，通过使用互补参数调用toPeriod()，可以将一个CarbonInterval实例转换为一个CarbonPeriod实例。

我听到你问什么是CarbonPeriod 实例。哦!完美过渡到下一章。

CarbonPeriod是一个友好的DatePeriod版本，具有许多快捷方式。

 $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:005

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循环:

 $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:006

参数可以在迭代过程中进行修改:

 $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:007

和DatePeriod一样，CarbonPeriod也支持ISO 8601时间间隔规范。

请注意，本机日期周期将递归处理为多次重复间隔。因此，在排除开始日期时，它将减少一个结果。CarbonPeriod的自定义过滤器的引入使得知道结果的数量变得更加困难。由于这个原因，我们稍微改变了实现，递归被视为返回日期的总体限制。

 $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:008

您可以从不同的getter中检索数据:

 $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:009

附加的getter允许您以数组的形式访问结果:

  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);0

注意，如果您打算使用上述函数，将toArray()调用的结果存储为变量并使用它是一个好主意，因为每个调用在内部执行一个完整的迭代。

想要更改参数，可以使用setter方法:

  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);1

您可以使用setOptions()更改选项以替换所有选项，但也可以分别更改:

  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);2

如前所述，根据ISO 8601规范，递归是重复间隔的数倍。因此，本机DatePeriod将根据开始日期的排除而改变返回日期的数量。与此同时，CarbonPeriod在输入和允许自定义过滤器方面更加宽容，将递归作为返回日期的总体限制:

  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);3

DatePeriod返回的日期可以很容易地过滤。例如，过滤器可以用于跳过某些日期或只在工作日或周末迭代。筛选函数应该返回true以接受日期，返回false以跳过日期，但继续搜索或CarbonPeriod::END_ITERATION以结束迭代。

  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);4

您还可以跳过循环中的一个或多个值。

  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);5

getFilters()允许您在一个时间段内检索所有存储的过滤器。但是要注意递归限制和结束日期将出现在返回的数组中，因为它们作为过滤器存储在内部。

  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);6

过滤器存储在堆栈中，可以使用一组特殊的方法进行管理:

  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);7

添加过滤器的顺序会对性能和结果产生影响，因此您可以使用addFilter()在堆栈末尾添加过滤器;您可以使用prependFilter()在开始时添加一个。甚至可以使用setfilter()替换所有的过滤器。请注意，您必须保持堆栈的正确格式，并记住关于递归限制和结束日期的内部过滤器。或者，您可以使用resetFilters()方法，然后逐个添加新的过滤器。

例如，当您添加一个限制尝试日期数量的自定义过滤器时，如果您在工作日过滤器之前或之后添加它，那么结果将是不同的。

  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);8

注意，内置的递归过滤器不是这样工作的。相反，它基于当前键，每个条目只增加一次，无论在找到有效日期之前需要检查多少个日期。如果您将它放在堆栈的开头或末尾，那么这个技巧将使它的工作方式相同。

为了简化CarbonPeriod的构建，添加了一些别名:

  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);9

可以很容易地将CarbonPeriod转换为人类可读的字符串和ISO 8601规范:

  <?php use  Carbon\Carbon;00

以上就是聊聊Laravel Carbon扩展包的作用及用法的详细内容，更多请关注9543建站博客其它相关文章！

广告：SSL证书一年128.66元起，点击购买~~~