waDatetime

Методы

• 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

wa_date('humandatetime')

Сегодня 17:11

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

wa_parse_date ('humandate', 'November 8, 2013', null, 'en_US')

2013-11-08