首页
所有分类
TAGS
文字工具 EMOJI BIBLE
编程 PHP

Laravel中日期时间处理包Carbon的简单使用

Posted in PHP onSeptember 21, 2017

前言

我们大家在编写 PHP 应用时经常需要处理日期和时间，这篇文章带你了解一下 Carbon ? 继承自 PHP DateTime 类的 API 扩展，它使得处理日期和时间更加简单。

Laravel 中默认使用的时间处理类就是 Carbon。

<?php
namespace Carbon;
 
class Carbon extends \DateTime
{
 // code here
}

你可以在 Carbon 命名空间的 Carbon 类中看到上面声明的代码片段。

安装

可以通过 Composer 来安装 Carbon：

composer require nesbot/carbon

PS：由于 Laravel 项目已默认安装了此包，所以不需要再次执行上面的命令。

使用

你需要通过命名空间导入 Carbon 来使用，而不需每次都提供完整的名称。

use Carbon\Carbon;

获取当前时间

可以同 now() 方法获取当前的日期和时间。如果你不指定参数，它会使用 PHP 配置中的时区：

<?php
echo Carbon::now(); //2016-10-14 20:21:20
?>

如果你想使用一个不同的时区，你需要传递一个有效的时区作为参数：

// 直接使用字符串
echo Carbon::now('Europe/London'); //2016-10-14 20:21:20
// 或者
echo Carbon::now(new DateTimeZone('Europe/London'));

除 now() 外，还提供了 today() 、tomorrow() 、yesterday() 等静态函数，不过，它们的时间都是 00:00:00 ：

echo Carbon::now();        // 2016-10-14 15:18:34
echo Carbon::today();       // 2016-10-14 00:00:00
echo Carbon::tomorrow('Europe/London');       // 2016-10-14 00:00:00
echo Carbon::yesterday();       // 2016-10-14 00:00:00

以上输出结果其实是一个 Carbon 类型的日期时间对象：

Carbon {#179 ?
 +"date": "2016-06-14 00:00:00.000000"
 +"timezone_type": 3
 +"timezone": "UTC"
}

要想获取字符串类型的日期，可以使用下面的代码：

echo Carbon::today()->toDateTimeString();
echo Carbon::yesterday()->toDateTimeString();
echo Carbon::tomorrow()->toDateTimeString();

日期类型转为字符串

如上所述，默认情况下，Carbon 的方法返回的为一个日期时间对象。虽然它是一个对象，但是你却可以直接使用 echo 输出结果，因为有 __toString 魔术方法。但是如果你想把它转为字符串，可以使用 toDateString 或 toDateTimeString 方法：

echo Carbon::now()->toDateString(); //2016-10-14
echo Carbon::now()->toDateTimeString(); //2016-10-14 20:22:50

日期解析

你还可以使用 parse 方法解析任何顺序和类型的日期（结果为 Carbon 类型的日期时间对象）：

echo Carbon::parse('2016-10-15')->toDateTimeString(); //2016-10-15 00:00:00
echo Carbon::parse('2016-10-15')->toDateTimeString(); //2016-10-15 00:00:00
echo Carbon::parse('2016-10-15 00:10:25')->toDateTimeString(); //2016-10-15 00:10:25
 
echo Carbon::parse('today')->toDateTimeString(); //2016-10-15 00:00:00
echo Carbon::parse('yesterday')->toDateTimeString(); //2016-10-14 00:00:00
echo Carbon::parse('tomorrow')->toDateTimeString(); //2016-10-16 00:00:00
echo Carbon::parse('2 days ago')->toDateTimeString(); //2016-10-13 20:49:53
echo Carbon::parse('+3 days')->toDateTimeString(); //2016-10-18 20:49:53
echo Carbon::parse('+2 weeks')->toDateTimeString(); //2016-10-29 20:49:53
echo Carbon::parse('+4 months')->toDateTimeString(); //2017-02-15 20:49:53
echo Carbon::parse('-1 year')->toDateTimeString(); //2015-10-15 20:49:53
echo Carbon::parse('next wednesday')->toDateTimeString(); //2016-10-19 00:00:00
echo Carbon::parse('last friday')->toDateTimeString(); //2016-10-14 00:00:00

构造日期

你还可以使用单独的年月日来构造日期：

$year = '2015';
$month = '04';
$day = '12';
 
echo Carbon::createFromDate($year, $month, $day); //2015-04-12 20:55:59
 
$hour = '02';
$minute = '15':
$second = '30';
 
echo Carbon::create($year, $month, $day, $hour, $minute, $second); //2015-04-12 02:15:30
 
echo Carbon::createFromDate(null, 12, 25); // 年默认为当前年份

此外，还可以传递一个有效的时区作为最后一个参数。

日期操作

日期操作可以通过 add （增加）或 sub （减去）跟上要增加或减去的单位来完成。例如，你想给一个日期增加指定的天数，你可以使用 addDays 方法。此外还提供了一个 modify 方法，参数格式为 + 或 - 跟上值及单位。所以，如果你想给当前日期增加一年，你可以传递 +1 year：

echo Carbon::now()->addDays(25); //2016-11-09 14:00:01
echo Carbon::now()->addWeeks(3); //2016-11-05 14:00:01
echo Carbon::now()->addHours(25); //2016-10-16 15:00:01
echo Carbon::now()->subHours(2); //2016-10-15 12:00:01
echo Carbon::now()->addHours(2)->addMinutes(12); //2016-10-15 16:12:01
echo Carbon::now()->modify('+15 days'); //2016-10-30 14:00:01
echo Carbon::now()->modify('-2 days'); //2016-10-13 14:00:01

日期比较

在 Carbon 中你可以使用下面的方法来比较日期：

  • min ?返回最小日期。
  • max ? 返回最大日期。
  • eq ? 判断两个日期是否相等。
  • gt ? 判断第一个日期是否比第二个日期大。
  • lt ? 判断第一个日期是否比第二个日期小。
  • gte ? 判断第一个日期是否大于等于第二个日期。
  • lte ? 判断第一个日期是否小于等于第二个日期。
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:11
echo $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)

要判断一个日期是否介于两个日期之间，可以使用 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)

此外还提供了一些辅助方法，你可以从它们的名字中明白其含义：

$dt = Carbon::now();
 
$dt->isWeekday();
$dt->isWeekend();
$dt->isYesterday();
$dt->isToday();
$dt->isTomorrow();
$dt->isFuture();
$dt->isPast();
$dt->isLeapYear();
$dt->isSameDay(Carbon::now());
$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!

diffForHumans

“一个月前”比“30 天前”更便于阅读，很多日期库都提供了这个常见的功能，日期被解析后，有下面四种可能性：

1、当比较的时间超过当前默认时间

  • 1天前
  • 5月前

2、当用将来的时间与当前默认时间比较

  • 1小时距现在
  • 5月距现在

3、当比较的值超过另一个值

  • 1小时前
  • 5月前

4、当比较的值在另一个值之后

  • 1小时后
  • 5月后

你可以把第二个参数设置为 true 来删除“前”、“距现在”等修饰语：diffForHumans(Carbon $other, true)  。

echo Carbon::now()->subDays(5)->diffForHumans();        // 5天前
 
echo Carbon::now()->diffForHumans(Carbon::now()->subYear());  // 1年后
 
$dt = Carbon::createFromDate(2011, 8, 1);
 
echo $dt->diffForHumans($dt->copy()->addMonth());       // 1月前
echo $dt->diffForHumans($dt->copy()->subMonth());       // 11月后
 
echo Carbon::now()->addSeconds(5)->diffForHumans();      // 5秒距现在
 
echo Carbon::now()->subDays(24)->diffForHumans();       // 3周前
echo Carbon::now()->subDays(24)->diffForHumans(null, true);  // 3周

本地化

可以在 app/Providers/AppServiceProvider.php 的 boot() 方法中添加下面的代码来设置全局本地化：

public function boot()
{
  \Carbon\Carbon::setLocale('zh');
}

设置好之后，在输出时间的地方调用：

$article->created_at->diffForHumans();

类似的格式即可。

更多 Carbon 操作，可查看文档。

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作能带来一定的帮助，如果有疑问大家可以留言交流，谢谢大家对三水点靠木的支持。

Laravel中日期时间处理包Carbon的简单使用

- Author -

specs

声明：登载此文出于传递更多信息之目的，并不意味着赞同其观点或证实其描述。

PHP 相关文章推荐
用PHP开发GUI
Oct 09 PHP
PHP 强制性文件下载功能的函数代码(任意文件格式)
May 26 PHP
php preg_filter执行一个正则表达式搜索和替换
Feb 27 PHP
PHP gbk环境下json_dencode传送来的汉字
Nov 13 PHP
php数组删除元素示例
Mar 21 PHP
对PHP语言认识上需要避免的10大误区
Jun 12 PHP
PDO防注入原理分析以及使用PDO的注意事项总结
Oct 23 PHP
php判断表是否存在的方法
Jun 18 PHP
PHP编程实现多维数组按照某个键值排序的方法小结【2种方法】
Apr 27 PHP
php 读写json文件及修改json的方法
Mar 07 PHP
PHP类与对象后期静态绑定操作实例详解
Dec 20 PHP
微信小程序结合ThinkPHP5授权登陆后获取手机号
Nov 23 PHP
简单实现php上传文件功能
Sep 21 #PHP
Laravel中七个非常有用但很少人知道的Carbon方法
Sep 21 #PHP
如何通过View::first使用Laravel Blade的动态模板详解
Sep 21 #PHP
基于Laravel实现的用户动态模块开发
Sep 21 #PHP
PHP调用API接口实现天气查询功能的示例
Sep 21 #PHP
PHP判断json格式是否正确的实现代码
Sep 20 #PHP
Yii2.0使用阿里云OSS的SDK上传图片、下载、删除图片示例
Sep 20 #PHP
Next.js(1) 脚手架(2) pip(1) 字典(3) frozenset(1) set(1) most_common(1) SingleFlight(2) Counter(1) 并发(8)
You might like
PHP防注入安全代码
2008/04/09 PHP
PHP版自动生成文章摘要
2008/07/23 PHP
PHP 中文处理技巧
2010/04/25 PHP
web目录下不应该存在多余的程序(安全考虑)
2012/05/09 PHP
解析php通过cookies获取远程网页的指定代码
2013/06/25 PHP
PHP中SERIALIZE和JSON的序列化与反序列化操作区别分析
2016/10/11 PHP
jquery中获得$.ajax()事件返回的值并添加事件的方法
2010/04/15 Javascript
JavaScript使用Math.Min返回两个数中较小数的方法
2015/04/06 Javascript
跟我学习javascript的作用域与作用域链
2015/11/19 Javascript
angular+bootstrap的双向数据绑定实例
2017/03/03 Javascript
jquery与js实现全选功能的区别
2017/06/11 jQuery
js 监控iframe URL的变化实例代码
2017/07/12 Javascript
vue.js数据绑定的方法（单向、双向和一次性绑定）
2017/07/13 Javascript
javascript帧动画(实例讲解)
2017/09/02 Javascript
javaScript动态添加Li元素的实例
2018/02/24 Javascript
vue实现动态添加数据滚动条自动滚动到底部的示例代码
2018/07/06 Javascript
Vue源码分析之Vue实例初始化详解
2019/08/25 Javascript
仿照Element-ui实现一个简易的$message方法
2020/09/14 Javascript
JavaScript实现消消乐的源代码
2021/01/12 Javascript
[07:03]显微镜下的DOTA2第九期——430圣堂刺客杀戮秀
2014/06/20 DOTA
[02:14]2016国际邀请赛中国区预选赛Ehome晋级之路
2016/07/01 DOTA
[51:29]Alliance vs TNC 2019国际邀请赛小组赛 BO2 第二场 8.16
2019/08/18 DOTA
Python中几个比较常见的名词解释
2015/07/04 Python
python实现超简单的视频对象提取功能
2018/06/04 Python
Python寻找两个有序数组的中位数实例详解
2018/12/05 Python
Django用户认证系统 组与权限解析
2019/08/02 Python
Python 程序报错崩溃后如何倒回到崩溃的位置(推荐)
2020/06/23 Python
详解基于python的图像Gabor变换及特征提取
2020/10/26 Python
pytorch 中forward 的用法与解释说明
2021/02/26 Python
毕业生求职找工作的自我评价范文
2013/11/27 职场文书
宣传保护环境的公益广告词
2014/03/13 职场文书
应聘英语教师求职信
2014/04/24 职场文书
建筑工程造价专业自荐信
2014/07/08 职场文书
公司环境卫生管理制度
2015/08/05 职场文书
导游词之峨眉乐山/兵马俑/北京故宫御花园
2019/09/03 职场文书
MYSQL优化之数据表碎片整理详解
2022/04/03 MySQL