README

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

//获取本月的起止时间戳,包含起点,不包含终点
$range = TimeRange::month();

//获取上个月的起止时间戳
TimeRange::month(null, -1);

//判断时间是否在指定范围内
TimeRange::contains('2026-10-27', '2026-10-01', '2026-11-01');

//校验日期是否有效
TimeHelper::isValidDate('2026-02-31'); // false

//按指定格式解析日期
TimeHelper::parseExact('03/04/2026', 'd/m/Y'); // 2026年4月3日