Класс 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 и поддерживающий многоязычие спецификатор.

Параметры

массив $specifier

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

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

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

convert()source public static

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

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

Параметры

строка $serverTime

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

строка|DateTimeZone $timezone

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

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

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

Ссылка

https://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 и поддерживающий многоязычие.

Параметры

строка $format

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

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

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

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

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

Ссылка

https://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.

Ссылка

https://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.

Ссылка

https://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)

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

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

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

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

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

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

Ссылка

https://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

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

строка
Обработанный маркер времени

Ссылка

https://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

Ссылка

https://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.

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

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

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

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

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

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

Ссылка

https://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, если строка даты и времени находится в будущем

Ссылка

https://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, если строка даты и времени находится в прошлом

Ссылка

https://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, если строка даты и времени находится в текущем месяце

Ссылка

https://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, если строка даты и времени находится в текущей неделе

Ссылка

https://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, если строка даты и времени находится в текущем году

Ссылка

https://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, если строка даты и времени является текущим днем

Ссылка

https://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, если строка даты и времени была вчера

Ссылка

https://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

Ссылка

https://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
Отформатированная строка даты

Ссылка

https://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». Если дата — в ближайшие или в прошлые 7 дней, возвращаемая строка может быть «В четверг, 16:54». Если год в $dateString — текущий год, в возвращаемой строке не упоминается год.

Параметры

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

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

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

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

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

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

Ссылка

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

serverOffset()source public static

serverOffset( )

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

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

целое число
Смещение

Ссылка

https://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, например, тип данных datetime MySQL.

Параметры:

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

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

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

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

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

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

Параметры

integer|string|DateTime $dateTime

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

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

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

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

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

Ссылка

https://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 необязательно null

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

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

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

Ссылка

https://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 необязательно null

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

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

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

Ссылка

https://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 необязательно false

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

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

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

Ссылка

https://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 необязательно null

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

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

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

Ссылка

https://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 необязательно null

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

string $format необязательно 'Y-m-d H:i:s'

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

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

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

Ссылка

https://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 необязательно null

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

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

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

Ссылка

https://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.

Параметры

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

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

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

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

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

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

Возвращает

boolean

Ссылка

https://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, если заданная строка даты и времени была вчера.

Параметры

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

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

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

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

Возвращает

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

Ссылка

https://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'