PHP Date/Time 日期时间函数
PHP Date/Time 简介
Date/Time 函数允许您从 PHP 脚本运行的服务器上获取日期和时间。您可以使用 Date/Time 函数通过不同的方式来格式化日期和时间。
注释: 这些函数依赖于服务器的本地设置。使用这些函数时请记住要考虑夏令时和闰年。
安装
PHP Date/Time 函数是 PHP 核心的组成部分。无需安装即可使用这些函数。
Runtime 配置
Date/Time 函数的行为受到 php.ini 中设置的影响:
| 名称 | 描述 | 默认值 | PHP 版本 |
|---|---|---|---|
| date.timezone | 默认时区（所有的 Date/Time 函数使用该选项） | "" | PHP 5.1 |
| date.default_latitude | 默认纬度（date_sunrise() 和 date_sunset() 使用该选项） | "31.7667" | PHP 5.0 |
| date.default_longitude | 默认经度（date_sunrise() 和 date_sunset() 使用该选项） | "35.2333" | PHP 5.0 |
| date.sunrise_zenith | 默认日出天顶（date_sunrise() 和 date_sunset() 使用该选项） | "90.83" | PHP 5.0 |
| date.sunset_zenith | 默认日落天顶（date_sunrise() 和 date_sunset() 使用该选项） | "90.83" | PHP 5.0 |
PHP Date/Time 函数
| 函数 | 描述 |
|---|---|
| checkdate() | 验证格利高里日期。 |
| date_add() | 添加日、月、年、时、分和秒到日期。 |
| date_create_from_format() | 返回根据指定格式进行格式化的新的 DateTime 对象。 |
| date_create() | 返回新的 DateTime 对象。 |
| date_date_set() | 设置新日期。 |
| date_default_timezone_get() | 返回由所有的 Date/Time 函数使用的默认时区。 |
| date_default_timezone_set() | 设置由所有的 Date/Time 函数使用的默认时区。 |
| date_diff() | 返回两个日期间的差值。 |
| date_format() | 返回根据指定格式进行格式化的日期。 |
| date_get_last_errors() | 返回日期字符串中的警告/错误。 |
| date_interval_create_from_date_string() | 从字符串的相关部分建立 DateInterval。 |
| date_interval_format() | 格式化时间间隔。 |
| date_isodate_set() | 设置 ISO 日期。 |
| date_modify() | 修改时间戳。 |
| date_offset_get() | 返回时区偏移。 |
| date_parse_from_format() | 根据指定的格式返回带有关于指定日期的详细信息的关联数组。 |
| date_parse() | 返回带有关于指定日期的详细信息的关联数组。 |
| date_sub() | 从指定日期减去日、月、年、时、分和秒。 |
| date_sun_info() | 返回包含有关指定日期与地点的日出/日落和黄昏开始/黄昏结束的信息的数组。 |
| date_sunrise() | 返回指定日期与位置的日出时间。 |
| date_sunset() | 返回指定日期与位置的日落时间。 |
| date_time_set() | 设置时间。 |
| date_timestamp_get() | 返回 Unix 时间戳。 |
| date_timestamp_set() | 设置基于 Unix 时间戳的日期和时间。 |
| date_timezone_get() | 返回给定 DateTime 对象的时区。 |
| date_timezone_set() | 设置 DateTime 对象的时区。 |
| date() | 格式化本地日期和时间。 |
| getdate() | 返回某个时间戳或者当前本地的日期/时间的日期/时间信息。 |
| gettimeofday() | 返回当前时间。 |
| gmdate() | 格式化 GMT/UTC 日期和时间。 |
| gmmktime() | 返回 GMT 日期的 UNIX 时间戳。 |
| gmstrftime() | 根据区域设置对 GMT/UTC 日期和时间进行格式化。 |
| idate() | 将本地时间/日期格式化为整数。 |
| localtime() | 返回本地时间。 |
| microtime() | 返回当前时间的微秒数。 |
| mktime() | 返回日期的 Unix 时间戳。 |
| strftime() | 根据区域设置对本地时间/日期进行格式化。 |
| strptime() | 解析由 strftime() 生成的时间/日期。 |
| strtotime() | 将任何英文文本的日期或时间描述解析为 Unix 时间戳。 |
| time() | 返回当前时间的 Unix 时间戳。 |
| timezone_abbreviations_list() | 返回包含夏令时、偏移量和时区名称的关联数组。 |
| timezone_identifiers_list() | 返回带有所有时区标识符的索引数组。 |
| timezone_location_get() | 返回指定时区的位置信息。 |
| timezone_name_from_ abbr() | 根据时区缩略语返回时区名称。 |
| timezone_name_get() | 返回时区的名称。 |
| timezone_offset_get() | 返回相对于 GMT 的时区偏移。 |
| timezone_open() | 创建新的 DateTimeZone 对象。 |
| timezone_transitions_get() | 返回时区的所有转换。 |
| timezone_version_get() | 返回时区数据库的版本。 |
PHP 预定义的 Date/Time 常量
| 常量 | 描述 |
|---|---|
| DATE_ATOM | Atom (例如: 2019-01-18T14:13:03+00:00) |
| DATE_COOKIE | HTTP Cookies (例如: Fri, 18 Jan 2019 14:13:03 UTC) |
| DATE_ISO8601 | ISO-8601 (例如: 2019-01-18T14:13:03+0000) |
| DATE_RFC822 | RFC 822 (例如: Fri, 18 Jan 2019 14:13:03 +0000) |
| DATE_RFC850 | RFC 850 (例如: Friday, 18-Jan-19 14:13:03 UTC) |
| DATE_RFC1036 | RFC 1036 (例如: Friday, 18-Jan-19 14:13:03 +0000) |
| DATE_RFC1123 | RFC 1123 (例如: Fri, 18 Jan 2019 14:13:03 +0000) |
| DATE_RFC2822 | RFC 2822 (例如: Fri, 18 Jan 2019 14:13:03 +0000) |
| DATE_RFC3339 | Same as DATE_ATOM (since PHP 5.1.3) |
| DATE_RFC3339_EXTENDED | RFC3339 Extended format (since PHP 7.0.0) (例如: 2019-01-18T16:34:01.000+00:00) |
| DATE_RSS | RSS (Fri, 18 Jan 2019 14:13:03 +0000) |
| DATE_W3C | World Wide Web Consortium (例如: 2019-01-18T14:13:03+00:00) |
| SUNFUNCS_RET_TIMESTAMP | Timestamp (since PHP 5.1.2) |
| SUNFUNCS_RET_STRING | Hours:minutes (例如: 09:41) (since PHP 5.1.2) |
| SUNFUNCS_RET_DOUBLE | Hours as a floating point number (例如: 9.75) (since PHP 5.1.2) |
