TimeHelper简单快捷PHP日期时间助手类库使用详解

composer require zjkal/time-helper

use zjkal\TimeHelper;

//返回到今天晚上零点之前的秒数
TimeHelper::secondEndToday();
//返回N分钟的秒数(默认为1分钟)
TimeHelper::secondMinute(5);
//返回N小时的秒数(默认为1小时)
TimeHelper::secondHour(2);
//返回N天的秒数(默认为1天)
TimeHelper::secondDay(10);
//返回N周的秒数(默认为1周)
TimeHelper::secondWeek(4);

//一共2个参数:
//第1个参数传入字符串类型的时间或者时间戳都可以，
//第2个参数为语言(默认为中文,需要英文请传入en)
TimeHelper::toFriendly('2022-3-2 10:15:33');
//英文
TimeHelper::toFriendly(1646186290, 'en');

//判断日期是否为今天
TimeHelper::isToday('2020-4-10 23:01:11');
//判断日期是否为本周
TimeHelper::isThisWeek('2020-5-1');
//判断日期是否为本月
TimeHelper::isThisMonth(1586451741);
//判断日期是否为今年
TimeHelper::isThisYear('Apr 11, 2020');
//判断指定时间是星期几,不传默认为当前时间. 返回值为1-7,1为星期一,7为星期日
TimeHelper::getWeek('2022-11-27');
//判断指定时间是否为平常日(周一到周五)
TimeHelper::isWeekday('2023-03-08');
//判断指定时间是否为周末(周六和周日)
TimeHelper::isWeekend(1586451741);

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

//返回指定时间3分钟前0秒的时间戳
TimeHelper::beforeMinute(3,'2022-3-2 10:15:33',true);
//返回当前时间5分钟后的时间戳
TimeHelper::afterMinute(5);
//返回指定时间1小时前的时间戳(请注意此用法为php8之后的用法)
TimeHelper::beforeHour(datetime:'Apr 11, 2020');
//返回2小时后的时间戳
TimeHelper::afterHour(2);
//返回15天前0点的时间戳
TimeHelper::beforeDay(15,null,true);
//返回15天后的时间戳
TimeHelper::afterDay(15);
//返回指定时间2星期前的时间戳
TimeHelper::beforeWeek(2,'2022-4-10 23:01:11');
//返回指定时间10星期后的时间戳
TimeHelper::afterWeek(10,1646360133);
//返回指定时间1个月前的时间戳(请注意此用法为php8之后的用法)
TimeHelper::beforeMonth(datetime:1646360133);
//返回5个月后的时间戳
TimeHelper::afterMonth(5);
//返回指定时间3年前的时间戳
TimeHelper::beforeYear(3,'2022-7-11');
//返回2年后的时间戳
TimeHelper::afterYear(2);

//获取秒级的时间戳,可用time()代替
TimeHelper::getTimestamp();
//获取毫秒级的时间戳
TimeHelper::getMilliTimestamp();
//获取微秒级的时间戳
TimeHelper::getMicroTimestamp();
//获取纳秒级的时间戳
TimeHelper::getNanoTimestamp();

//将任意格式的时间转换为指定格式
//第一个参数是时间格式,与系统函数date()的格式保持一致
//第二个参数则是任意格式的时间日期,不传则默认为当前时间,可用系统函数date()代替
TimeHelper::format('Y-m-d H:i:s','May 3, 2022');
//判断一个字符串是否为时间戳,是返回true,否返回false
TimeHelper::isTimestamp(1646360133);
//将任意时间类型的字符串转为时间戳
TimeHelper::toTimestamp('Apr 11, 2020');

//判断是否为闰年,是返回true,否返回false
TimeHelper::isLeapYear('2020-3-2 10:15:33');
//判断该日期的当年有多少天
TimeHelper::daysInYear(1646360133);
//判断该日期的当月有多少天
TimeHelper::daysInMonth('Apr 11, 2020');

//将任意格式的时间或时间戳转换为指定时区的时间
//第一个参数为要转换的目标时区
//第二个参数为原时区,不传则默认为当前时区
//第三个参数为任意格式的时间或时间戳,不传则默认为当前时间
//第四个参数为时间格式,与系统函数date()的格式保持一致,不传则默认为Y-m-d H:i:s
TimeHelper::timezoneFormat('Europe/London', 'Asia/Shanghai', '2023-8-15 19:16:43', 'H:i:s');
//获得当前洛杉矶的时间
TimeHelper::timezoneFormat('America/Los_Angeles');
//将洛杉矶时间转换为伦敦时间
TimeHelper::timezoneFormat('Europe/London', 'America/Los_Angeles', 'Aug 15, 2023 10:15:33', 'H:i:s');
//将时间戳转换为伦敦时间
TimeHelper::timezoneFormat('Europe/London', null, 1692097543);

use zjkal\ChinaHoliday;
//判断指定日期是否为国内的工作日
ChinaHoliday::isWorkday('2023-01-23');
//判断指定日期是否为国内的节假日
ChinaHoliday::isHoliday(1646360133);