php日期函數與php時間函數__函數

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 時區或名稱縮寫。
%% % 字元。

使用範例
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) 時間差後的時間

使用範例
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() 的系統呼叫函數，則本函數亦無效。