zjkal/time-helper

一个简单快捷的PHP日期时间助手类库。 a smart PHP datetime helper library.

v1.1.13 2025-05-03 13:54 UTC

README


TimeHelper

中文 | English

License PHP Version Require Latest Stable Version Total Downloads GitHub Workflow Status

TimeHelper 是一个简单易用的PHP时间日期助手类库,可以快速实现常用的时间日期操作,比如获取指定时间的秒数,获取友好的时间格式,判断时间范围,计算两个时间相差值,返回 N 小时/天/星期/月/年前或者后的时间戳等等

🧩 特性

  • 简单易用: 不依赖任何扩展,开箱即用
  • 化繁为简: 所有方法都可以传入任意类型的时间日期格式时间戳
  • 快捷高效: 所有操作只需要一个静态方法即可完成
  • 长期维护: 作者为自由职业者,保证项目的长期稳定持续更新

🎁 示例

//判断指定日期是否为国内的工作日
ChinaHoliday::isWorkday('2023-01-23');

//判断指定日期是否为国内的节假日
ChinaHoliday::isHoliday(1646360133);

//返回友好的时间格式,如:刚刚,N秒前,N分钟前,N小时前等等
TimeHelper::toFriendly('2022-3-2 10:15:33');
//返回友好的时间格式(英文)
TimeHelper::toFriendly(1646186290, 'en');

//判断日期是否为今天
TimeHelper::isToday('2020-4-10 23:01:11');

//判断日期是否为工作日(周一到周五)
TimeHelper::isWeekday('2023-03-08');

//计算两个日期相差天数
TimeHelper::diffDays('2022-4-10 23:01:11','Apr 11, 2020');

//返回15天前0点的时间戳
TimeHelper::beforeDay(15,null,true);

//返回15天后的时间戳
TimeHelper::afterDay(15);

//返回5个月后的时间戳
TimeHelper::afterMonth(5);

//将任意格式的时间转换为指定格式
TimeHelper::format('Y-m-d H:i:s','May 3, 2022');

//将任意时间类型的字符串转为时间戳
TimeHelper::toTimestamp('Apr 11, 2020');

//获取当前时间
TimeHelper::now();

🚀 安装

通过 Composer 导入类库

composer require zjkal/time-helper

🌈 使用文档

查看使用文档

📃 更新日志

查看更新日志

😎 开发者们

zjkal
zjkal
miss-sugar
miss-sugar
iuyes
李云龙
ageChen
ageChen
dkoin
dkoin
wolf-leo
wolfcode

❤️ 由 JetBrains 赞助

非常感谢 Jetbrains 为我提供的 IDE 开源许可,让我完成此项目和其他开源项目上的开发工作。

🐧 扫以下二维码加入 QQ 频道

QQ频道-世界上最好的编程语言

📖 开源协议

TimeHelper 遵循MIT 开源协议, 意味着您无需任何授权, 即可免费将 TimeHelper 应用到您的项目中