PHP gmdate() 函数

PHP Date / Time 函数

实例

格式化 GMT/UTC 日期和时间，并返回已格式化的日期字符串：

<?php
// 输出周几
echo gmdate("l") . "<br>";

// 输出周几、日、月、年，时间，上午或下午
echo gmdate("l jS \of F Y h:i:s A");
?>

运行实例

定义和用法

gmdate() 函数格式化 GMT/UTC 日期和时间，并返回格式化的日期字符串。

语法

gmdate(format,timestamp);
参数 描述
format

必需。规定输出日期字符串的格式。可使用下列字符：

  • d - 一个月中的第几天（从 01 到 31）
  • D - 星期几的文本表示（用三个字母表示）
  • j - 一个月中的第几天，不带前导零（1 到 31）
  • l（'L' 的小写形式）- 星期几的完整的文本表示
  • N - 星期几的 ISO-8601 数字格式表示（1表示Monday[星期一]，7表示Sunday[星期日]）
  • S - 一个月中的第几天的英语序数后缀（2 个字符：st、nd、rd 或 th。与 j 搭配使用）
  • w - 星期几的数字表示（0 表示 Sunday[星期日]，6 表示 Saturday[星期六]）
  • z - 一年中的第几天（从 0 到 365）
  • W - 用 ISO-8601 数字格式表示一年中的星期数字（每周从 Monday[星期一]开始）
  • F - 月份的完整的文本表示（January[一月份] 到 December[十二月份]）
  • m - 月份的数字表示（从 01 到 12）
  • M - 月份的短文本表示（用三个字母表示）
  • n - 月份的数字表示，不带前导零（1 到 12）
  • t - 给定月份中包含的天数
  • L - 是否是闰年（如果是闰年则为 1，否则为 0）
  • o - ISO-8601 标准下的年份数字
  • Y - 年份的四位数表示
  • y - 年份的两位数表示
  • a - 小写形式表示：am 或 pm
  • A - 大写形式表示：AM 或 PM
  • B - Swatch Internet Time（000 到 999）
  • g - 12 小时制，不带前导零（1 到 12）
  • G - 24 小时制，不带前导零（0 到 23）
  • h - 12 小时制，带前导零（01 到 12）
  • H - 24 小时制，带前导零（00 到 23）
  • i - 分，带前导零（00 到 59）
  • s - 秒，带前导零（00 到 59）
  • u - 微秒（PHP 5.2.2 中新增的）
  • e - 时区标识符（例如：UTC、GMT、Atlantic/Azores）
  • I（i 的大写形式）- 日期是否是在夏令时（如果是夏令时则为 1，否则为 0）
  • O - 格林威治时间（GMT）的差值，单位是小时（实例：+0100）
  • P - 格林威治时间（GMT）的差值，单位是 hours:minutes（PHP 5.1.3 中新增的）
  • T - 时区的简写（实例：EST、MDT）
  • Z - 以秒为单位的时区偏移量。UTC 以西时区的偏移量为负数（-43200 到 50400）
  • c - ISO-8601 标准的日期（例如 2013-05-05T16:34:42+00:00）
  • r - RFC 2822 格式的日期（例如 Fri, 12 Apr 2013 12:01:05 +0200）
  • U - 自 Unix 纪元（January 1 1970 00:00:00 GMT）以来经过的秒数

同时，也可使用下列预定义常量（从 PHP 5.1.0 开始可用）：

  • DATE_ATOM - Atom（例如：2013-04-12T15:52:01+00:00）
  • DATE_COOKIE - HTTP Cookies（例如：Friday, 12-Apr-13 15:52:01 UTC）
  • DATE_ISO8601 - ISO-8601（例如：2013-04-12T15:52:01+0000）
  • DATE_RFC822 - RFC 822（例如：Fri, 12 Apr 13 15:52:01 +0000）
  • DATE_RFC850 - RFC 850（例如：Friday, 12-Apr-13 15:52:01 UTC）
  • DATE_RFC1036 - RFC 1036（例如：Fri, 12 Apr 13 15:52:01 +0000）
  • DATE_RFC1123 - RFC 1123（例如：Fri, 12 Apr 2013 15:52:01 +0000）
  • DATE_RFC2822 - RFC 2822（Fri, 12 Apr 2013 15:52:01 +0000）
  • DATE_RFC3339 - 与 DATE_ATOM 相同（从 PHP 5.1.3 开始）
  • DATE_RSS - RSS（Fri, 12 Aug 2013 15:52:01 +0000）
  • DATE_W3C - 万维网联盟（例如：2013-04-12T15:52:01+00:00）
timestamp 可选。规定整数的 Unix 时间戳。默认是当前的本地时间（time()）。

技术细节

返回值： 如果成功则返回已格式化的日期字符串，如果失败则报 E_WARNING 错并返回 FALSE。
PHP 版本： 4+
更新日志：

PHP 5.1.0：有效范围的时间戳是从 1901 年 12 月 13 日 20:45:54 GMT 星期五 到 2038 年 1 月 19 日 03:14:07 GMT 星期二。5.1.0 之前的版本，在某些系统上（例如 Windows）时间戳被限制在从 01-01-1970 到 19-01-2038。

PHP 5.1.1：新增标准日期/时间格式常量，用于指定 format 参数。

PHP Date / Time 函数