Joomla! API

下载
启动

Date

扩展 DateTime

Date 是一个存储日期并提供逻辑来以各种格式操作和呈现该日期的类。

属性读取字符串

t - 给定月份中的天数。

N - ISO-8601 星期几的数字表示。

z - 一年中的第几天（从 0 开始）。

L - 是否为闰年。

d - 月份中的第几天，两位数，前面加零。

H - 24 小时制的小时，前面加零。

i - 分钟，前面加零。

s - 秒，前面加零。

u - 微秒，前面加零。

m - 月份的数字表示，前面加零。

S - 月份中的第几天，用英语表示的序数后缀，2 个字符。

W - ISO-8601 年份中的第几周，以星期一开始。

Y - 年份的完整数字表示，4 位数字。
since

1.7.0
包

Joomla CMS

方法

__construct

构造函数。

__construct( date = 'now',  tz = null) :
since

1.7.0

参数

date

string字符串，格式为 strtotime() 接受的格式，默认为 "now"。

tz

mixed用于日期的时区。可以是字符串或 DateTimeZone 对象。

响应

mixed

__get

魔术方法，用于访问类通过 format 方法提供的日期的属性。

__get( name) :
since

1.7.0

参数

name

string属性的名称。

响应

mixed如果属性名称有效，则为一个值，否则为 null。

__toString

魔术方法，用于根据公共静态成员 Date::$format 中指定的格式呈现日期对象。

__toString() :
since

1.7.0

响应

string日期作为格式化字符串。

add

add(\DateInterval interval) : \Joomla\CMS\Date\Date|bool

将一定量的日、月、年、时、分、秒添加到 Date 对象中。

参数

interval

DateInterval

响应

Date|bool

calendar

以本地日历格式获取日期作为格式化字符串。

calendar( format,  local = false,  translate = true) :
since

1.7.0

参数

format

string日期格式规范字符串（参见 {@link PHP_MANUAL#date}）。

local

bool如果为 true，则返回本地时区中的日期字符串，如果为 false，则返回 GMT 时区中的日期字符串。

translate

bool如果为 true，则翻译本地化字符串

响应

string以指定格式 format 的日期字符串。

dayToString

将星期几的数字翻译成字符串。

dayToString( day,  abbr = false) :
since

1.7.0

参数

day

int星期几的数字。

abbr

bool是否返回缩写的星期几字符串？

响应

string星期几。

format

以格式化字符串获取日期。

format( format,  local = false,  translate = true) :
since

1.7.0

参数

format

string日期格式规范字符串（参见 {@link PHP_MANUAL#date}）。

local

bool如果为 true，则返回本地时区中的日期字符串，如果为 false，则返回 GMT 时区中的日期字符串。

translate

bool如果为 true，则翻译本地化字符串

响应

string以指定格式 format 的日期字符串。

getInstance

用于新 Date() 的代理。

getInstance( date = 'now',  tz = null) : \Joomla\CMS\Date\Date
static
since

1.7.3

参数

date

string字符串，格式为 strtotime() 接受的格式，默认为 "now"。

tz

mixed用于日期的时区。

响应

Date

getOffsetFromGmt

获取 GMT 时区的时间偏移量（以小时或秒为单位）。

getOffsetFromGmt( hours = false) :
since

1.7.0

参数

hours

bool如果为 true，则以小时为单位返回值。

响应

floatGMT 时区的时间偏移量（以小时或秒为单位）。

modify

modify( modify) : \Joomla\CMS\Date\Date|bool

通过以 strtotime() 接受的格式增加/减少来更改此对象的 timestamp。

参数

modify

string

响应

Date|bool

monthToString

将月份的数字翻译成字符串。

monthToString( month,  abbr = false) :
since

1.7.0

参数

month

int一年中的第几个月。

abbr

bool如果为 true，则返回缩写的月份字符串

响应

string一年中的第几个月。

setTimezone

包装 setTimezone() 函数并设置内部时区对象的方法。

setTimezone(\DateTimeZone tz) : \Joomla\CMS\Date\Date
since

1.7.0
note

由于 PHP 中的 bug，此方法无法进行类型提示：https://bugs.php.net/bug.php?id=61483

参数

tz

DateTimeZone新的 \DateTimeZone 对象。

响应

Date

sub

sub(\DateInterval interval) : \Joomla\CMS\Date\Date|bool

从 Date 对象中减去一定量的日、月、年、时、分、秒。

参数

interval

DateInterval

响应

Date|bool

toISO8601

以 ISO 8601 字符串获取日期。IETF RFC 3339 定义了 ISO 8601 格式，您可以在 IETF 网站上找到它。

toISO8601( local = false) :
link
since

1.7.0

参数

local

bool如果为 true，则返回本地时区中的日期字符串，如果为 false，则返回 GMT 时区中的日期字符串。

响应

string以 ISO 8601 格式的日期字符串。

toRFC822

以 RFC 822 字符串获取日期。IETF RFC 2822 替代了 RFC 822，其定义可以在 IETF 网站上找到。

toRFC822( local = false) :
link
since

1.7.0

参数

local

bool如果为 true，则返回本地时区中的日期字符串，如果为 false，则返回 GMT 时区中的日期字符串。

响应

string以 RFC 822 格式的日期字符串。

toSql

以 SQL datetime 字符串获取日期。

toSql( local = false, \Joomla\Database\DatabaseDriver db = null) :
link
since

2.5.0

参数

local

bool如果为 true，则返回本地时区中的日期字符串，如果为 false，则返回 GMT 时区中的日期字符串。

db

DatabaseDriver数据库驱动程序，如果要使用 Factory::getDbo()，则为 null。

响应

string以 SQL datetime 格式的日期字符串。

toUnix

以 UNIX 时间戳获取日期。

toUnix() :
since

1.7.0

响应

int日期作为 UNIX 时间戳。

常量

DAY_ABBR

值 "\x021\x03"

DAY_NAME

值 "\x022\x03"

MONTH_ABBR

值 "\x023\x03"

MONTH_NAME

值 "\x024\x03"

属性

daysinmonth

t - 给定月份中的天数。

类型

string

dayofweek

N - ISO-8601 星期几的数字表示。

类型

string

dayofyear

z - 一年中的第几天（从 0 开始）。

类型

string

isleapyear

L - 是否为闰年。

类型

bool

day

d - 月份中的第几天，两位数，前面加零。

类型

string

hour

H - 24 小时制的小时，前面加零。

类型

string

minute

i - 分钟，前面加零。

类型

string

second

s - 秒，前面加零。

类型

string

microsecond

u - 微秒，前面加零。

类型

string

month

m - 月份的数字表示，前面加零。

类型

string

ordinal

S - 月份中的第几天，用英语表示的序数后缀，2 个字符。

类型

string

week

W - ISO-8601 年份中的第几周，以星期一开始。

类型

string

year

Y - 年份的完整数字表示，4 位数字。

类型

string

format

使用 __toString() 魔术方法时要应用的格式字符串。

static
since

1.7.0

类型

string

gmt

用于存储 \DateTimeZone 对象的占位符，该对象将 GMT 作为时区。

static deprecated
since

1.7.0
已弃用

将在 6.0 中从 4.0 中删除 将被移除，不提供替换

类型

object

stz

用于存储 \DateTimeZone 对象的占位符，该对象将默认服务器时区作为时区。

static deprecated
since

1.7.0
已弃用

将在 6.0 中从 4.0 中删除 将被移除，不提供替换

类型

object

tz

用于呈现日期作为字符串的 \DateTimeZone 对象。

since

3.0.0

类型

DateTimeZone
  • \ Joomla
  • \ CMS
  • \ Date
  • \ Date