原文： https://zetcode.com/php/carbon/

PHP Carbon 教程展示了如何在带有 Carbon 包的 PHP 中使用日期和时间。 我们使用nesbot/carbon包。

PHP Carbon

Carbon 是一个 PHP 日期时间库。 它是 PHP DateTime类的扩展。

PHP Carbon 设置

该包随 composer 一起安装。

  1. $ composer req nesbot/carbon

我们安装nesbot/carbon包。

今天的日期

以下示例显示如何获取今天的日期。

today.php

  1. <?php
  3. require __DIR__ . '/vendor/autoload.php';
  5. use Carbon\Carbon;
  7. $now = Carbon::now();
  8. echo "$now\n";
  10. $today = Carbon::today();
  11. echo "$today\n";

Carbon::now()返回当前日期和时间，Carbon:today()返回当前日期。

  1. $ php today.php
  2. 2019-05-07 10:20:54
  3. 2019-05-07 00:00:00

这是一个示例输出。

Carbon::yesterday()为昨天创建一个 Carbon 实例，为明天创建Carbon::tomorrow()。

yes_tom.php

  1. <?php
  3. require __DIR__ . '/vendor/autoload.php';
  5. use Carbon\Carbon;
  7. $yes = Carbon::yesterday();
  8. echo "Yesterday: $yes\n";
  10. $tom = Carbon::tomorrow();
  11. echo "Tomorrow: $tom\n";

该示例显示了昨天和明天的日期。

Carbon 来创建

Carbon 实例可以使用几种创建方法来创建。

create.php

  1. <?php
  3. require __DIR__ . "/vendor/autoload.php";
  5. use Carbon\Carbon;
  7. $d1 = Carbon::create(2018, 8, 25, 22, 48, 00);
  8. echo $d1 . "\n";
  10. $d2  = Carbon::create(2018, 8, 25, 22, 48, 00, 'Europe/Moscow');
  11. echo $d2 . "\n";
  13. $d3 = Carbon::createFromDate(2018, 8, 14, 'America/Chicago');
  14. echo $d3 . "\n";
  16. $d4 = Carbon::createFromTimestamp(1);
  17. echo $d4 . "\n";

该示例使用四种不同的方法创建 Carbon 实例。

  1. $d1 = Carbon::create(2018, 8, 25, 22, 48, 00);

create()方法根据日期和时间部分生成一个 Carbon 实例。

  1. $d2  = Carbon::create(2018, 8, 25, 22, 48, 00, 'Europe/Moscow');

在第二个示例中，我们还提供了一个时区。

  1. $d3 = Carbon::createFromDate(2018, 8, 14, 'America/Chicago');

使用createFromDate()，我们创建一个带有日期部分的 Carbon 实例。

  1. $d4 = Carbon::createFromTimestamp(1);

createFromTimestamp()从 Unix 时间创建一个 Carbon 实例。

  1. $ php create.php
  2. 2018-08-25 22:48:00
  3. 2018-08-25 22:48:00
  4. 2018-08-14 03:33:16
  5. 1970-01-01 01:00:01

This is a sample output.

Carbon 相对修饰符

碳实例可以通过相对修饰符来创建，例如下一个星期五或一年之前。

relative_modifiers.php

  1. <?php
  3. require __DIR__ . "/vendor/autoload.php";
  5. use Carbon\Carbon;
  7. echo new Carbon('tomorrow') . "\n";
  8. echo new Carbon('yesterday') . "\n";
  9. echo new Carbon('next wednesday') . "\n";
  10. echo new Carbon('last friday') . "\n";
  11. echo new Carbon('this saturday') . "\n";
  12. echo new Carbon('1 year ago') . "\n";

该示例使用几个修饰符创建 Carbon 实例。

  1. $ php relative_modifiers.php
  2. 2019-05-08 00:00:00
  3. 2019-05-06 00:00:00
  4. 2019-05-08 00:00:00
  5. 2019-05-03 00:00:00
  6. 2019-05-11 00:00:00
  7. 2018-05-07 11:53:03

This is a sample output.

Carbon next()和previous()

next()和previous()方法给出一周中给定日期的下一个/上一个出现。

next_previous.php

  1. <?php
  3. require __DIR__ . "/vendor/autoload.php";
  5. use Carbon\Carbon;
  7. $now = Carbon::now();
  9. echo "$now\n";
  11. $next_monday = $now->next(Carbon::MONDAY);
  12. echo "Next monday: $next_monday\n";
  14. $prev_monday = $now->previous(Carbon::MONDAY);
  15. echo "Previous monday: $prev_monday\n";

该示例显示了下一个和上一个星期一。

  1. $ php next_previous.php
  2. 2019-05-07 11:34:32
  3. Next monday: 2019-05-13 00:00:00
  4. Previous monday: 2019-05-06 00:00:00

This is a sample output.

Carbon 日期时间

Carbon 日期时间包括年，月，日或小时。

parts.php

  1. <?php
  3. require __DIR__ . '/vendor/autoload.php';
  5. use Carbon\Carbon;
  7. $now = Carbon::now();
  9. echo $now->year  . "\n";
  10. echo $now->month  . "\n";
  11. echo $now->day  . "\n";
  12. echo $now->hour  . "\n";
  13. echo $now->second  . "\n";
  14. echo $now->dayOfWeek  . "\n";
  15. echo $now->dayOfYear  . "\n";
  16. echo $now->weekOfMonth  . "\n";
  17. echo $now->daysInMonth  . "\n";

该示例显示 Carbon 日期时间实例的各个部分。

  1. $ php parts.php
  2. 2019
  3. 5
  4. 7
  5. 10
  6. 31
  7. 2
  8. 126
  9. 1
  10. 31

This is a sample output.

Carbon 流式 API

Carbon 还提供了方便的流式 API 来处理日期时间。

fluent_api.php

  1. <?php
  3. require __DIR__ . "/vendor/autoload.php";
  5. use Carbon\Carbon;
  7. $dt = Carbon::create();
  8. $dt->year(2019)->month(5)->day(6)->hour(16)->minute(12)->second(53);
  9. echo $dt . "\n";
  11. $dt2 = Carbon::create();
  12. $dt2->setDate(2019, 5, 6)->setTime(16, 12, 53);
  13. echo $dt2 . "\n";
  15. $dt3 = Carbon::create();
  16. $dt3->setDate(2019, 5, 6)->setTime(16, 12, 53);
  17. echo $dt3 . "\n";

该示例使用流畅的 API 创建了三个 Carbon 实例。

  1. $ php fluent_api.php
  2. 2019-05-06 16:12:53
  3. 2019-05-06 16:12:53
  4. 2019-05-06 16:12:53

这是输出。

Carbon 修改方法

Carbon 修改方法修改实例。 我们可以使用copy()方法来处理副本。

copy_method.php

  1. <?php
  3. require __DIR__ . "/vendor/autoload.php";
  5. use Carbon\Carbon;
  7. echo "Tomorrow: " . Carbon::tomorrow() . "\n";
  9. echo "*************************\n";
  11. $dt = new Carbon('tomorrow');
  12. echo $dt->subDay() . "\n";
  13. echo $dt . "\n";
  15. echo "*************************\n";
  17. $dt2 = new Carbon('tomorrow');
  18. echo $dt2->copy()->subDay() . "\n";
  19. echo $dt2 . "\n";

该示例介绍了copy()方法。

  1. $ php copy_method.php
  2. Tomorrow: 2019-05-08 00:00:00
  3. *************************
  4. 2019-05-07 00:00:00
  5. 2019-05-07 00:00:00
  6. *************************
  7. 2019-05-07 00:00:00
  8. 2019-05-08 00:00:00

在第二种情况下，原始实例是完整的。

碳加减法

碳提供了两种不同的方法来轻松增加和减少时间。

add_sub.php

  1. <?php
  3. require __DIR__ . '/vendor/autoload.php';
  5. use Carbon\Carbon;
  7. $now = Carbon::now();
  9. echo "$now\n";
  11. $d1 = $now->copy()->addDays(3);
  12. echo "$d1\n";
  14. $d2 = $now->copy()->addHours(12);
  15. echo "$d2\n";
  17. $d3 = $now->copy()->subDays(3);
  18. echo "$d3\n";
  20. $d4 = $now->copy()->subHours(12);
  21. echo "$d4\n";

该示例介绍了addDays()，addHours()，subDays()和subHours()方法。

  1. $ php add_sub.php
  2. 2019-05-07 12:27:22
  3. 2019-05-10 12:27:22
  4. 2019-05-08 00:27:22
  5. 2019-05-04 12:27:22
  6. 2019-05-07 00:27:22

This is a sample output.

下面的示例显示其他加法和减法。

add_sub.php

  1. <?php
  3. require __DIR__ . '/vendor/autoload.php';
  5. use Carbon\Carbon;
  7. $now = Carbon::now();
  9. $d1 = $now->copy()->addCenturies(2);
  10. echo $d1->toDateString() . "\n";
  12. $d2 = $now->copy()->subCenturies(2);
  13. echo $d2->toDateString() . "\n";
  15. $d3 = $now->copy()->addYears(2);
  16. echo $d3->toDateString() . "\n";
  18. $d4 = $now->copy()->subYears(2);
  19. echo $d4->toDateString() . "\n";
  21. $d5 = $now->copy()->addMonths(2);
  22. echo $d5->toDateString() . "\n";
  24. $d6 = $now->copy()->subMonths(2);
  25. echo $d6->toDateString() . "\n";

我们显示addCenturies()，subCenturies()，addYears()，subYears()，addMonths()和subMonths()。

  1. $ php add_sub2.php
  2. 2219-05-07
  3. 1819-05-07
  4. 2021-05-07
  5. 2017-05-07
  6. 2019-07-07
  7. 2019-03-07

This is a sample output.

Carbon 格式化日期时间

Carbon 提供了几种格式化日期时间的方法。

formatting.php

  1. <?php
  3. require __DIR__ . "/vendor/autoload.php";
  5. use Carbon\Carbon;
  7. $dt = Carbon::now();
  9. echo $dt . "\n";
  10. echo $dt->toDateTimeString(). "\n";
  12. echo "******************************\n";
  14. echo $dt->toDateString(). "\n";
  15. echo $dt->toFormattedDateString(). "\n";
  16. echo $dt->toTimeString(). "\n";
  17. echo $dt->toDayDateTimeString(). "\n";
  19. echo "******************************\n";
  21. echo $dt->format('Y-m-d h:i:s A'). "\n";

该示例提供了基本的格式化方法。 我们还可以使用format()生成自定义格式。

  1. $ php formatting.php
  2. 2019-05-07 10:36:09
  3. 2019-05-07 10:36:09
  4. ******************************
  5. 2019-05-07
  6. May 7, 2019
  7. 10:36:09
  8. Tue, May 7, 2019 10:36 AM
  9. ******************************
  10. 2019-05-07 10:36:09 AM

This is a sample output.

下面的示例显示其他常见的 Carbon 日期时间格式化方法。

common_formats.php

  1. <?php
  3. require __DIR__ . "/vendor/autoload.php";
  5. use Carbon\Carbon;
  7. $dt = Carbon::createFromFormat('Y-m-d H:i:s.u', '2019-05-06 16:45:00.613484');
  9. echo $dt->toAtomString() . "\n";
  10. echo $dt->toCookieString() . "\n";
  12. echo $dt->toIso8601String() . "\n";
  13. echo $dt->toIso8601ZuluString() . "\n";
  15. echo $dt->toRfc822String() . "\n";
  16. echo $dt->toRfc850String() . "\n";
  17. echo $dt->toRfc1036String() . "\n";
  18. echo $dt->toRfc1123String() . "\n";
  19. echo $dt->toRfc3339String() . "\n";
  20. echo $dt->toRfc7231String() . "\n";
  22. echo $dt->toRssString() . "\n";
  23. echo $dt->toW3cString() . "\n";

该示例介绍了其他十二种方法。

  1. $ php common_formats.php
  2. 2019-05-06T16:45:00+02:00
  3. Monday, 06-May-2019 16:45:00 CEST
  4. 2019-05-06T16:45:00+02:00
  5. 2019-05-06T14:45:00Z
  6. Mon, 06 May 19 16:45:00 +0200
  7. Monday, 06-May-19 16:45:00 CEST
  8. Mon, 06 May 19 16:45:00 +0200
  9. Mon, 06 May 2019 16:45:00 +0200
  10. 2019-05-06T16:45:00+02:00
  11. Mon, 06 May 2019 14:45:00 GMT
  12. Mon, 06 May 2019 16:45:00 +0200
  13. 2019-05-06T16:45:00+02:00

This is the output.

Carbon 比较日期时间

Carbon 具有比较日期时间的方法，例如eq()和gt()。

comparing.php

  1. <?php
  3. require __DIR__ . "/vendor/autoload.php";
  5. use Carbon\Carbon;
  7. $first = Carbon::create(2019, 5, 5, 22, 20, 1);
  8. $second = Carbon::create(2019, 5, 5, 20, 20, 1);
  10. echo $first . "\n";
  11. echo $second . "\n";
  13. var_dump($first->eq($second));
  14. var_dump($first->ne($second));
  15. var_dump($first->gt($second));
  16. var_dump($first->gte($second));
  17. var_dump($first->lt($second));
  18. var_dump($first->lte($second));

该示例比较两个日期时间值。

  1. $ php comparison.php
  2. 2019-05-05 22:20:01
  3. 2019-05-05 20:20:01
  4. bool(false)
  5. bool(true)
  6. bool(true)
  7. bool(true)
  8. bool(false)
  9. bool(false)

This is the output.

Carbon UTC

协调世界时（UTC）是世界各地用来调节时钟和时间的主要时间标准。

utc.php

  1. <?php
  3. require __DIR__ . "/vendor/autoload.php";
  5. use Carbon\Carbon;
  7. $now = Carbon::now();
  8. echo "$now\n";
  9. isUtc($now);
  11. echo "Offset hours: {$now->offsetHours}\n";
  13. echo "******************************\n";
  15. $now->tz('UTC');
  16. echo "$now\n";
  17. isUtc($now);
  19. function isUtc($now): void 
  20. {
  21.     if ($now->utc) 
  22.     {
  23.         echo "Datetime is in UTC\n";
  24.     } else {
  26.         echo "Datetime is not in UTC\n";
  27.     }
  28. }

该示例计算 UTC 时间（以小时为单位的偏移量），并确定日期时间是否为 UTC 时间。

  1. $ php utc.php
  2. 2019-05-07 11:14:18
  3. Datetime is not in UTC
  4. Offset hours: 2
  5. ******************************
  6. 2019-05-07 09:14:18
  7. Datetime is in UTC

This is a sample output.

Carbon 人性化日期时间差异

应用通常以所谓的人性化格式显示日期时间差异。 例如在一年或三分钟前。

humanized.php

  1. <?php
  3. require __DIR__ . "/vendor/autoload.php";
  5. use Carbon\Carbon;
  7. echo Carbon::now()->addYear()->diffForHumans() . "\n";
  9. Carbon::setLocale('de');
  10. echo Carbon::now()->addYear()->diffForHumans() . "\n";
  12. Carbon::setLocale('sk');
  13. echo Carbon::now()->addYear()->diffForHumans() . "\n";

该示例显示了三种语言环境中的日期时间差异。

  1. $ php humanize.php
  2. 1 year from now
  3. in 1 Jahr
  4. za rok

This is the output.

Carbon 修饰符

修饰符方法对当前实例执行有用的修改。 他们可以检索周，月或年的开始/结束。

modifiers.php

  1. <?php
  3. require __DIR__ . "/vendor/autoload.php";
  5. use Carbon\Carbon;
  7. echo "Start/End of day\n";
  9. $dt = Carbon::create(2019, 5, 6, 12, 0, 0);
  11. echo $dt->copy()->startOfDay() . "\n";
  12. echo $dt->copy()->endOfDay() . "\n";
  14. echo "\nStart/End of month\n";
  16. echo $dt->copy()->startOfMonth() . "\n";
  17. echo $dt->copy()->endOfMonth() . "\n";
  19. echo "\nStart/End of year\n";
  21. echo $dt->copy()->startOfYear() . "\n";
  22. echo $dt->copy()->endOfYear() . "\n";
  24. echo "\nStart/End of decade\n";
  25. echo $dt->copy()->startOfDecade() . "\n";
  26. echo $dt->copy()->endOfDecade() . "\n";
  28. echo "\nStart/End of century\n";
  29. echo $dt->copy()->startOfCentury() . "\n";
  30. echo $dt->copy()->endOfCentury() . "\n";

该示例提出了几个修饰符。

  1. $ php modifiers.php
  2. Start/End of day
  3. 2019-05-06 00:00:00
  4. 2019-05-06 23:59:59
  6. Start/End of month
  7. 2019-05-01 00:00:00
  8. 2019-05-31 23:59:59
  10. Start/End of year
  11. 2019-01-01 00:00:00
  12. 2019-12-31 23:59:59
  14. Start/End of decade
  15. 2010-01-01 00:00:00
  16. 2019-12-31 23:59:59
  18. Start/End of century
  19. 2001-01-01 00:00:00
  20. 2100-12-31 23:59:59

This is a sample output.

在本教程中，我们使用 PHP Carbon 来处理日期和时间。

您可能也对以下相关教程感兴趣： PHP PDO 教程， Twig 教程和 PHP 教程，或列出所有 PHP 教程 ]。