DateTime 类

简介

表示日期和时间。

类摘要

class DateTime
时间日期类
constant ATOM

格式:Y-m-dTH:i:s(例: 2005-08-15T15:52:01+00:00)

constant COOKIE

格式:l, d-M-y H:i:s T(例: Monday, 15-Aug-05 15:52:01 UTC)

constant ISO8601

格式:Y-m-dTH:i:sO(例: 2005-08-15T15:52:01+0000)

constant RFC822

格式:D, d M y H:i:s O(例: Mon, 15 Aug 05 15:52:01 +0000)

constant RFC850

格式:l, d-M-y H:i:s T(例: Monday, 15-Aug-05 15:52:01 UTC)

constant RFC1036

格式:D, d M y H:i:s O(例: Mon, 15 Aug 05 15:52:01 +0000)

constant RFC1123

格式:D, d M Y H:i:s O(例: Mon, 15 Aug 2005 15:52:01 +0000)

constant RFC2822

格式:D, d M Y H:i:s O(Mon, 15 Aug 2005 15:52:01 +0000)

constant RFC3339

格式:Y-m-dTH:i:sP 同DATE_ATOM (自从 PHP 5.1.3)

constant RSS

格式:D, d M Y H:i:s O(Mon, 15 Aug 2005 15:52:01 +0000)

constant W3C

格式:Y-m-dTH:i:sP World Wide Web Consortium (例: 2005-08-15T15:52:01+00:00)

construct([$time[, $timezone]])
参数:
  • $now (string) – 日期时间字符串.
  • $timezone (DateTimeZone) – $time的DateTimeZone对象
返回:

新DateTime实例. 过程化风格在失败时返回 FALSE.

Exception:

Emits Exception in case of an error.

add([$object, ]$interval)
参数:
  • $object (DateTime) – 仅过程化风格:由 date_create() 返回的 DateTime 类型的对象。此函数会修改这个对象。
  • $interval (DateInterval) – DateInterval 对象
返回:

返回被修改的 DateTime 对象, 失败返回 FALSE.

createFromFormat($format, $time[, $timezone])
参数:
  • $format (string) –
  • $time (string) –
  • $timezone (DateTimeZone) –
返回:

新DateTime实例 或者在失败时返回 FALSE.

diff(DateTime $datetime2[, bool $absolute = false])
参数:
  • $datetime2 (DateTime) –
  • $absolute (bool) –
返回:

DateInterval对象,表示两个日期之间的差异 或者在失败时返回 FALSE.

format($format)
参数:
  • $format (string) –
getLastErrors(void)
getOffset(void)
getTimestamp(void)
getTimezone(void)
modify($modify)
参数:
  • $modify (string) –
__set_state($array)
参数:
  • $array (array) –
setDate($year, $month, $day)
参数:
  • $year (int) –
  • $month (int) –
  • $day (int) –
setISODate($year, $week[, $day])
参数:
  • $year (int) –
  • $week (int) –
  • $day (int) – 默认1
setTime($hour, $minute[, $second])
参数:
  • $hour (int) –
  • $minute (int) –
  • $second (int) – 默认0
setTimestamp($unixtimestamp)
参数:
  • $unixtimestamp (int) –
setTimezone($timezone)
参数:
sub($interval)
参数:
__wakeup(void)

更新日志

版本 说明
5.2.2 比较DateTime对象的比较操作符改为按预期工作。在此之前,所有的DateTime对象被认为是相等的 (使用 ==).