--------------------------------------------------------------------------------
日期與時間函式庫
--------------------------------------------------------------------------------
本函式庫共有 12 個函式
checkdate: 驗証日期的正確性。
date: 將伺服器的時間格式化。
strftime: 將伺服器的時間本地格式化。
getdate: 獲得時間及日期資訊。
gettimeofday: 取得目前時間。
gmdate: 取得目前與 GMT 差的時間。
easter_date: 計算復活節日期。
easter_days: 計算復活節與三月廿一日之間日期數。
mktime: 取得 UNIX 時間戳記。
gmmktime: 取得 UNIX 時間戳記的格林威治時間。
time: 取得目前時間的 UNIX 時間戳記。
microtime: 取得目前時間的 UNIX 時間戳記的百萬分之一秒值。
--------------------------------------------------------------------------------
函式:checkdate()
--------------------------------------------------------------------------------
日期與時間函式庫
checkdate
驗証日期的正確性。
語法: int checkdate(int month, int day, int year);
傳回值: 整數
函式種類: 時間日期
內容說明
若日期是有效的則傳回 true，若日期有問題，則傳回 false。本函式可以用來檢查日期是否有效。有效范圍如下：
年 為 0 至 32767 年
月 為 1 至 12 月
日 則隨著月份及閏年變化
--------------------------------------------------------------------------------
函式:date()
--------------------------------------------------------------------------------
日期與時間函式庫
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()
--------------------------------------------------------------------------------
日期與時間函式庫
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()
--------------------------------------------------------------------------------
日期與時間函式庫
getdate
獲得時間及日期資訊。
語法: array getdate(int timestamp);
傳回值: 陣列
函式種類: 時間日期
內容說明
傳回陣列的元素包括下列的項目：
"seconds" - 秒
"minutes" - 分
"hours" - 時
"mday" - 當月的第幾天
"wday" - 當周的第幾天數字
"mon" - 月份數字
"year" - 年，數字
"yday" - 當年的第幾天數字; 如: "299"
"weekday" - 星期幾全名; 如: "Friday"
"month" - 月份全名; 如: "January"
--------------------------------------------------------------------------------
函式:gettimeofday()
--------------------------------------------------------------------------------
日期與時間函式庫
gettimeofday
取得目前時間。
語法: array gettimeofday(void);
傳回值: 陣列
函式種類: 時間日期
內容說明
傳回陣列的元素包括下列的項目：
"sec" - 秒
"usec" - 百萬分之一秒
"minuteswest" - 格林威治時間的分
"dsttime" - 目的的時區
--------------------------------------------------------------------------------
函式:gmdate()
--------------------------------------------------------------------------------
日期與時間函式庫
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()
--------------------------------------------------------------------------------
日期與時間函式庫
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()
--------------------------------------------------------------------------------
日期與時間函式庫
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()
--------------------------------------------------------------------------------
日期與時間函式庫
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()
--------------------------------------------------------------------------------
日期與時間函式庫
gmmktime
取得 UNIX 時間戳記的格林威治時間。
語法: int gmmktime(int hour, int minute, int second, int month, int day, int year);
傳回值: 整數
函式種類: 時間日期
內容說明
輸入一個時間，則傳回 UNIX 的格林威治時間戳記的長整數。
--------------------------------------------------------------------------------
函式:time()
--------------------------------------------------------------------------------
日期與時間函式庫
time
取得目前時間的 UNIX 時間戳記。
語法: int time(void);
傳回值: 整數
函式種類: 時間日期
內容說明
傳回目前時間的戳記值。
參考
date()
--------------------------------------------------------------------------------
函式:microtime()
--------------------------------------------------------------------------------
日期與時間函式庫
microtime
取得目前時間的 UNIX 時間戳記的百萬分之一秒值。
語法: string microtime(void);
傳回值: 字串
函式種類: 時間日期
內容說明
傳回目前時間的百萬分之一秒戳記值。若作業系統沒有提供 gettimeofday() 的系統呼叫函式，則本函式亦無效。
參考
time()
(http://www.fanqiang.com)
進入【UNIX論壇】
|
![[ 永遠的UNIX::UNIX技術資料的寶庫 ]](/images/title.gif)