Методы
-
date
Возвращает строковое представление даты в соответствии с указанным форматом.
-
format
Возвращает удобное для чтения строковое представление даты.
-
getDefaultTimeZone
Возвращает используемую по умолчанию временную зону с помощью PHP-функции
date_default_timezone_get
. -
getFormat
Возвращает стандартное представление форматов для PHP-функции
date
, соответствующих форматам, использующимся во фреймворке. -
getFormatJS
Возвращает стандартное представление форматов даты/времени для использования в JavaScript-коде, соответствующих форматам, использующимся во фреймворке.
-
getTimeZones
Возвращает список доступных временных зон с локализованными наименованиями.
-
parse
Возвращает стандартное для PHP строковое представление времени, указанного в одном из форматов, которые используются во фреймворке.
public static function date ($format, $time = null, $timezone = null, $locale = null)
Возвращает строковое представление даты в соответствии с указанным форматом.
Параметры
-
$format
Формат представления даты. Допускается использовать символы формата, предусмотренные для PHP-функции
date
. Для отображения наименования месяца в нижнем регистре необходимо использовать символ f. -
$time
Метка времени. Если не указано, используется текущая метка времени.
-
$timezone
Строковый идентификатор временной зоны. Если не указано, используется автоматическое определение временной зоны.
-
$locale
Строковый идентификатор локали. Если не указано, используется автоматическое определение локали.
Пример
waDateTime::date('j f Y года', '06-11-2013')
Результат
6 ноября 2013 года
public static function format ($format, $time = null, $timezone = null, $locale = null)
Возвращает удобное для чтения строковое представление даты.
Параметры
-
$format
Формат представления даты/времени. Допускается использовать следующие обозначения формата:
humandatetime
: подставляет слова «вчера», «сегодня», «завтра» вместо соответствующих дат относительно текущей даты пользователяhumandate
: возвращает дату в форматеd f Y
, предназначенном для методаdate
(перечисленные далее форматы предназначены для использования этим же методом)date
: возвращает дату в форматеY-m-d
time
: возвращает дату в форматеH:i
fulltime
: возвращает дату в форматеH:i:s
datetime
: возвращает дату в форматеY-m-d H:i
fulldatetime
: возвращает дату в форматеY-m-d H:i:s
timestamp
: возвращает дату в форматеU
-
$time
Метка времени. Если не указано, используется текущая метка времени.
-
$timezone
Строковый идентификатор временной зоны. Если не указано, используется автоматическое определение временной зоны.
-
$locale
Строковый идентификатор локали. Если не указано, используется автоматическое определение локали.
Пример
waDateTime::format('humandatetime')
Результат
Сегодня 17:11
PHP-функции
function wa_date ($format, $time = null, $timezone = null, $locale = null)
Обертка для вызова метода format.
Пример
wa_date('humandatetime')
Результат
Сегодня 17:11
Модификаторы Smarty
-
wa_date
Форматирует метку времени средствами метода format. По умолчанию используется строка формата
date
. -
wa_datetime
Форматирует метку времени средствами метода format. По умолчанию используется строка формата
datetime
.
public static function getDefaultTimeZone()
Возвращает временную зону, используемую по умолчанию, с помощью PHP-функции date_default_timezone_get
.
Пример
waDateTime::getDefaultTimeZone()
Результат
Europe/Moscow
public static function getFormat ($format, $locale = null)
Возвращает стандартное представление форматов для PHP-функции date
, соответствующих форматам, использующимся во фреймворке.
Параметры
-
$format
Строковый идентификатор формата отображения времени, использующегося во фреймворке. Допускается использовать ключи подмассива
date_formats
, содержащегося в конфигурационном файле локали в директорииwa-system/locale/data/
, константы PHP-классаDateTime
, строки формата, допустимые для PHP-функцииdate
, либо один из идентификаторов, соответствующих предопределенным строкам формата отображения времени, описанным для метода format. -
$locale
Строковый идентификатор локали. Если не указано, используется автоматическое определение локали.
Пример
waDateTime::getFormat ('humandate', 'en_US')
Результат
F j, Y
public static function getFormatJS ($format, $locale = null)
Возвращает стандартное представление форматов даты/времени для использования в JavaScript-коде, соответствующих форматам, использующимся во фреймворке.
Параметры
-
$format
Строковый идентификатор формата, описанный для параметра
$format
метода getFormat. -
$locale
Строковый идентификатор локали. Если не указано, используется автоматическое определение локали.
Пример
waDateTime::getFormatJS ('humandate', 'en_US')
Результат
MM d, yy
public static function getTimeZones()
Возвращает список доступных временных зон с локализованными наименованиями.
Пример
waDateTime::getTimeZones()
Результат
Array ( [Pacific/Apia] => −11 Апия, Миндуэй, Ниуэ, Паго-Паго [Pacific/Fakaofo] => −10 Факаофо, Гонолулу, Джонсон, Раротонга, Таити [America/Adak] => −09 Адак [Pacific/Gambier] => −09 Остров Гамбье, Маркизы [America/Anchorage] => −08 Анкоридж, Джуно, Ном, Sitka, Якутат [Pacific/Pitcairn] => −08 Питкэрн ... [Asia/Anadyr] => +12 Анадырь, Камчатка, Магадан [Pacific/Auckland] => +12 Окленд, Чатэм, Фиджи, Фунафути, Кваджалейн [Pacific/Majuro] => +12 Маджуро, Науру, Тарава, Уэйк, Уоллис [Pacific/Enderbury] => +13 Эндербери, Тонгатапу [Pacific/Kiritimati] => +14 Киритимати )
public static function parse ($format, $string, $timezone = null, $locale = null)
Возвращает стандартное для PHP строковое представление времени, указанного в одном из форматов, которые используются во фреймворке.
Параметры
-
$format
Строковый идентификатор формата, описанный для метода format, кроме
humandatetime
. -
$string
Строковое представление времени, отформатированное в соответствии со строкой формата, указанной в параметре
$format
. -
$timezone
Строковый идентификатор временной зоны. Если не указано, используется автоматическое определение временной зоны.
-
$locale
Строковый идентификатор локали. Если не указано, используется автоматическое определение локали.
Пример
waDateTime::parse ('humandate', 'November 8, 2013', null, 'en_US')
Результат
2013-11-08
PHP-функции
function wa_parse_date ($format, $string, $timezone = null, $locale = null)
Обертка для вызова метода parse.
Пример
wa_parse_date ('humandate', 'November 8, 2013', null, 'en_US')
Результат
2013-11-08