欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

TimeHelper簡單快捷PHP日期時間助手類庫使用詳解

 更新時間：2023年09月03日 16:11:01   作者：zjkal  
這篇文章主要為大家介紹了TimeHelper簡單快捷PHP日期時間助手類庫使用詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪

TimeHelper 是一個簡單易用的PHP時間日期助手類庫,可以快速實現(xiàn)常用的時間日期操作,比如獲取指定時間的秒數(shù),獲取友好的時間格式,判斷時間范圍,計算兩個時間相差值,返回N小時/天/星期/月/年前或者后的時間戳等等

特性

  • 簡單易用: 不依賴任何擴展,開箱即用
  • 化繁為簡: 所有方法都可以傳入任意類型的時間日期格式或時間戳
  • 快捷高效: 所有操作只需要一個靜態(tài)方法即可完成
  • 長期維護: 作者為自由職業(yè)者,保證項目的長期穩(wěn)定和持續(xù)更新

??安裝

通過Composer導(dǎo)入類庫

composer require zjkal/time-helper

??使用文檔

首先在類中引用TimeHelper助手類

use zjkal\TimeHelper;

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

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

//返回到今天晚上零點之前的秒數(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. 計算兩個時間相差值

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

//計算兩個日期相差天數(shù)
TimeHelper::diffDays('2022-4-10 23:01:11','Apr 11, 2020');
//計算兩個日期相差周數(shù)
TimeHelper::diffWeeks('2022-4-10 23:01:11');
//計算兩個日期相差月數(shù)
TimeHelper::diffMonths(1586451741,'Apr 11, 2020');
//計算兩個日期相差年數(shù)
TimeHelper::diffYears('2022-4-10 23:01:11','Apr 11, 2020');

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

只傳入1個參數(shù)以當(dāng)前時間計算,傳入第2個參數(shù)則以該時間計算,傳入第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點的時間戳
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é)假日進行判斷,目前包含2020年-2023年的節(jié)假日數(shù)據(jù),后續(xù)也會持續(xù)更新.

為了便于維護,另起了一個類ChinaHoliday,同樣可以傳入任意類型的時間格式或時間戳

use zjkal\ChinaHoliday;
//判斷指定日期是否為國內(nèi)的工作日
ChinaHoliday::isWorkday('2023-01-23');
//判斷指定日期是否為國內(nèi)的節(jié)假日
ChinaHoliday::isHoliday(1646360133);

 特別說明:

所有時間的方法都可以傳入任意格式的時間或者時間戳, 但是有一點請注意 m/d/y 或 d-m-y

格式的日期，如果分隔符是斜線（/），則使用美洲的 m/d/y 格式。如果分隔符是橫杠（-）或者點（.），則使用歐洲的 d-m-y

格式。為了避免潛在的錯誤，您應(yīng)該盡可能使用 YYYY-MM-DD 格式或其他格式.

??開源協(xié)議

TimeHelper遵循MIT開源協(xié)議, 意味著您無需任何授權(quán),即可免費將TimeHelper應(yīng)用到您的項目中

以上就是TimeHelper簡單快捷PHP日期時間助手類庫使用詳解的詳細(xì)內(nèi)容，更多關(guān)于PHP TimeHelper日期時間助手類庫的資料請關(guān)注腳本之家其它相關(guān)文章！

相關(guān)文章

最新評論