簡介

最方便的PHP時間助手類, 所有方法都可傳入任意類型的時間格式&時間戳

安裝

composer require zjkal/time-helper

使用

1. 獲取需要的秒數(shù)

一般用于設(shè)置緩存時間,設(shè)置結(jié)束時間等

//返回到今天晚上零點(diǎn)之前的秒數(shù)
TimeHelper::secondEndToday();

//返回N分鐘的秒數(shù)(默認(rèn)為1分鐘)
TimeHelper::secondMinute(5);

//返回N小時的秒數(shù)(默認(rèn)為1小時)
TimeHelper::secondHour(2);

//返回N天的秒數(shù)(默認(rèn)為1天)
TimeHelper::secondDay(10);

//返回N周的秒數(shù)(默認(rèn)為1周)
TimeHelper::secondWeek(4);

2. 返回友好的日期格式,比如N秒前,N分鐘前,N小時前等等

一般用于社交類平臺,評論,論壇等

//一共2個參數(shù):
//第1個參數(shù)傳入字符串類型的時間或者時間戳都可以，
//第2個參數(shù)為語言(默認(rèn)為中文,需要英文請傳入en)
TimeHelper::toFriendly('2022-3-2 10:15:33');
//英文
TimeHelper::toFriendly(1646186290, 'en');

3. 判斷時間范圍

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

//判斷日期是否為本周
TimeHelper::isThisWeek('2020-5-1');

//判斷日期是否為本月
TimeHelper::isThisMonth(1586451741);

//判斷日期是否為今年
TimeHelper::isThisYear('Apr 11, 2020');

//判斷指定時間是星期幾,不傳默認(rèn)為當(dāng)前時間. 返回值為1-7,1為星期一,7為星期日
TimeHelper::getWeek('2022-11-27');

//判斷指定時間是否為平常日(周一到周五)
TimeHelper::isWeekday('2023-03-08');

//判斷指定時間是否為周末(周六和周日)
TimeHelper::isWeekend(1586451741);

4. 計(jì)算兩個時間相差值

如果只傳入一個參數(shù),則與當(dāng)前時間比較

//計(jì)算兩個日期相差天數(shù)
TimeHelper::diffDays('2022-4-10 23:01:11','Apr 11, 2020');

//計(jì)算兩個日期相差周數(shù)
TimeHelper::diffWeeks('2022-4-10 23:01:11');

//計(jì)算兩個日期相差月數(shù)
TimeHelper::diffMonths(1586451741,'Apr 11, 2020');

//計(jì)算兩個日期相差年數(shù)
TimeHelper::diffYears('2022-4-10 23:01:11','Apr 11, 2020');

5. 返回N小時/天/星期/月/年前或者后的時間戳

只傳入1個參數(shù)以當(dāng)前時間計(jì)算,傳入第2個參數(shù)則以該時間計(jì)算,傳入第3個參數(shù)為true,則時間取整

//返回指定時間3分鐘前0秒的時間戳
TimeHelper::beforeMinute(3,'2022-3-2 10:15:33',true);

//返回當(dāng)前時間5分鐘后的時間戳
TimeHelper::afterMinute(5);

//返回指定時間1小時前的時間戳(請注意此用法為php8之后的用法)
TimeHelper::beforeHour(datetime:'Apr 11, 2020');

//返回2小時后的時間戳
TimeHelper::afterHour(2);

//返回15天前0點(diǎn)的時間戳
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);

6.獲取當(dāng)前秒級/毫秒級/微秒級/納秒級的時間戳

生成訂單號或者與其他編程語言對接時可能會用到

//獲取秒級的時間戳,可用time()代替
TimeHelper::getTimestamp();

//獲取毫秒級的時間戳
TimeHelper::getMilliTimestamp();

//獲取微秒級的時間戳
TimeHelper::getMicroTimestamp();

//獲取納秒級的時間戳
TimeHelper::getNanoTimestamp();

7.日期轉(zhuǎn)換

用于爬蟲爬取網(wǎng)頁或第三方程序?qū)訒r,時間格式不統(tǒng)一的轉(zhuǎn)換

//將任意格式的時間轉(zhuǎn)換為指定格式
//第一個參數(shù)是時間格式,與系統(tǒng)函數(shù)date()的格式保持一致
//第二個參數(shù)則是任意格式的時間日期,不傳則默認(rèn)為當(dāng)前時間,可用系統(tǒng)函數(shù)date()代替
TimeHelper::format('Y-m-d H:i:s','May 3, 2022');

//判斷一個字符串是否為時間戳,是返回true,否返回false
TimeHelper::isTimestamp(1646360133);

//將任意時間類型的字符串轉(zhuǎn)為時間戳
TimeHelper::toTimestamp('Apr 11, 2020');

8.平閏年相關(guān)

比原生方法使用起來更方便

//判斷是否為閏年,是返回true,否返回false
TimeHelper::isLeapYear('2020-3-2 10:15:33');

//判斷該日期的當(dāng)年有多少天
TimeHelper::daysInYear(1646360133);

//判斷該日期的當(dāng)月有多少天
TimeHelper::daysInMonth('Apr 11, 2020');

9.時區(qū)相關(guān) ??

主要提供獲取不同時區(qū)的時間和轉(zhuǎn)換不同時區(qū)的時間的方法

//將任意格式的時間或時間戳轉(zhuǎn)換為指定時區(qū)的時間
//第一個參數(shù)為要轉(zhuǎn)換的目標(biāo)時區(qū)
//第二個參數(shù)為原時區(qū),不傳則默認(rèn)為當(dāng)前時區(qū)
//第三個參數(shù)為任意格式的時間或時間戳,不傳則默認(rèn)為當(dāng)前時間
//第四個參數(shù)為時間格式,與系統(tǒng)函數(shù)date()的格式保持一致,不傳則默認(rèn)為Y-m-d H:i:s
TimeHelper::timezoneFormat('Europe/London', 'Asia/Shanghai', '2023-8-15 19:16:43', 'H:i:s');
//獲得當(dāng)前洛杉磯的時間
TimeHelper::timezoneFormat('America/Los_Angeles');
//將洛杉磯時間轉(zhuǎn)換為倫敦時間
TimeHelper::timezoneFormat('Europe/London', 'America/Los_Angeles', 'Aug 15, 2023 10:15:33', 'H:i:s');
//將時間戳轉(zhuǎn)換為倫敦時間
TimeHelper::timezoneFormat('Europe/London', null, 1692097543);

所支持的時區(qū)列表請參考時區(qū)列表

10.國內(nèi)節(jié)假日/工作日相關(guān) ??

專門針對國內(nèi)的節(jié)假日進(jìn)行判斷,目前包含2020年-2024年的節(jié)假日數(shù)據(jù),后續(xù)也會持續(xù)更新.
為了便于維護(hù),另起了一個類ChinaHoliday,同樣可以傳入任意類型的時間格式或時間戳

use zjkal\ChinaHoliday;

//判斷指定日期是否為國內(nèi)的工作日
ChinaHoliday::isWorkday('2023-01-23');

//判斷指定日期是否為國內(nèi)的節(jié)假日
ChinaHoliday::isHoliday(1646360133);

特別說明: 所有時間的方法都可以傳入任意格式的時間或者時間戳, 但是有一點(diǎn)請注意 m/d/y 或 d-m-y 格式的日期，如果分隔符是斜線（/），則使用美洲的 m/d/y 格式。如果分隔符是橫杠（-）或者點(diǎn)（.），則使用歐洲的 d-m-y 格式。為了避免潛在的錯誤，您應(yīng)該盡可能使用 YYYY-MM-DD 格式或其他格式.