Класс TimeHelper

__call()source public

__call( string $method , array $params )

Вызов методов из утилиты CakeTime

Параметры

строка $method

Вызываемый метод.

массив $params

Параметры для передачи методу.

Возвращает

смешанный
Результат вызова метода, или false при ошибке

__construct()source public

__construct( View $View , array $settings array() )

Конструктор

Настройки:

• engine Имя класса, используемого для замены функциональности CakeTime. Класс должен быть размещен в каталоге Utility.

Параметры

View $View

объект представления, к которому прикреплен помощник.

массив $settings необязательно array()

Массив настроек

Выбрасывает

CakeException
При невозможности найти класс движка.

__get()source public

__get( string $name )

Магический доступ к устаревшим атрибутам.

Параметры

строка $name

Имя атрибута для получения.

Возвращает

смешанный

__isset()source public

__isset( string $name )

Магическая проверка isset для устаревших атрибутов.

Параметры

строка $name

Имя атрибута для проверки.

Возвращает

булево|null

__set()source public

__set( string $name , string $value )

Магический доступ к устаревшим атрибутам.

Параметры

строка $name

Имя атрибута для установки.

строка $value

Значение атрибута для установки.

convert()source public

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

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

Параметры

строка $serverTime

Временная метка UNIX

строка|DateTimeZone $timezone

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

Возвращает

целое число
Временная метка UNIX

См.

CakeTime::convert()

Ссылка

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

convertSpecifiers()source public

convertSpecifiers( string $format , string $time null )

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

Параметры

строка $format

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

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

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

Возвращает

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

См. также

CakeTime::convertSpecifiers()

Ссылка

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

dayAsSql()source public

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

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

Параметры

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

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

строка $fieldName

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

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

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

Возвращает

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

См. также

CakeTime::dayAsSql()

Ссылка

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

daysAsSql()source public

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.

См. также

CakeTime::daysAsSql()

Ссылка

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

format()source public

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

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

Примеры

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

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

Параметры

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

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

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

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

булево $invalid необязательно false

Флаг для игнорирования результатов fromString == false

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

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

Возвращает

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

См. также

CakeTime::format()

Ссылка

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

fromString()source public

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

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

Параметры

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

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

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

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

Возвращает

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

См. также

CakeTime::fromString()

Ссылка

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

gmt()source public

gmt( integer|string|DateTime $string null )

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

Параметры

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

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

Возвращает

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

См. также

CakeTime::gmt()

Ссылка

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

i18nFormat()source public

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

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

Параметры

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

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

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

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

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

Флаг для игнорирования результатов fromString == false

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

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

Возвращает

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

См. также

CakeTime::i18nFormat()

Ссылка

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

isThisMonth()source public

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

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

Параметры

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

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

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

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

Возвращает

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

См. также

CakeTime::isThisMonth()

Ссылка

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

isThisWeek()source public

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

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

Параметры

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

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

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

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

Возвращает

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

См. также

CakeTime::isThisWeek()

Ссылка

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

isThisYear()source public

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

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

Параметры

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

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

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

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

Возвращает

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

См. также

CakeTime::isThisYear()

Ссылка

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

isToday()source public

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

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

Параметры

integer|string|DateTime $dateString

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

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

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

Возвращает

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

См. также

CakeTime::isToday()

Ссылка

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

isTomorrow()source public

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

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

Параметры

integer|string|DateTime $dateString

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

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

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

Возвращает

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

См. также

CakeTime::isTomorrow()

Ссылка

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

isWithinNext()source public

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

См. также

CakeTime::isWithinLast()

Ссылка

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

nice()source public

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

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

Параметры

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

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

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

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

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

Формат для использования. Если null, используется CakeTime::$niceFormat

Возвращает

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

См. также

CakeTime::nice()

Ссылка

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

niceShort()source public

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

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

Параметры

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

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

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

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

Возвращает

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

См. также

CakeTime::niceShort()

Ссылка

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

serverOffset()source public

serverOffset( )

Возвращает смещение сервера

Возвращает

integer
Смещение

См. также

CakeTime::serverOffset()

Ссылка

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

timeAgoInWords()source public

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

Форматирует дату в фразу, выражающую относительное время.

Дополнительные параметры

• element - Элемент для обертывания отформатированного времени. Имеет несколько дополнительных вариантов:
  • tag - Тэг для использования, по умолчанию 'span'.
  • class - Имя класса для использования, по умолчанию time-ago-in-words.
  • title - По умолчанию равен входному значению $dateTime.

Параметры

integer|string|DateTime $dateTime

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

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

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

Возвращает

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

См. также

CakeTime::timeAgoInWords()

Ссылка

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

toAtom()source public

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

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

Параметры

integer|string|DateTime $dateString

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

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

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

Возвращает

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

См. также

CakeTime::toAtom()

Ссылка

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

toQuarter()source public

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

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

Параметры

integer|string|DateTime $dateString

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

boolean $range необязательно false

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

Возвращает

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

См. также

CakeTime::toQuarter()

Ссылка

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

toRSS()source public

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

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

Параметры

integer|string|DateTime $dateString

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

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

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

Возвращает

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

См. также

CakeTime::toRSS()

Ссылка

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

toUnix()source public

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

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

Параметры

integer|string|DateTime $dateString

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

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

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

Возвращает

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

См. также

CakeTime::toUnix()

Ссылка

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

wasWithinLast()source public

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

См. также

CakeTime::wasWithinLast()

Ссылка

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

wasYesterday()source public

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

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

Параметры

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

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

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

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

Возвращает

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

См. также

CakeTime::wasYesterday()

Ссылка

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

null