Класс CakeTime

__get()источник public

__get( string $name )

Магический метод для обратной совместимости. Используется TimeHelper для получения статических переменных в CakeTime

Параметры

строка $name

Имя переменной

Возвращает

смешанное

__set()источник public

__set( string $name , mixes $value )

Магический метод для обратной совместимости. Используется TimeHelper для изменения статических переменных в CakeTime

Параметры

строка $name

Имя переменной

смешанные $value

Значение переменной

_strftime()source protected static

_strftime( string $format , integer $date )

Обработчик многобайтовых строк для strftime.

Обрабатывает utf8_encoding результата strftime при необходимости.

Параметры

строка $format

Строка формата.

целое число $date

Отметка времени для форматирования.

Возвращает

строка
строка с отформатированным значением и правильной кодировкой.

_translateSpecifier()source protected static

_translateSpecifier( array $specifier )

Вспомогательная функция для перевода совпавшего элемента спецификатора из регулярного выражения в спецификатор, безопасный для Windows и поддерживающий i18n.

Параметры

массив $specifier

Совпадение из регулярного выражения

Возвращает

строка
преобразованный элемент

convert()source public static

convert( string $serverTime , string|DateTimeZone $timezone )

Преобразует указанное время (в часовом поясе сервера) в местное время пользователя, учитывая его часовой пояс.

Параметры

строка $serverTime

Маркер времени Unix

строка|DateTimeZone $timezone

Строка часового пояса пользователя или объект DateTimeZone

Возвращает

целое число
Маркер времени Unix

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::convert

convertSpecifiers()source public static

convertSpecifiers( string $format , string $time null )

Преобразует строку, представляющую формат функции strftime, и возвращает формат, совместимый с Windows и i18n.

Параметры

строка $format

Формат со спецификаторами для функции strftime. Принимает специальный спецификатор %S, который имитирует модификатор S для функции date()

строка $time необязательно null

Маркер времени Unix

Возвращает

строка
Формат, безопасный для Windows и совместимый с функцией date(), для strftime

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::convertSpecifiers

dayAsSql()source public static

dayAsSql( integer|string|DateTime $dateString , string $fieldName , string|DateTimeZone $timezone null )

Возвращает частичную строку SQL для поиска всех записей между двумя моментами времени, которые происходят в один и тот же день.

Параметры

целое число|строка|DateTime $dateString

Маркер времени Unix, допустимая строка для strtotime() или объект DateTime

строка $fieldName

Имя поля базы данных для сравнения

строка|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращает

строка
Частичная строка SQL.

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::dayAsSql

daysAsSql()source public static

daysAsSql( integer|string|DateTime $begin , integer|string|DateTime $end , string $fieldName , string|DateTimeZone $timezone null )

Возвращает частичную строку SQL для поиска всех записей между двумя датами.

Параметры

целое число|строка|DateTime $begin

Маркер времени Unix, допустимая строка для strtotime() или объект DateTime

целое число|строка|DateTime $end

Маркер времени Unix, допустимая строка для strtotime() или объект DateTime

строка $fieldName

Имя поля базы данных для сравнения

строка|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращает

строка
Частичная строка SQL.

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::daysAsSql

format()source public static

format( integer|string|DateTime $date , integer|string|DateTime $format null , boolean|string $default false , string|DateTimeZone $timezone null )

Возвращает отформатированную строку даты, заданную либо маркером времени Unix, либо допустимой строкой даты для strtotime(). Данная функция также принимает строку времени и строку формата в качестве первых двух параметров. В этом случае функция работает как обёртка для TimeHelper::i18nFormat()

Примеры

Создание локализованного и отформатированного времени:

CakeTime::format('2012-02-15', '%m-%d-%Y'); // returns 02-15-2012
  CakeTime::format('2012-02-15 23:01:01', '%c'); // returns preferred date and time based on configured locale
  CakeTime::format('0000-00-00', '%d-%m-%Y', 'N/A'); // return N/A becuase an invalid date was passed
  CakeTime::format('2012-02-15 23:01:01', '%c', 'N/A', 'America/New_York'); // converts passed date to timezone

Параметры

целое число|строка|DateTime $date

Маркер времени Unix, допустимая строка для strtotime() или объект DateTime (или строка формата даты)

целое число|строка|DateTime $format необязательно null

строка формата даты (или маркер времени Unix, допустимая строка для strtotime() или объект DateTime)

логическое значение|строка $default необязательно false

Если передана недопустимая дата, будет выведено заданное значение по умолчанию. Передайте false, если вы хотите значение сырого преобразования

строка|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращает

строка
Отформатированная строка даты

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::format

См. также

CakeTime::i18nFormat()

fromString()source public static

fromString( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )

Возвращает маркер времени Unix, заданный либо маркером времени Unix, либо допустимой строкой даты для strtotime().

Параметры

целое число|строка|DateTime $dateString

Маркер времени Unix, допустимая строка для strtotime() или объект DateTime

строка|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращает

строка
Разложенный маркер времени

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::fromString

gmt()source public static

gmt( integer|string|DateTime $dateString null )

Возвращает GMT в виде маркера времени Unix.

Параметры

целое число|строка|DateTime $dateString необязательно null

Маркер времени Unix, допустимая строка для strtotime() или объект DateTime

Возвращает

целое число
Маркер времени Unix

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::gmt

i18nFormat()source public static

i18nFormat( integer|string|DateTime $date , string $format null , boolean|string $default false , string|DateTimeZone $timezone null )

Возвращает отформатированную строку даты, заданную либо маркером времени Unix, либо допустимой строкой даты для strtotime(). Учитывает формат даты по умолчанию для текущего языка, если используется файл LC_TIME.

Параметры

целое число|строка|DateTime $date

Маркер времени Unix, допустимая строка для strtotime() или объект DateTime

строка $format необязательно null

Строка формата strftime.

логическое значение|строка $default необязательно false

Если передана недопустимая дата, будет выведено заданное значение по умолчанию. Передайте false, если вы хотите значение сырого преобразования

строка|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращает

строка
Отформатированная и переведённая строка даты

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::i18nFormat

isFuture()source public static

isFuture( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )

Возвращает true, если заданная строка даты и времени находится в будущем.

Параметры

integer|string|DateTime $dateString

Маркер времени Unix, строка, подходящая для strtotime(), или объект DateTime

string|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращает

boolean
True, если строка даты и времени находится в будущем

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::isFuture

isPast()source public static

isPast( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )

Возвращает true, если заданная строка даты и времени находится в прошлом.

Параметры

integer|string|DateTime $dateString

Маркер времени Unix, строка, подходящая для strtotime(), или объект DateTime

string|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращает

boolean
True, если строка даты и времени находится в прошлом

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::isPast

isThisMonth()source public static

isThisMonth( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )

Возвращает true, если заданная строка даты и времени находится в текущем месяце.

Параметры

integer|string|DateTime $dateString

Маркер времени Unix, строка, подходящая для strtotime(), или объект DateTime

string|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращает

boolean
True, если строка даты и времени находится в текущем месяце

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::isThisMonth

isThisWeek()source public static

isThisWeek( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )

Возвращает true, если заданная строка даты и времени находится в текущей неделе.

Параметры

integer|string|DateTime $dateString

Маркер времени Unix, строка, подходящая для strtotime(), или объект DateTime

string|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращает

boolean
True, если строка даты и времени находится в текущей неделе

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::isThisWeek

isThisYear()source public static

isThisYear( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )

Возвращает true, если заданная строка даты и времени находится в текущем году.

Параметры

integer|string|DateTime $dateString

Маркер времени Unix, строка, подходящая для strtotime(), или объект DateTime

string|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращает

boolean
True, если строка даты и времени находится в текущем году

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::isThisYear

isToday()source public static

isToday( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )

Возвращает true, если заданная строка даты и времени является сегодняшним днем.

Параметры

integer|string|DateTime $dateString

Маркер времени Unix, строка, подходящая для strtotime(), или объект DateTime

string|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращает

boolean
True, если строка даты и времени является сегодняшним днем

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::isToday

isTomorrow()source public static

isTomorrow( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )

Возвращает true, если заданная строка даты и времени является завтрашним днем.

Параметры

integer|string|DateTime $dateString

Маркер времени Unix, строка, подходящая для strtotime(), или объект DateTime

string|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращает

boolean
True, если строка даты и времени была вчера

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::isTomorrow

isWithinNext()source public static

isWithinNext( string|integer $timeInterval , integer|string|DateTime $dateString , string|DateTimeZone $timezone null )

Возвращает true, если указанная дата и время находятся в указанном интервале, иначе false.

Параметры

string|integer $timeInterval

Числовое значение со временем. Пример допустимых типов: 6 часов, 2 дня, 1 минута.

integer|string|DateTime $dateString

Маркер времени Unix, строка, подходящая для strtotime(), или объект DateTime

string|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращает

boolean

listTimezones()source public static

listTimezones( integer|string $filter null , string $country null , boolean|array $options array() )

Получить список идентификаторов часовых поясов

Параметры

integer|string $filter необязательно null

Регулярное выражение для фильтрации идентификатора или один из констант класса DateTimeZone (PHP 5.3 и выше)

string $country необязательно null

Двухбуквенный код страны, совместимый с ISO 3166-1. Этот параметр используется только при установке $filter в DateTimeZone::PER_COUNTRY (доступно только в PHP 5.3 и выше)

boolean|array $options необязательно array()

Если true (значение по умолчанию), группирует список идентификаторов по основному региону. В противном случае массив, содержащий ключи group, abbr, before, и after. Установка group и abbr к true сгруппирует результаты и добавит сокращение часового пояса в значение отображения. Установите before и after для настройки обертки сокращения.

Возвращает

array
Список идентификаторов часовых поясов

С тех пор как

2.2

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::listTimezones

nice()source public static

nice( integer|string|DateTime $dateString null , string|DateTimeZone $timezone null , string $format null )

Возвращает красиво отформатированную строку даты для заданной строки даты и времени.

См. http://php.net/manual/ru/function.strftime.php для получения информации о форматировании с использованием строк локали.

Параметры

integer|string|DateTime $dateString необязательно null

Маркер времени Unix, строка, подходящая для strtotime(), или объект DateTime

string|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

string $format необязательно null

Используемый формат. Если null, используется CakeTime::$niceFormat

Возвращает

string
Отформатированная строка даты

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::nice

niceShort()source public static

niceShort( integer|string|DateTime $dateString null , string|DateTimeZone $timezone null )

Возвращает отформатированную строку описания даты для заданной строки даты и времени.

Если заданная дата — сегодня, возвращаемая строка может быть «Сегодня, 16:54». Если заданная дата — завтра, возвращаемая строка может быть «Завтра, 16:54». Если заданная дата была вчера, возвращаемая строка может быть «Вчера, 16:54». Если заданная дата находится на следующей или предыдущей неделе, возвращаемая строка может быть «В четверг, 16:54». Если год в $dateString совпадает с текущим годом, год не будет включён в возвращаемую строку.

Параметры

integer|string|DateTime $dateString optional null

Маркер времени UNIX, строка, подходящая для strtotime(), или объект DateTime

string|DateTimeZone $timezone optional null

Строка часового пояса или объект DateTimeZone

Возвращаемое значение

string
Строка описания относительной даты

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::niceShort

serverOffset()source public static

serverOffset( )

Возвращает смещение сервера от GMT в секундах.

Возвращаемое значение

integer
Смещение

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::serverOffset

timeAgoInWords()source public static

timeAgoInWords( integer|string|DateTime $dateTime , array $options array() )

Возвращает относительную или отформатированную абсолютную дату в зависимости от разницы между текущим временем и заданным значением даты и времени. $datetime должен быть в формате, распознаваемом функцией strtotime, например, в формате даты и времени MySQL.

Параметры:

• format => Формат по умолчанию, если относительное время превышает длительность, заданную end
• accuracy => Указывает, насколько точно должна быть описана дата (массив)
  • year => Формат, если годы > 0 (по умолчанию «день»)
  • month => Формат, если месяцы > 0 (по умолчанию «день»)
  • week => Формат, если недели > 0 (по умолчанию «день»)
  • day => Формат, если недели > 0 (по умолчанию «час»)
  • hour => Формат, если часы > 0 (по умолчанию «минута»)
  • minute => Формат, если минуты > 0 (по умолчанию «минута»)
  • second => Формат, если секунды > 0 (по умолчанию «секунда»)
• end => Конец относительного времени
• relativeString => Строка, совместимая с printf, при выводе прошедшего относительного времени
• relativeStringFuture => Строка, совместимая с printf, при выводе будущего относительного времени
• absoluteString => Строка, совместимая с printf, при выводе абсолютного времени
• userOffset => Смещение пользователя от GMT (в часах) Устаревшее, используйте вместо этого часовой пояс.
• timezone => Часовой пояс пользователя, в котором должен быть отформатирован метка времени.

Относительные даты выглядят примерно так:

• 3 недели, 4 дня назад
• 15 секунд назад

Формат даты по умолчанию — дд/мм/гггг, например: 18/02/09

Возвращаемая строка включает «назад» или «в» и предполагает, что вы добавите слово, например «Опубликовано» перед результатом функции.

ПРИМЕЧАНИЕ: Если разница составляет одну неделю или более, то точность отображения даты снижается до дня.

Параметры

integer|string|DateTime $dateTime

Метка времени UNIX, строка, подходящая для strtotime(), или объект DateTime

array $options optional array()

Формат по умолчанию, если метка времени используется в $dateString

Возвращаемое значение

string
Строка относительного времени.

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::timeAgoInWords

timezone()source public static

timezone( string|DateTimeZone $timezone null )

Возвращает объект часового пояса из строки или объекта часового пояса пользователя.

Параметры

string|DateTimeZone $timezone optional null

Строка часового пояса или объект DateTimeZone. Если значение null, пытается получить часовой пояс из конфигурационной переменной 'Config.timezone'.

Возвращаемое значение

DateTimeZone
Объект часового пояса

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::timezone

toAtom()source public static

toAtom( string $dateString , string|DateTimeZone $timezone null )

Возвращает дату, отформатированную для Atom RSS-лент.

Параметры

string $dateString

Строка даты и времени или метка времени UNIX

string|DateTimeZone $timezone optional null

Строка часового пояса или объект DateTimeZone

Возвращаемое значение

string
Отформатированная строка даты

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::toAtom

toQuarter()source public static

toQuarter( integer|string|DateTime $dateString , boolean $range false )

Возвращает квартал.

Параметры

integer|string|DateTime $dateString

Метка времени UNIX, строка, подходящая для strtotime(), или объект DateTime

boolean $range optional false

Если true, возвращает диапазон в формате ГГГГ-ММ-ДД

Возвращаемое значение

integer|array
1, 2, 3 или 4 квартал года или массив, если $range равен true

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::toQuarter

toRSS()source public static

toRSS( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )

Форматирует дату для RSS-лент.

Параметры

integer|string|DateTime $dateString

Метка времени UNIX, строка, подходящая для strtotime(), или объект DateTime

string|DateTimeZone $timezone optional null

Строка часового пояса или объект DateTimeZone

Возвращаемое значение

string
Отформатированная строка даты

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::toRSS

toServer()source public static

toServer( integer|string|DateTime $dateString , string|DateTimeZone $timezone null , string $format 'Y-m-d H:i:s' )

Возвращает отформатированную дату в часовом поясе сервера.

Если задан объект DateTime или в строке даты есть часовой пояс, параметр часового пояса будет проигнорирован.

Если параметр часового пояса не задан и не задан объект DateTime, то переданная $dateString будет считаться в часовом поясе UTC.

Параметры

integer|string|DateTime $dateString

Метка времени UNIX, строка, подходящая для strtotime(), или объект DateTime

string|DateTimeZone $timezone optional null

Строка часового пояса или объект DateTimeZone

string $format optional 'Y-m-d H:i:s'

Строка формата даты

Возвращаемое значение

mixed
Отформатированная дата

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::toServer

toUnix()source public static

toUnix( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )

Возвращает метку времени UNIX из текстового описания даты и времени. Обёртка для PHP функции strtotime().

Параметры

integer|string|DateTime $dateString

Метка времени UNIX, строка, подходящая для strtotime(), или объект DateTime

string|DateTimeZone $timezone optional null

Строка часового пояса или объект DateTimeZone

Возвращаемое значение

integer
Метка времени UNIX

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::toUnix

wasWithinLast()source public static

wasWithinLast( string|integer $timeInterval , integer|string|DateTime $dateString , string|DateTimeZone $timezone null )

Возвращает true, если указанная дата и время находились в указанном интервале, иначе false.

Параметры

string|integer $timeInterval

Числовое значение со временем. Примеры допустимых типов: 6 часов, 2 дня, 1 минута.

integer|string|DateTime $dateString

Маркер времени Unix, строка, допустимая для strtotime(), или объект DateTime

string|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращаемое значение

boolean

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::wasWithinLast

wasYesterday()source public static

wasYesterday( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )

Возвращает true, если заданная строка даты и времени была вчера.

Параметры

integer|string|DateTime $dateString

Маркер времени Unix, строка, допустимая для strtotime(), или объект DateTime

string|DateTimeZone $timezone необязательно null

Строка часового пояса или объект DateTimeZone

Возвращаемое значение

boolean
True, если строка даты и времени была вчера

Ссылка

http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#TimeHelper::wasYesterday

null

'%a, %b %eS %Y, %H:%M'

'%B %d, %H:%M'

array(
    'year' => 'day',
    'month' => 'day',
    'week' => 'day',
    'day' => 'hour',
    'hour' => 'minute',
    'minute' => 'minute',
    'second' => 'second',
)

'+1 month'

'j/n/y'