PHP4手册:函数库及函数(七) 日期与时间函式库
December 21th,2008 22:39:58 Category :
PHP+Mysql
Click (966)--------------------------------------------------------------------------------
日期与时间函式库
--------------------------------------------------------------------------------
本函式库共有 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()
