Класс FunctionsBuilder
Содержит методы, связанные с генерацией объектов FunctionExpression с использованием наиболее часто используемых функций SQL. Выступает в качестве фабрики для объектов FunctionExpression.
Краткое описание методов
- __call() publicДиспечер магических методов для создания пользовательских вызовов функций SQL
- _build() protected
Возвращает новый экземпляр FunctionExpression. Используется для генерации произвольных вызовов функций в окончательной строке SQL.
- _literalArgumentFunction() protected
Вспомогательная функция для построения выражения функции, принимающей только один литеральный аргумент.
- avg() publicВозвращает FunctionExpression, представляющий вызов функции SQL AVG.
- coalesce() publicВозвращает FunctionExpression, представляющий вызов функции SQL COALESCE.
- concat() publicВозвращает FunctionExpression, представляющий конкатенацию строк
- count() publicВозвращает FunctionExpression, представляющий вызов функции SQL COUNT.
- dateAdd() publicДобавляет единицу времени к выражению даты
- dateDiff() public
Возвращает FunctionExpression, представляющий разницу в днях между двумя датами.
- datePart() publicВозвращает указанную часть даты из выражения SQL.
- dayOfWeek() public
Возвращает FunctionExpression, представляющий вызов функции SQL WEEKDAY. 1 - Воскресенье, 2 - Понедельник, 3 - Вторник...
- extract() publicВозвращает указанную часть даты из выражения SQL.
- max() publicВозвращает FunctionExpression, представляющий вызов функции SQL MAX.
- min() publicВозвращает FunctionExpression, представляющий вызов функции SQL MIN.
- now() public
Возвращает FunctionExpression, представляющий вызов, который вернёт текущую дату и время. По умолчанию возвращает и дату, и время, но можно также заставить генерировать только дату или только время.
- sum() publicВозвращает FunctionExpression, представляющий вызов функции SQL SUM.
- weekday() public
Возвращает FunctionExpression, представляющий вызов функции SQL WEEKDAY. 1 - Воскресенье, 2 - Понедельник, 3 - Вторник...
Подробное описание методов
__call()source public
__call( string $name , array $args )
Диспечер магических методов для создания пользовательских вызовов функций SQL
Параметры
- string
$name - имя функции SQL для построения
- array
$args список с максимум 3 аргументами, первый из которых - массив с параметрами для функции SQL, второй - список типов для привязки к этим параметрам, а третий - тип возвращаемого значения функции
Возвращает
Cake\Database\Expression\FunctionExpression_build()source protected
_build( string $name , array $params [] , array $types [] , string $return 'string' )
Возвращает новый экземпляр FunctionExpression. Используется для генерации произвольных вызовов функций в окончательной строке SQL.
Параметры
- string
$name - имя функции SQL для построения
- array
$paramsoptional [] - список параметров, передаваемых в функцию
- array
$typesoptional [] - список типов для каждого параметра функции
- string
$returnoptional 'string' - Тип возвращаемого значения выражения функции
Возвращает
Cake\Database\Expression\FunctionExpression_literalArgumentFunction()source protected
_literalArgumentFunction( string $name , mixed $expression , array $types [] , string $return 'string' )
Вспомогательная функция для построения выражения функции, принимающей только один литеральный аргумент.
Параметры
- строка
$name - имя функции для построения
- смешанное
$expression - аргумент функции
- массив
$typesнеобязательно [] - список типов для привязки к аргументам
- строка
$returnнеобязательно 'строка' - Тип возвращаемого значения функции
Возвращает
Cake\Database\Expression\FunctionExpressionavg()source public
avg( mixed $expression , array $types [] )
Возвращает FunctionExpression, представляющую вызов функции SQL AVG.
Параметры
- смешанное
$expression - аргумент функции
- массив
$typesнеобязательно [] - список типов для привязки к аргументам
Возвращает
Cake\Database\Expression\FunctionExpressioncoalesce()source public
coalesce( array $args , array $types [] )
Возвращает FunctionExpression, представляющую вызов функции SQL COALESCE.
Параметры
- массив
$args - Список выражений для оценки в качестве параметров функции
- массив
$typesнеобязательно [] - список типов для привязки к аргументам
Возвращает
Cake\Database\Expression\FunctionExpressionconcat()source public
concat( array $args , array $types [] )
Возвращает FunctionExpression, представляющую конкатенацию строк
Параметры
- массив
$args - Список строк или выражений для конкатенации
- массив
$typesнеобязательно [] - список типов для привязки к аргументам
Возвращает
Cake\Database\Expression\FunctionExpressioncount()source public
count( mixed $expression , array $types [] )
Возвращает FunctionExpression, представляющую вызов функции SQL COUNT.
Параметры
- смешанное
$expression - аргумент функции
- массив
$typesнеобязательно [] - список типов для привязки к аргументам
Возвращает
Cake\Database\Expression\FunctionExpressiondateAdd()source public
dateAdd( string $expression , string $value , string $unit , array $types [] )
Добавляет единицу времени к выражению даты.
Параметры
- строка
$expression - Выражение для получения части даты.
- строка
$value - Значение для добавления. Используйте отрицательное значение для вычитания.
- строка
$unit - Единица значения, например, час или день.
- массив
$typesнеобязательно [] - список типов для привязки к аргументам
Возвращает
Cake\Database\Expression\FunctionExpressiondateDiff()source public
dateDiff( array $args , array $types [] )
Возвращает FunctionExpression, представляющую разницу в днях между двумя датами.
Параметры
- массив
$args - Список выражений для получения разницы в днях.
- массив
$typesнеобязательно [] - список типов для привязки к аргументам
Возвращает
Cake\Database\Expression\FunctionExpressiondatePart()source public
datePart( string $part , string $expression , array $types [] )
Возвращает указанную часть даты из SQL-выражения.
Параметры
- строка
$part - Часть даты для возврата.
- строка
$expression - Выражение для получения части даты.
- массив
$typesнеобязательно [] - Список типов для привязки к аргументам
Возвращает
Cake\Database\Expression\FunctionExpressiondayOfWeek()source public
dayOfWeek( mixed $expression , array $types [] )
Возвращает FunctionExpression, представляющую вызов SQL-функции WEEKDAY. 1 — воскресенье, 2 — понедельник, 3 — вторник и т.д.
Параметры
- смешанный
$expression - аргумент функции
- массив
$typesнеобязательно [] - список типов для привязки к аргументам
Возвращает
Cake\Database\Expression\FunctionExpressionextract()source public
extract( string $part , string $expression , array $types [] )
Возвращает указанную часть даты из SQL-выражения.
Параметры
- строка
$part - Часть даты для возврата.
- строка
$expression - Выражение для получения части даты.
- массив
$typesнеобязательно [] - список типов для привязки к аргументам
Возвращает
Cake\Database\Expression\FunctionExpressionmax()source public
max( mixed $expression , array $types [] )
Возвращает FunctionExpression, представляющую вызов SQL-функции MAX.
Параметры
- смешанный
$expression - аргумент функции
- массив
$typesнеобязательно [] - список типов для привязки к аргументам
Возвращает
Cake\Database\Expression\FunctionExpressionmin()source public
min( mixed $expression , array $types [] )
Возвращает FunctionExpression, представляющую вызов SQL-функции MIN.
Параметры
- смешанный
$expression - аргумент функции
- массив
$typesнеобязательно [] - список типов для привязки к аргументам
Возвращает
Cake\Database\Expression\FunctionExpressionnow()source public
now( string $type 'datetime' )
Возвращает FunctionExpression, представляющую вызов, который вернёт текущую дату и время. По умолчанию возвращает и дату, и время, но можно также настроить на генерацию только даты или только времени.
Параметры
- строка
$typeнеобязательно 'datetime' - (datetime|date|time)
Возвращает
Cake\Database\Expression\FunctionExpressionsum()source public
sum( mixed $expression , array $types [] )
Возвращает FunctionExpression, представляющую вызов SQL-функции SUM.
Параметры
- смешанный
$expression - аргумент функции
- массив
$typesнеобязательно [] - список типов для привязки к аргументам
Возвращает
Cake\Database\Expression\FunctionExpressionweekday()source public
weekday( mixed $expression , array $types [] )
Возвращает FunctionExpression, представляющую вызов SQL-функции WEEKDAY. 1 — воскресенье, 2 — понедельник, 3 — вторник и т.д.
Параметры
- смешанный
$expression - аргумент функции
- массив
$typesнеобязательно [] - список типов для привязки к аргументам
Возвращает
Cake\Database\Expression\FunctionExpression
© 2005–2017 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.
https://api.cakephp.org/3.4/class-Cake.Database.FunctionsBuilder.html