Класс 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)

boolean|строка $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.

boolean|строка $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 сгруппирует результаты и добавит аббревиатуру часового пояса в значение отображения. Настройте 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 необязательный null

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

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

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

Возвращает

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

Ссылка

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

serverOffset()source public static

serverOffset( )

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

Возвращает

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

Ссылка

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, например, тип datetime в MySQL.

Параметры:

• format => формат по умолчанию, если относительное время превышает указанный интервал
• 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 необязательный array()

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

Возвращает

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

Ссылка

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 необязательный 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 необязательный null

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

Возвращает

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

Ссылка

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 необязательный false

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

Возвращает

целое число/массив
Квартал 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 необязательный null

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

Возвращает

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

Ссылка

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, предполагается, что переданная строка даты находится в часовом поясе UTC.

Параметры

integer|string|DateTime $dateString

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

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

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

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

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

Возвращает

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

Ссылка

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 необязательный null

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

Возвращает

целое число
Маркер времени 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'