日期与时间函数库

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() 的系统呼叫函数，则本函数亦无效。

参考 time()