Date/Time 函数（不包含别名函数） · 开发者必备的知识

## checkdate(int $month, int $day, int $year): bool — 验证一个格里高里日期(就是我们在使用的阳历) ~~~ echo checkdate('01','31','2021');//1 ~~~ ## **date\_default\_timezone\_get**— 取得一个脚本中所有日期时间函数所使用的默认时区 ~~~ date_default_timezone_get();//UTC utc:协调世界时，又称世界统一时间、世界标准时间、国际协调时间 ~~~ ## **date\_default\_timezone\_set**(string $timezone\_identifier): bool — 设定用于一个脚本中所有日期时间函数的默认时区 [所支持的时区列表](https://www.php.net/manual/zh/timezones.php) ~~~ /* Asia/Shanghai —— 上海 Asia/Chongqing —— 重庆 Asia/Urumqi —— 乌鲁木齐 Asia/Hong_Kong —— 香港 Asia/Macao —— 澳门 Asia/Taipei —— 台北 Asia/Singapore —— 新加坡 PRC —— 中国时区 */ echo date_default_timezone_get();//UTC echo time()."\n";//1638434020 echo date('Y-m-d H:i:s',time());//2021-12-02 08:33:40 date_default_timezone_set('PRC'); echo date_default_timezone_get();//PRC echo time()."\n";//1638434020 echo date('Y-m-d H:i:s',time());//2021-12-02 16:33:40 ~~~ ## date\_parse\_from\_format(string $format, string $datetime): array — 获取根据指定格式格式化的给定日期的信息 ~~~ $date = "6.1.2009 13:00+01:00"; print_r(date_parse_from_format("j.n.Y H:iP", $date));//返回指定日期/时间的详细信息(如年月日等)的关联数组 ~~~ ## date\_parse(string $datetime): array — 返回指定日期/时间的详细信息的关联数组 ~~~ print_r(date_parse("2006-12-12 10:00:00.5")); ~~~ ## date\_sunrise—返回给定的日期与地点(东经北纬)的日出时间（PHP 5.1.2） ## date\_sunset—返回给定的日期与地点(东经北纬)的日落时间 ## date\_sun\_info — 返回一个包含日落/日出和黄昏开始/结束信息的数组 ## **date**(string $format, int $timestamp=time()): string — 格式化一个本地时间／日期 ~~~ date('Y-m-d H:i:s',time());//2019-12-30 13:25:46 ~~~ ## getdate(int $timestamp = time()): array — 取得日期／时间信息 ~~~ $today = getdate(); print_r($today); /*结果: Array ( [seconds] => 40 [minutes] => 58 [hours] => 21 [mday] => 17 [wday] => 2 [mon] => 6 [year] => 2003 [yday] => 167 [weekday] => Tuesday [month] => June [0] => 1055901520 ) */ ~~~ gettimeofday(bool $return\_float = false): mixed — 取得当前时间本函数是 gettimeofday(2) 的接口。返回一个关联数组，包含有系统调用返回的数据。当其参数设为 true 时，会返回一个浮点数而不是一个数组。 ~~~ print_r(gettimeofday()); /*结果: Array ( [sec] => 1073504408//自 Unix 纪元起的秒数 [usec] => 238215//微秒数 [minuteswest] => 0//格林威治向西的分钟数 [dsttime] => 1//夏令时修正的类型 ) */ echo gettimeofday(true);//1073504408.23910 ~~~ gmdate(string $format, int $timestamp = ?): string — 格式化一个 GMT/UTC 日期／时间同 date() 函数完全一样，只除了返回的时间是格林威治标准时（GMT）。例如当在中国（GMT +0800）运行以下程序时，第一行显示“Jan 01 2000 00:00:00”而第二行显示“Dec 31 1999 16:00:00”。 ~~~ echo date("M d Y H:i:s", mktime (0,0,0,1,1,2000));//Jan 01 2000 00:00:00 echo gmdate("M d Y H:i:s", mktime (0,0,0,1,1,2000));//Dec 31 1999 16:00:00 ~~~ gmmktime — 取得 GMT 日期的 UNIX 时间戳和 mktime() 完全一样，只除了返回值是格林威治标准时的时间戳 gmstrftime — 根据区域设置格式化 GMT/UTC 时间／日期和 strftime() 的行为相同，只除了返回时间是格林威治标准时（GMT）。例如，当在东部标准时（EST，GMT -500）运行时，下面第一行显示“Dec 31 1998 20:00:00”，而第二行显示“Jan 01 1999 01:00:00”。 idate(string $format, int $timestamp = time()): int — 将本地时间日期格式化为整数和 date() 不同，idate() 只接受一个字符作为 format 参数 ~~~ echo idate('y', time());//2019 ~~~ localtime(int $timestamp = time(), bool $is\_associative = false): array — 取得本地时间 ~~~ $localtime = localtime(); print_r($localtime); /* Array ( [0] => 24 [1] => 3 [2] => 19 [3] => 3 [4] => 3 [5] => 105 [6] => 0 [7] => 92 [8] => 1 ) */ $localtime_assoc = localtime(time(), true); print_r($localtime_assoc); /* Array ( [tm_sec] => 24//秒数， 0 到 59 [tm_min] => 3//分钟数， 0 到 59 [tm_hour] => 19//小时， 0 到 23 [tm_mday] => 3//月份中的第几日， 1 到 31 [tm_mon] => 3//年份中的第几个月， 0 (Jan) 到 11 (Dec) [tm_year] => 105//份，从 1900 开始 [tm_wday] => 0//星期中的第几天， 0 (Sun) 到 6 (Sat) [tm_yday] => 92//一年中的第几天， 0 到 365 [tm_isdst] => 1//夏令时当前是否生效？如果是生效的是正数， 0 代表未生效，负数代表未知。 ) */ ~~~ microtime(bool $get\_as\_float = ?): mixed — 返回当前 Unix 时间戳和微秒数 ~~~ echo microtime();//0.94835200 1638429327 echo microtime(false);//0.94835200 1638429327 echo microtime(true);//1638429327.9484 ~~~ mktime(时,分,秒,月,日,年) — 取得一个日期的 Unix 时间戳(参数全是int型) ~~~ mktime(0, 0, 0, 12, 32, 1997);//883612800 ~~~ strftime(string $format, int $timestamp = time()): string — 根据区域设置格式化本地时间／日期 ~~~ echo strftime("%V,%G,%Y", strtotime("01/28/2021"));//04,2021,2021 ~~~ | `格式` | 描述 | 返回值示例 | | --- | --- | --- | | *日* | \--- | \--- | | `%a` | 当前区域星期几的简写 | `Sun`到`Sat` | | `%A` | 当前区域星期几的全称 | `Sunday`到`Saturday` | | `%d` | 月份中的第几天，十进制数字（范围从 01 到 31） | `01`到`31` | | `%e` | 月份中的第几天，十进制数字，一位的数字前会加上一个空格（范围从 ' 1' 到 '31'）在 Windows 上尚未按描述实现。更多信息见下方。 | `1`到`31` | | `%j` | 年份中的第几天，带前导零的三位十进制数（范围从 001 到 366） | `001`到`366` | | `%u` | 符合 ISO-8601 星期几的十进制数表达 \[1,7\]，1 表示星期一 | `1`(星期一) 到`7`(星期日) | | `%w` | 星期中的第几天，星期天为 0 | `0`(星期天) 到`6`(星期六) | | *周* | \--- | \--- | | `%U` | 本年的第几周，从第一周的第一个星期天作为第一天开始 | `13`(for the 13th full week of the year) | | `%V` | %V - 本年第几周的 ISO-8601:1988 格式，范围从 01 到 53，第 1 周是本年第一个至少还有 4 天的星期，星期一作为每周的第一天。（用 %G 或者 %g 作为指定时间戳相应周数的年份组成。） | `01`到`53`(where 53 accounts for an overlapping week) | | `%W` | 本年的第几周数，从第一周的第一个星期一作为第一天开始 | `46`(for the 46th week of the year beginning with a Monday) | | *月* | \--- | \--- | | `%b` | 当前区域月份的简写 | `Jan`到`Dec` | | `%B` | 当前区域月份的全称 | `January`到`December` | | `%h` | 当前区域月份的简写（%b 的别名） | `Jan`到`Dec` | | `%m` | 两位数的月份 | `01`(是一月份) 到`12`(是十二月份) | | *年* | \--- | \--- | | `%C` | 两位数显示世纪（年份除以 100，截成整数） | `19`是 20 世纪 | | `%g` | 2 位数的年份，符合 ISO-8601:1988 星期数（参见 %V）。和 %V 的格式和值一样，只除了如果 ISO 星期数属于前一年或者后一年，则使用那一年。 | 比如：2009年1月6日那一周是`09`。 | | `%G` | %g 的完整四位数版本 | 比如：2009年1月3日那一周是`2008`. | | `%y` | 两位数显示年份 | 比如：`09`是 2009，`79`是 1979 | | `%Y` | 四位数显示年份 | 比如：`2038` | | *时间* | \--- | \--- | | `%H` | 以 24 小时格式显示两位小时数 | `00`到`23` | | `%I` | 以 12 小时格式显示两位小时数 | `01`到`12` | | `%l（'L' 的小写）` | 以 12 小时格式显示小时数，单个数字前含空格 | `1`到`12` | | `%M` | 两位的分钟数 | `00`到`59` | | `%p` | 指定时间的大写 “AM” 或 “PM” | 比如： 00:31 是`AM`，22:23 是`PM` | | `%P` | 指定时间的小写 “am” 或 “pm” | 比如：00:31 是`am`，22:23 是`pm` | | `%r` | 和 "%I:%M:%S %p" 一样 | 比如： 21:34:17 是`09:34:17 PM` | | `%R` | 和 "%H:%M" 一样 | 比如： 12:35 AM 是`00:35`，4:44 PM 是`16:44` | | `%S` | 两位数字表示秒 | `00`到`59` | | `%T` | 和 "%H:%M:%S" 一样 | 比如： 09:34:17 PM 是`21:34:17` | | `%X` | 当前区域首选的时间表示法，不包括日期 | 例如：`03:59:16`或`15:59:16` | | `%z` | 从 UTC 的时区偏移或简写（由操作系统决定） | 比如：东部时间是`-0500`或`EST` | | `%Z` | %z 没有给出的 UTC 的时区偏移或简写（由操作系统决定） | 比如：`-0500`或`EST`是东部时间 | | *时间和日期戳* | \--- | \--- | | `%c` | 当前区域首选的日期时间表达 | 比如： 2009 年 2 月 5 日上午 12:45:10 是`Tue Feb 5 00:45:10 2009` | | `%D` | 和 "%m/%d/%y" 一样 | 比如： 2009 年 2 月 5 日是`02/05/09` | | `%F` | Same as "%Y-%m-%d" (commonly used in database datestamps) | 比如：2009 年 2 月 5 日是`2009-02-05` | | `%s` | Unix纪元的时间戳（和[time()](https://www.php.net/manual/zh/function.time.php)函数一样） | 比如： 1979 年 9 月 10 日上午 8 点 40 分 00 秒是`305815200` | | `%x` | 当前区域首选的时间表示法，不包括时间 | 比如： 2009 年 2 月 5 日是`02/05/09` | | *其他* | \--- | \--- | | `%n` | 换行符("\\n") | \--- | | `%t` | Tab 字符("\\t") | \--- | | `%%` | 文字上的百分字符("%") | \--- | strptime(string $date, string $format): array — 解析由 strftime 生成的日期／时间 strptime() 返回一个将 date 解析后的数组，如果出错返回 false。 ~~~ $format = '%d/%m/%Y %H:%M:%S'; $strf = strftime($format); echo "$strf\n";//03/10/2004 15:54:19 print_r(strptime($strf, $format)); /* Array ( [tm_sec] => 19//当前分钟内的秒数（0-61） [tm_min] => 54//当前小时内的分钟数（0-59） [tm_hour] => 15//午夜起的小时数（0-23） [tm_mday] => 3//月份中的第几天（1-31） [tm_mon] => 9//自一月起过了几个月（0-11） [tm_year] => 104//自 1900 年起过了几年 [tm_wday] => 0//自星期天起过了几天（0-6） [tm_yday] => 276// 本年自一月一日起过了多少天（0-365） [unparsed] =>//date 中未能通过指定的 format 识别的部分 ) */ ~~~ strtotime(string $datetime, int $now = time()): int — 将任何字符串的日期时间描述解析为 Unix 时间戳 ~~~ echo strtotime("+1 day",strtotime('2025-12-25')), "\n";//1766707200 echo strtotime("now"), "\n";//1638432685 echo strtotime("+1 week"), "\n";//1639037485 echo strtotime("+1 week 2 days 4 hours 2 seconds"), "\n";//1639224687 echo strtotime("next Thursday"), "\n";//1639008000 echo strtotime("last Monday"), "\n";//1638144000 //此格式第二个参数无效 echo strtotime("10 September 2000"), "\n";//968544000 ~~~ time — 返回当前的 Unix 时间戳 ~~~ time();//1638432685 ~~~ timezone\_name\_from\_abbr(string $abbr, int $utcOffset = -1, int $isDST = -1): string|false — 从缩写中返回时区名称 ~~~ echo timezone_name_from_abbr("CET") . "\n";//Europe/Berlin echo timezone_name_from_abbr("", 3600, 0) . "\n";//Europe/Paris ~~~ timezone\_version\_get(): string — 获取 timezonedb 的版本 ~~~ echo timezone_version_get();//2017.3 ~~~