PHP4手册:函数库及函数(七) 日期与时间函式库

-------------------------------------------------------------------------------- 日子与功夫函式库 -------------------------------------------------------------------------------- 本函式库公有 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:00dec 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-1999apr-23-2000apr-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()