PHP date_create_from_format() 函数
PHP date_create_from_format() 函数返回一个根据指定格式进行格式化的新的 DateTime 对象
( php 5.3+ )
函数原型
date_create_from_format(ormat,time,timezone);
参数说明
参数 | 描述 |
---|---|
format | 必需。规定要使用的格式 |
time | 必需。规定一个日期/时间字符串。NULL 表示当前的日期/时间 |
timezone | 可选。规定time的时区。默认为当前时区 |
format参数字符串可以使用下表的格式化符
格式化符 | 说明 |
---|---|
d | 一个月中的第几天,带前导零 |
j | 一个月中的第几天,不带前导零 |
D | 一周中的某天(Mon - Sun) |
I | 一周中的某天(Monday - Sunday) |
S | 一个月中的第几天的英语后缀(st, nd, rd, th) |
F | 月份名称(January - December) |
M | 月份名称(Jan - Dec) |
m | 月份(01 - 12) |
n | 月份(1 - 12) |
Y | 年份(例如 2013) |
y | 年份(例如 13) |
a 或 A | am 或 pm |
g | 12 小时制,不带前导零 |
h | 12 小时制,带前导零 |
G | 24 小时制,不带前导零 |
H | 24 小时制,带前导零 |
i | 分,带前导零 |
s | 秒,带前导零 |
u | 微秒(多达六个数字) |
e、O、P 和 T | 时区标识符 |
U | 自 Unix 纪元以来经过的秒数(空格) |
# | 下列分隔符之一:;、:、/、.、,、-、(、) |
? | 一个随机字节 |
* | 随机字节直到下一个分隔/数字 |
! | 重置所有字段到 Unix 纪元 |
| | 如果所有字段都还没被解析,则重置所有字段到 Unix 纪元 |
+ | 如果存在,字符串中的尾随数据将导致警告,不是错误 |
返回值
如果成功则返回 DateTime 对象,如果失败则返回 FALSE
范例
下面的范例返回一个根据指定格式进行格式化的新的 DateTime 对象
<?php $date = date_create_from_format("j-M-Y","15-Mar-2013");