Класс TimeHelper
Класс Time Helper для удобного использования данных времени.
Обработка данных времени.
- Объект
-
Помощник -
AppHelper -
TimeHelper
Ссылка: http://book.cakephp.org/2.0/en/core-libraries/helpers/time.html
См.:
CakeTimeАвторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/View/Helper/TimeHelper.php
Краткое описание свойств
- Экземпляр CakeTime
$_engineprotected
Унаследованные свойства
-
_View,_association,_attributeFormat,_cleaned,_entityPath,_fieldSuffixes,_helperMap,_minimizedAttributeFormat,_minimizedAttributes,_modelScope,_tainted,fieldset,helpers,plugin,request,settings,tags,theme
Краткое описание методов
- __call() publicВызов методов из класса утилиты CakeTime
- __construct() publicКонструктор
- __get() publicМагический доступ к атрибутам, которые были устаревши.
- __isset() publicМагическая проверка isset для устаревших атрибутов.
- __set() publicМагический доступ к устаревшим атрибутам.
- convert() publicПреобразует заданное время (в часовом поясе сервера) в местное время пользователя, учитывая его часовой пояс.
- convertSpecifiers() public
Преобразует строку, представляющую формат для функции strftime, и возвращает безопасный для Windows и учитывающий локаль формат.
- dayAsSql() public
Возвращает частичную строку SQL для поиска всех записей между двумя временами, которые происходят в один и тот же день.
- daysAsSql() publicВозвращает частичную строку SQL для поиска всех записей между двумя датами.
- format() public
Возвращает отформатированную строку даты, используя либо метку времени UNIX, либо корректную строку даты для strtotime(). Данная функция также принимает строку времени и строку формата в качестве первого и второго параметров. В этом случае эта функция работает как обёртка для TimeHelper::i18nFormat()
- fromString() publicВозвращает метку времени UNIX, используя либо метку времени UNIX, либо корректную строку даты для strtotime().
- gmt() publicВозвращает GMT в виде метки времени UNIX.
- i18nFormat() public
Возвращает отформатированную строку даты, используя либо метку времени UNIX, либо корректную строку даты для strtotime(). Функция учитывает стандартный формат даты для текущего языка, если используется файл LC_TIME.
- isThisMonth() publicВозвращает true, если заданная строка datetime находится в текущем месяце
- isThisWeek() publicВозвращает true, если заданная строка datetime находится в текущей неделе.
- isThisYear() publicВозвращает true, если заданная строка datetime находится в текущем году.
- isToday() publicВозвращает true, если заданная строка datetime сегодня.
- isTomorrow() publicВозвращает true, если заданная строка datetime завтра.
- isWithinNext() publicВозвращает true, если заданная дата находится в указанном интервале, иначе false.
- nice() publicВозвращает отформатированную строку даты для заданной строки DateTime.
- niceShort() publicВозвращает отформатированную описательную строку даты для заданной строки datetime.
- serverOffset() publicВозвращает смещение сервера
- timeAgoInWords() publicФорматирует дату в фразу, выражающую относительное время.
- toAtom() publicВозвращает дату, отформатированную для лент Atom RSS.
- toQuarter() publicВозвращает квартал
- toRSS() publicФорматирует дату для лент RSS
- toUnix() publicВозвращает метку времени UNIX из текстового описания даты и времени. Обёртка для PHP функции strtotime().
- wasWithinLast() publicВозвращает true, если заданная дата находилась в указанном интервале, иначе false.
- wasYesterday() publicВозвращает true, если заданная строка datetime была вчера.
Подробное описание методов
__call()source public
__call( string $method , array $params )
Вызов методов из класса утилиты CakeTime
Параметры
- строка
$method - Метод для вызова.
- массив
$params - Параметры для передачи методу.
Возвращает
смешанноеТо, что возвращает вызванный метод, или false при ошибке
Переопределяет
Helper::__call() __construct()source public
__construct( View $View , array $settings array() )
Конструктор
Настройки:
-
engineИмя класса для замены функциональности CakeTime. Класс должен быть размещён в каталогеUtility.
Параметры
-
View$View - объект представления, к которому прикреплён помощник.
- массив
$settingsнеобязательно array() - Массив настроек
Исключения
CakeExceptionКогда класс движка не найден.
Переопределяет
Helper::__construct() __get()source public
__get( string $name )
Магический доступ к атрибутам, которые были устаревши.
Параметры
- строка
$name - Имя атрибута для получения.
Возвращает
смешанноеПереопределяет
Helper::__get() __isset()source public
__isset( string $name )
Магическая проверка isset для устаревших атрибутов.
Параметры
- строка
$name - Имя атрибута для проверки.
Возвращает
булево|null__set()source public
__set( string $name , string $value )
Магический доступ к устаревшим атрибутам.
Параметры
- строка
$name - Имя атрибута для установки.
- строка
$value - Значение атрибута для установки.
Переопределяет
Helper::__set() 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#formattingconvertSpecifiers()source public
convertSpecifiers( string $format , string $time null )
Преобразует строку, представляющую формат для функции strftime, и возвращает формат, совместимый с Windows и учитывающий локализацию.
Параметры
- строка
$format Формат со спецификаторами для функции strftime. Принимает специальный спецификатор %S, который имитирует модификатор S для функции date()
- строка
$timeнеобязательно null - Маркер времени Unix
Возвращает
строкаФормат, совместимый с Windows и функцией date(), для функции strftime
См. также
CakeTime::convertSpecifiers()Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#formattingdayAsSql()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#formattingdaysAsSql()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#formattingformat()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#formattingfromString()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#formattinggmt()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#formattingi18nFormat()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#formattingisThisMonth()source public
isThisMonth( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )
Возвращает true, если заданная строка datetime находится в текущем месяце
Параметры
- целое число|строка|DateTime
$dateString - Маркер времени Unix, строка, допустимая для strtotime(), или объект DateTime
- строка|DateTimeZone
$timezoneнеобязательно null - Строка часового пояса пользователя или объект DateTimeZone
Возвращает
булевоTrue, если строка datetime находится в текущем месяце
См. также
CakeTime::isThisMonth()Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#testing-timeisThisWeek()source public
isThisWeek( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )
Возвращает true, если заданная строка datetime находится в текущей неделе.
Параметры
- целое число|строка|DateTime
$dateString - Маркер времени Unix, строка, допустимая для strtotime(), или объект DateTime
- строка|DateTimeZone
$timezoneнеобязательно null - Строка часового пояса пользователя или объект DateTimeZone
Возвращает
булевоTrue, если строка datetime находится в текущей неделе
См. также
CakeTime::isThisWeek()Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#testing-timeisThisYear()source public
isThisYear( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )
Возвращает true, если заданная строка даты и времени находится в текущем году.
Параметры
- integer|string|DateTime
$dateString - Маркер времени Unix, строка, допустимая для strtotime(), или объект DateTime
- string|DateTimeZone
$timezoneнеобязательный null - Строка часового пояса пользователя или объект DateTimeZone
Возвращает
booleanTrue, если строка даты и времени находится в текущем году
См. также
CakeTime::isThisYear()Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#testing-timeisToday()source public
isToday( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )
Возвращает true, если заданная строка даты и времени относится к сегодняшнему дню.
Параметры
- integer|string|DateTime
$dateString - Маркер времени Unix, строка, допустимая для strtotime(), или объект DateTime
- string|DateTimeZone
$timezoneнеобязательный null - Строка часового пояса пользователя или объект DateTimeZone
Возвращает
booleanTrue, если строка даты и времени относится к сегодняшнему дню
См. также
CakeTime::isToday()Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#testing-timeisTomorrow()source public
isTomorrow( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )
Возвращает true, если заданная строка даты и времени относится к завтрашнему дню.
Параметры
- integer|string|DateTime
$dateString - Маркер времени Unix, строка, допустимая для strtotime(), или объект DateTime
- string|DateTimeZone
$timezoneнеобязательный null - Строка часового пояса пользователя или объект DateTimeZone
Возвращает
booleanTrue, если строка даты и времени относится к вчерашнему дню
См. также
CakeTime::isTomorrow()Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#testing-timeisWithinNext()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-timenice()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#formattingniceShort()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#formattingserverOffset()source public
serverOffset( )
Возвращает смещение сервера
Возвращает
integerСмещение
См. также
CakeTime::serverOffset()Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#formattingtimeAgoInWords()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#formattingtoAtom()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#formattingtoQuarter()source public
toQuarter( integer|string|DateTime $dateString , boolean $range false )
Возвращает квартал
Параметры
- integer|string|DateTime
$dateString - Маркер времени Unix, строка, допустимая для strtotime(), или объект DateTime
- boolean
$rangeнеобязательный false - Если true, возвращает диапазон в формате Y-m-d
Возвращает
integer|array1, 2, 3 или 4 квартал года или массив, если $range true
См. также
CakeTime::toQuarter()Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#formattingtoRSS()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#formattingtoUnix()source public
toUnix( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )
Возвращает метку времени Unix по текстовому описанию даты и времени. Обёртка для функции PHP strtotime().
Параметры
- целое число|строка|DateTime
$dateString - Метка времени Unix, допустимая строка для strtotime() или объект DateTime
- строка|DateTimeZone
$timezoneнеобязательно null - Строка часового пояса пользователя или объект DateTimeZone
Возвращает
целое числоМетка времени Unix
См. также
CakeTime::toUnix()Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#formattingwasWithinLast()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
Возвращает
булевоСм. также
CakeTime::wasWithinLast()Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#testing-timewasYesterday()source public
wasYesterday( integer|string|DateTime $dateString , string|DateTimeZone $timezone null )
Возвращает true, если заданная строка даты и времени была вчера.
Параметры
- целое число|строка|DateTime
$dateString - Метка времени Unix, допустимая строка для strtotime() или объект DateTime
- строка|DateTimeZone
$timezoneнеобязательно null - Строка часового пояса пользователя или объект DateTimeZone
Возвращает
булевоTrue, если строка даты и времени была вчера
См. также
CakeTime::wasYesterday()Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/time.html#testing-timeМетоды, унаследованные от Helper
_confirm()source protected
_confirm( string $message , string $okCode , string $cancelCode '' , array $options array() )
Возвращает строку, используемую в качестве обработчика onclick для диалогов подтверждения.
Параметры
- строка
$message - Сообщение, отображаемое в диалоге
- строка
$okCode - Код, выполняемый после того, как пользователь выбрал 'ОК'
- строка
$cancelCodeнеобязательно '' - Код, выполняемый после того, как пользователь выбрал 'Отмена', также выполняется, когда okCode не возвращает значение
- массив
$optionsнеобязательно array() - Массив параметров
Возвращает
строкаJS-код onclick
_encodeUrl()source protected
_encodeUrl( string $url )
Кодирует URL для использования в атрибутах HTML.
Параметры
- строка
$url - URL для кодирования.
Возвращает
строкаURL, закодированный для контекстов URL и HTML.
_formatAttribute()source protected
_formatAttribute( string $key , string $value , boolean $escape true )
Форматирует отдельный атрибут и возвращает строковое значение составленного атрибута. Работает с минимализированными атрибутами, значение которых совпадает с их именем, например, 'disabled' и 'checked'
Устарело
3.0.0 Этот метод будет перемещён в HtmlHelper в версии 3.0Параметры
- строка
$key - Имя атрибута для создания
- строка
$value - Значение атрибута для создания.
- булево
$escapeнеобязательно true - Указывает, необходимо ли экранировать значение
Возвращает
строкаСоставленный атрибут.
_initInputField()source protected
_initInputField( string $field , array $options array() )
Устанавливает значения по умолчанию для тега input. Установит атрибуты name, value и id для массива атрибутов HTML.
Параметры
- строка
$field - Имя поля для инициализации.
- массив
$optionsнеобязательно array() - Массив параметров, используемых при инициализации поля ввода.
Возвращает
массивМассив параметров для поля формы.
_name()source protected
_name( array|string $options array() , string $field null , string $key 'name' )
Возвращает имя поля ввода для текущего тега. Создает атрибуты имени input с использованием формата CakePHP data[Model][field].
Параметры
- массив|строка
$optionsнеобязательно array() Если массив, должен быть массивом атрибутов, к которым нужно добавить $key. Если строка или null, будет использоваться сущность View.
- строка
$fieldнеобязательно null - Имя поля.
- строка
$keyнеобязательно 'name' - Имя атрибута для установки, по умолчанию 'name'
Возвращает
смешанноеЕсли для $options был передан массив, будет возвращён массив с установленным $key. Если была передана строка, будет возвращена строка.
_parseAttributes()source protected
_parseAttributes( array $options , array $exclude null , string $insertBefore ' ' , string $insertAfter null )
Возвращает строку, разделённую пробелами, со значениями массива $options. Если ключ в массиве $options совпадает с одним из перечисленных в Helper::$_minimizedAttributes,
и его значение равно:
- '1' (строка)
- 1 (целое число)
- true (булево)
- 'true' (строка)
то значение будет изменено на имя ключа. Если значение не соответствует одному из этих 3, параметр не выводится.
'escape' — специальный параметр, контролирующий преобразование атрибутов в их закодированные html-сущности. Установите в значение false, чтобы отключить html-кодирование.
Если значение любого ключа параметра установлено в null или false, этот параметр будет исключён из вывода.
Устарело
3.0.0 Этот метод будет перемещён в HtmlHelper в версии 3.0Параметры
- массив
$options - Массив параметров.
- массив
$excludeнеобязательно null - Массив параметров для исключения, параметры из этого массива не будут частью возвращаемого значения.
- строка
$insertBeforeнеобязательно ' ' - Строка, вставляемая перед параметрами.
- строка
$insertAfterнеобязательно null - Строка, вставляемая после параметров.
Возвращает
строкаСоставленные атрибуты.
_selectedArray()source protected
_selectedArray( string|array $data , string $key 'id' )
Преобразует набор записей из ассоциации hasAndBelongsToMany в список выбранных параметров для элемента множественного выбора.
Параметры
- строка|массив
$data - Массив данных или имя модели.
- строка
$keyнеобязательно 'id' - Имя поля.
Возвращает
массивaddClass()source public
addClass( array $options array() , string $class null , string $key 'class' )
Добавляет заданный класс к опциям элемента.
Параметры
- массив
$optionsнеобязательно array() - Массив опций/атрибутов для добавления класса.
- строка
$classнеобязательно null - Имя добавляемого класса.
- строка
$keyнеобязательно 'class' - Ключ для использования в качестве класса.
Возвращает
массивМассив опций с установленным ключом.
afterLayout()source public
afterLayout( string $layoutFile )
Обработчик после макета. afterLayout вызывается после рендеринга макета.
Переопределяется в подклассах.
Параметры
- строка
$layoutFile - Файл макета, который был рендерен.
afterRender()source public
afterRender( string $viewFile )
Обработчик после рендеринга. afterRender вызывается после рендеринга файла представления, но перед рендерингом макета.
Переопределяется в подклассах.
Параметры
- строка
$viewFile - Файл представления, который был рендерен.
afterRenderFile()source public
afterRenderFile( string $viewFile , string $content )
Обработчик после рендеринга файла. Вызывается после рендеринга любого фрагмента представления.
Переопределяется в подклассах.
Параметры
- строка
$viewFile - Файл, который только что был рендерен.
- строка
$content - Содержимое, которое было рендерене.
assetTimestamp()source public
assetTimestamp( string $path )
Добавляет отметку времени к ресурсу файла, основанному на значении Asset.timestamp в Configure. Если Asset.timestamp истинно и debug > 0, или Asset.timestamp === 'force', будет добавлена отметка времени.
Параметры
- строка
$path - Путь к файлу для добавления отметки времени, путь должен находиться внутри WWW_ROOT
Возвращает
строкаПуть с добавленной отметкой времени или без неё.
assetUrl()source public
assetUrl( string|array $path , array $options array() )
Генерирует URL для заданного файла актива. В зависимости от переданных опций предоставляет полный URL с именем домена. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам.
Параметры
- строка|массив
$path - Строка пути или массив URL
- массив
$optionsнеобязательно array() Массив опций. Возможные ключи:
fullBaseВозвращает полный URL с именем доменаpathPrefixПрефикс пути для относительных URLextРасширение актива для добавленияpluginЗначение False предотвратит обработку пути как плагина
Возвращает
строкаСгенерированный URL
beforeLayout()source public
beforeLayout( string $layoutFile )
Обработчик перед макетом. beforeLayout вызывается перед рендерингом макета.
Переопределяется в подклассах.
Параметры
- строка
$layoutFile - Макет, который собирается быть рендериным.
beforeRender()source public
beforeRender( string $viewFile )
Обработчик перед рендерингом. beforeRender вызывается перед рендерингом файла представления.
Переопределяется в подклассах.
Параметры
- строка
$viewFile - Файл представления, который будет рендериться
beforeRenderFile()source public
beforeRenderFile( string $viewFile )
Обработчик перед рендерингом файла. Вызывается перед рендерингом любого фрагмента представления.
Переопределяется в подклассах.
Параметры
- строка
$viewFile - Файл, который собирается быть рендериным.
clean()source public
clean( string|array $output )
Используется для удаления вредных тегов из содержимого. Удаляет ряд известных атак XSS из содержимого. Однако не гарантирует удаление всех возможностей. Экранирование содержимого является лучшим способом предотвращения всех возможных атак.
Устаревший
3.0.0 Этот метод будет удален в версии 3.0Параметры
- строка|массив
$output - Либо массив строк для очистки, либо одиночная строка для очистки.
Возвращает
строка|массив|nullОчищенное содержимое для вывода
domId()source public
domId( array|string $options null , string $id 'id' )
Генерирует идентификатор DOM для выбранного элемента, если он не задан. Использует текущие настройки View::entity() для генерации атрибута id в формате CamelCase.
Параметры
- массив|строка
$optionsнеобязательно null Либо массив html атрибутов, в который добавить $id, либо строка с путем к сущности представления для получения domId.
- строка
$idнеобязательно 'id' - Имя атрибута 'id'.
Возвращает
смешанноеЕсли $options был массивом, будет возвращен массив с установленным $id. Если была передана строка, будет возвращена строка.
entity()source public
entity( )
Возвращает ссылку на сущность текущего контекста в виде массива частей идентификатора.
Возвращает
массивМассив, содержащий элементы идентификации сущности
field()source public
field( )
Получает текущее поле модели контекста рендеринга. Удаляет суффиксы полей, такие как год, месяц, день, час, мин, меридиан, когда текущая сущность содержит более 2 элементов.
Возвращает
строкаoutput()source public
output( string $str )
Возвращает строку, сгенерированную методом помощника
Этот метод можно переопределить в подклассах для обобщенной обработки вывода после обработки.
Устаревший
3.0.0 Этот метод будет удален в будущих версиях.Параметры
- строка
$str - Строка для вывода.
Возвращает
строкаsetEntity()source public
setEntity( string $entity , boolean $setScope false )
Устанавливает свойства модели и поля помощника на пару значений, разделенных точкой в $entity.
Параметры
- строка
$entity - Имя поля, например "ModelName.fieldName" или "ModelName.ID.fieldName"
- логическое
$setScopeнеобязательно false - Устанавливает область представления для модели, указанной в $tagValue
url()source public
url( string|array $url null , boolean $full false )
Находит URL для указанного действия.
Возвращает URL, указывающий на предоставленные параметры.
Параметры
- строка|массив
$urlнеобязательно null Либо относительный строковый URL, например
/products/view/23, либо массив параметров URL. Использование массива для URL позволит вам использовать возможности обратного маршрутизирования CakePHP.- логическое
$fullнеобязательно false - Если true, полный базовый URL будет добавлен к результату
Возвращает
строкаПолный переведенный URL с базовым путём.
Ссылка
http://book.cakephp.org/2.0/ru/views/helpers.htmlvalue()source public
value( array|string $options array() , string $field null , string $key 'value' )
Получение данных для текущего тега
Параметры
- массив|строка
$optionsнеобязательно массив() Если массив, должен содержать массив атрибутов, к которым нужно добавить $key. Если строка или null, будет использоваться как сущность View.
- строка
$fieldнеобязательно null - Имя поля.
- строка
$keyнеобязательно 'value' - Имя атрибута, который нужно установить, по умолчанию 'value'
Возвращает
смешанный типЕсли для $options был передан массив, будет возвращен массив с заданным $key. Если была передана строка, будет возвращена строка.
webroot()source public
webroot( string $file )
Проверяет наличие файла при использовании темы, если файл не найден, возвращается путь по умолчанию
Параметры
- строка
$file - Файл, для которого нужно создать путь webroot.
Возвращает
строкаПуть к файлу, доступный через веб.
Методы, унаследованные от Object
_mergeVars()source protected
_mergeVars( array $properties , string $class , boolean $normalize true )
Объединяет свойство $property данного объекта со свойством в определении $class. Значение свойства этого класса будет объединено поверх значения свойства $class.
Это обеспечивает некоторую из DRY-магии CakePHP. Если вы хотите это отключить, переопределите этот метод как пустую функцию.
Параметры
- массив
$properties - Имя свойств для объединения.
- строка
$class - Класс для объединения свойства с.
- логическое значение
$normalizeнеобязательно true - Установите в значение true, чтобы выполнить свойства через Hash::normalize() перед объединением.
_set()source protected
_set( array $properties array() )
Позволяет установить несколько свойств объекта в одной строке кода. Будут установлены только те свойства, которые являются частью объявления класса.
Параметры
- массив
$propertiesнеобязательно массив() - Ассоциативный массив, содержащий свойства и соответствующие значения.
_stop()source protected
_stop( integer|string $status 0 )
Останов выполнения текущего скрипта. Оборачивает exit(), что упрощает тестирование.
Параметры
- целое число|строка
$statusнеобязательно 0 - см. http://php.net/exit для значений
dispatchMethod()source public
dispatchMethod( string $method , array $params array() )
Вызывает метод этого объекта с заданными параметрами. Предоставляет ОО-обёртку для call_user_func_array
Параметры
- строка
$method - Имя вызываемого метода
- массив
$paramsнеобязательно массив() - Список параметров для использования при вызове $method
Возвращает
смешанный типВозвращает результат вызова метода
log()source public
log( string $msg , integer $type LOG_ERR , null|string|array $scope null )
Удобный метод для записи сообщения в CakeLog. Для получения дополнительной информации о записи в лог, обратитесь к CakeLog::write().
Параметры
- строка
$msg - Сообщение лога
- целое число
$typeнеобязательно LOG_ERR - Константа типа ошибки. Определена в app/Config/core.php.
- null|строка|массив
$scopeнеобязательно null Область(и), в которой создаётся сообщение лога. Для получения дополнительной информации о областях логирования, обратитесь к CakeLog::config().
Возвращает
логическое значениеУспех записи в лог
requestAction()source public
requestAction( string|array $url , array $extra array() )
Вызывает метод контроллера из любого места. Может использоваться для соединения контроллеров или подключения плагинов к основному приложению. requestAction может использоваться для возврата отрисованных представлений или получения возвращаемого значения действий контроллера.
Внутри этого метода используется Router::reverse() для преобразования параметра $url в строковый URL. Вы должны использовать форматы URL, совместимые с Router::reverse().
Передача данных POST и GET
Данные POST и GET могут быть смоделированы в requestAction. Используйте $extra['url'] для данных GET. Параметр $extra['data'] позволяет моделировать данные POST.
Параметры
- строка|массив
$url Строка или массив URL. В отличие от других массивов URL в CakePHP, этот URL не будет автоматически обрабатывать переданные и именованные аргументы в параметре $url.
- массив
$extraнеобязательно массив() Если массив включает ключ "return", он устанавливает AutoRender в значение true. Также может использоваться для отправки данных GET/POST и именованных/переданных аргументов.
Возвращает
смешанный типЛогическое значение true или false об успехе/неуспехе или содержимое отрисованного действия, если в $extra установлен ключ 'return'.
toString()source public
toString( )
Преобразование объекта в строку. Каждый класс может переопределить этот метод по необходимости.
Возвращает
строкаНазвание этого класса
Подробное описание свойств
© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
http://api.cakephp.org/2.8/class-TimeHelper.html