← PHP children() 函数 PHP krsort() 函数 →

PHP gmdate() 函数

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

( php 4+ )

函数原型

gmdate(format,timestamp);

参数说明

参数	描述
format	必需。规定输出日期字符串的格式
timestamp	可选。规定一个整数的 Unix 时间戳。默认是当前的本地时间 time()

日期格式化符号列表

格式化符	说明
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）

返回值

如果成功则返回格式化的日期字符串，如果失败则报 E_WARNING 错并返回 FALSE

范例

下面的范例格式化 GMT/UTC 日期和时间，并返回格式化的日期字符串

<?php

// Prints the day
echo gmdate("l") , "<br>";

// Prints the day, date, month, year, time, AM or PM

echo gmdate("l jS of F Y h:i:s A");

运行范例 »

更新日志

PHP 版本	更新说明
PHP 5.1.1	新增标准日期/时间格式常量，用于指定 format 参数
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

返回上一级