PHP :time(),date(),mktime()日期與時間函數庫{經常會忘卻掉}

checkdate ： 驗證日期的正確性。

date ： 將伺服器的時間格式化。

strftime ： 將伺服器的時間本地格式化。

getdate ： 獲得時間及日期資訊。

gettimeofday ： 取得目前時間。

gmdate ： 取得目前與 GMT 差後的時間。

easter_date ： 計算複活節日期。

easter_days ： 計算複活節與三月廿一日之間日期數。

mktime ： 取得 UNIX 時間戳記。

gmmktime ： 取得 UNIX 時間戳記的格林威治時間。

time ： 取得目前時間的 UNIX 時間戳記。

microtime ： 取得目前時間的 UNIX 時間戳記的百萬分之一秒值。

 

　　checkdate　驗證日期的正確性。

文法： int checkdate(int month, int day, int year);

傳回值： 整數

函數種類： 時間日期

內容說明 若日期是有效則返回 true，若日期有問題，則返回 false。本函數可以用來檢查日期是否有效。有效範圍如下：

年 為 0 至 32767 年

月 為 1 至 12 月

日 則隨著月份及閏年變化

date　將伺服器的時間格式化。

文法： string date(string format, int [timestamp]);

傳回值： 字串

函數種類： 時間日期

內容說明傳回值的?字串依配置的格式來決定。若有傳入時間戳記值，則將時間戳記格式化返回；若無傳入時間戳記值，則將目前伺服器的時間格式化返回。要將日期轉為其它的語系格式，應使用setlocale() 及 strftime() 二個函數。字串格式化的選項如下：

a - "am" 或是 "pm"

A - "AM" 或是 "PM"

d - 幾日，二位元字，若不足二位則前面補零; 如： "01" 至 "31"

D - 星期幾，三個英文字母; 如： "Fri"

F - 月份，英文全名; 如： "January"

h - 12 小時制的小時; 如： "01" 至 "12"

H - 24 小時制的小時; 如： "00" 至 "23"

g - 12 小時制的小時，不足二位不補零; 如： "1" 至 12"

G - 24 小時制的小時，不足二位不補零; 如： "0" 至 "23"

i - 分鐘; 如： "00" 至 "59"

j - 幾日，二位元字，若不足二位不補零; 如： "1" 至 "31"

l - 星期幾，英文全名; 如： "Friday"

m - 月份，二位元字，若不足二位則在前面補零; 如： "01" 至 "12"

n - 月份，二位元字，若不足二位則不補零; 如： "1" 至 "12"

M - 月份，三個英文字母; 如： "Jan"

s - 秒; 如： "00" 至 "59"

S - 字尾加英文序數，二個英文字母; 如： "th"，"nd"

t - 指定月份的天數; 如： "28" 至 "31"

U - 總秒數

w - 數字型的星期幾，如： "0" (星期日) 至 "6" (星期六)

Y - 年，四位元字; 如： "1999"

y - 年，二位元字; 如： "99"

z - 一年中的第幾天; 如： "0" 至 "365"

其它不在上列的字元則直接列出該字元。

使用範例，範例一：

<?

print(date( "l dS of F Y h：i：s A" ));

print("July 1, 2000 is on a " . date("l", mktime(0,0,0,7,1,2000)));

?>

 

　　範例二：

<?

$tomorrow = mktime(0,0,0,date("m") ,date("d")+1,date("Y"));

$lastmonth = mktime(0,0,0,date("m")-1,date("d"), date("Y"));

$nextyear = mktime(0,0,0,date("m"), date("d", date("Y")+1);

?>

 

　　參考 gmdate() mktime()

strftime　將伺服器的時間本地格式化。

文法： string strftime(string format, int [timestamp]);

傳回值： 字串

函數種類： 時間日期

內容說明傳回值的字串依配置的格式來決定。若有傳入時間戳記值，則將時間戳記格式化返回；若無傳入時間戳記值，則將目前伺服器的時間本地格式化返回。月份或者星期名稱隨著本地語系配置 setlocale() 的不同而改變。

返回的字串可以依下列的格式而定：

%a 星期幾的縮寫。

%A 星期幾的全名。

%b 月份名稱的縮寫。

%B 月份名稱的全名。

%c 本地端日期時間較佳表示字串。

%d 用數字表示本月的第幾天 (範圍為 00 至 31)。

%H 用 24 小時制數字表示小時數 (範圍為 00 至 23)。

%I 用 12 小時制數字表示小時數 (範圍為 01 至 12)。

%j 以數字表示當年度的第幾天 (範圍為 001 至 366)。

%m 月份的數字 (範圍由 1 至 12)。

%M 分鐘。

%p 以 'AM' 或 'PM' 表示本地端時間。

%S 秒數。

%U 數字表示為本年度的第幾周，第一個星期由第一個周日開始。

%W 數字表示為本年度的第幾周，第一個星期由第一個周一開始。

%w 用數字表示本周的第幾天 ( 0 為周日)。

%x 不含時間的日期標記法。

%X 不含日期的時間標記法。

%y 二位元字表示年份 (範圍由 00 至 99)。

%Y 完整的年份數字表示，即四位元。

%Z 時區或名稱縮寫。

%% % 字元。

使用範例

<?php

setlocale ("LC_TIME", "C");

print(strftime("%A in Finnish is "));

setlocale ("LC_TIME", "fi");

print(strftime("%A, in French "));

setlocale ("LC_TIME", "fr");

print(strftime("%A and in German "));

setlocale ("LC_TIME", "de");

print(strftime("%A.n"));

?> 

參考 setlocale() mktime()

getdate　獲得時間及日期資訊。

文法： array getdate(int timestamp);

傳回值： 數組

函數種類： 時間日期

內容說明 返回數組的元素包括下列的項目：

"seconds" - 秒

"minutes" - 分

"hours" - 時

"mday" - 當月的第幾天

"wday" - 當周的第幾天數字

"mon" - 月份數字

"year" - 年，數字

"yday" - 當年的第幾天數字; 如： "299"

"weekday" - 星期幾全名; 如： "Friday"

"month" - 月份全名; 如： "January"

gettimeofday　取得目前時間。

文法： array gettimeofday(void);

傳回值： 數組

函數種類： 時間日期

內容說明 返回數組的元素包括下列的項目：

"sec" - 秒

"usec" - 百萬分之一秒

"minuteswest" - 格林威治時間的分

"dsttime" - 目的的時區

gmdate　取得目前與 GMT 差後的時間。

文法： string gmdate(string format, int timestamp);

傳回值： 字串

函數種類： 時間日期

內容說明 本函數與 date() 函數相似，不同的是本函數返回與格林威治標準時間 (Greenwich Mean Time, GMT) 時間差後的時間

使用範例

<?php

echo date( "M d Y H：i：s",mktime(0,0,0,1,1,1998) );

echo gmdate( "M d Y H：i：s",mktime(0,0,0,1,1,1998) );

?>

若執行本範例的機器在芬蘭 (Finland, GMT +0200)，返回的結果為：

Jan 01 1998 00：00：00

Dec 31 1997 22：00：00

參考 date() mktime() gmmktime()

easter_date　計算複活節日期。

文法： int easter_date(int [year]);

傳回值： 整數

函數種類： 時間日期

內容說明： 輸入某一年份，則以 UNIX 時間戳記的格式返回該年的複活節日期，若沒有輸入年份，則計算當年的日期。值的?注意的是輸入的年份必需在公元 1970 至 2037 年之間，否則無法計算。

使用範例

<?

echo date("M-d-Y", easter_date(1999));

echo date("M-d-Y", easter_date(2000));

echo date("M-d-Y", easter_date(2001));

?>

返回結果為

Apr-04-1999

Apr-23-2000

Apr-15-2001

easter_days　計算複活節與三月廿一日之間日期數。

文法： int easter_days(int [year]);

傳回值： 整數

函數種類： 時間日期

內容說明 輸入某一年份，則以計算該年複活節與三月二十一日之間的日期數，若沒有輸入年份，則以當年計算。這個函數可以用來替代 easter_date() 1970-2037 年外範圍無法計算的問題。

使用範例

<?

echo easter_days(1999);

echo easter_days(1492);

echo easter_days(1913);

?>

返回結果為：

14 (4/4)

32 (4/22)

2 (3/23)

參考 easter_date()

mktime　取得 UNIX 時間戳記。

文法： int mktime(int hour, int minute, int second, int month, int day, int year);

傳回值： 整數

函數種類： 時間日期

內容說明： 輸入一個時間，則返回 UNIX 時間戳記的長整數。

使用範例

<?

echo date( "M-d-Y", mktime(0,0,0,12,32,1997) );

echo date( "M-d-Y", mktime(0,0,0,13,1,1997) );

echo date( "M-d-Y", mktime(0,0,0,1,1,1998) );

?>

參考 date() time()

gmmktime　取得 UNIX 時間戳記的格林威治時間。

文法： int gmmktime(int hour, int minute, int second, int month, int day, int year);

傳回值： 整數

函數種類： 時間日期

內容說明： 輸入一個時間，則返回 UNIX 的格林威治時間戳記的長整數。

time　取得目前時間的 UNIX 時間戳記。

文法： int time(void);

傳回值： 整數

函數種類： 時間日期

內容說明 返回目前時間的戳記值。

參考 date()

microtime　取得目前時間的 UNIX 時間戳記的百萬分之一秒值。

文法： string microtime(void);

傳回值： 字串

函數種類： 時間日期

內容說明 返回目前時間的百萬分之一秒戳記值。若作業系統沒有提供 gettimeofday() 的系統呼叫函數，則本函數亦無效。