Функции

Функции-заменители служат для упрощения работы с данными.

Функции-заменители созданы для упрощения работы с данными. Каждый параметр функции может содержать в себе заменители.

Если в ходе выполнения функции произойдет ошибка, то она вернет свой паттерн с названием ошибки.

CHOOSE

Выбирает один случайный параметр из указанных.

Параметры

Параметр	Тип	По умолчанию	Описание
...args	строковый[] числовой[]	[]	Значения, которые будут выбраны случайным образом

Примеры

{- CHOOSE(1; 2; 3; 4; 5; 6; 7; 8; 9) -}

// Использование заменителей

{- CHOOSE(Привет { member }!; Приветствую { member }!) -}

DATE

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

Параметры

Параметр	Тип	По умолчанию	Описание
date?	строковый числовой	Date.now()	Значение предоставляющее дату
format?	строковый	DD MMM YYYY HH:mm	Формат даты
utc_offset?	строковый	+00:00	Всемирное координированное время или часовой пояс
locale?	строковый	ru	Язык возвращаемой даты: ru или en

Примеры

{- DATE(1530764942197; DD MMM YYYY [в] HH:mm; +06:00; ru) -} // 05 июля 2018 в 10:29

// Использование заменителей

{- DATE({ guild.created_at }; DD.MM.YYYY; +03:00; en) -}

DATENOW

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

Примеры

{- DATENOW() -}

FIXNUM

Обрезает количество чисел после десятичной запятой.

Параметры

Параметр	Тип	По умолчанию	Описание
number	числовой	0	Число, которое нужно обрезать
fraction_digits	числовой	0	Количество чисел после десятичной запятой

Примеры

{- FIXNUM(1.3232; 1) -}

LOWER

Преобразовывает и возвращает значение строки в нижнем регистре.

Параметры

Параметр	Тип	По умолчанию	Описание
str	строковый	none	Строка, которая будет преобразована в нижний регистр

Примеры

{- LOWER(Hello World) -} // hello world

// Использование заменителей

{- LOWER({ guild }) -}

MATH

Возвращает результат математического выражения.

Параметры

Параметр	Тип	По умолчанию	Описание
expression	строковый	none	Математическое выражение
fraction_digits?	числовой	0	Количество чисел после десятичной запятой

Примеры

{- MATH(10 * 100 / 20) -} // 50

{- MATH(559 + 334; 2) -} // 893.00

// Использование заменителей

{- MATH({ guild.channels.text } + { guild.channels.voice }) -}

NUMDECL

Выбирает нужное склонение к числительному.

Параметры

Параметр	Тип	По умолчанию	Описание
number	числовой	none	Склоняемое число
titles	строковый[]	none	Форма склонений слова
language?	строковый	'ru'	Язык склонения: ru или en

Примеры

{- NUMDECL(4; байт|байта|байтов) -} // байта

{- NUMDECL({ guild.members }; участник|участника|участников) -}

RANDOM

Возвращает случайное число в указанном диапазоне.

Параметры

Параметр	Тип	По умолчанию	Описание
start?	числовой	0	Начальный диапазон
end?	числовой	100	Конечный диапазон

Примеры

{- RANDOM(1; 1000) -}

REPLACE

Заменяет найденное значение на указанное и возвращает новую строку.

Параметры

Параметр	Тип	По умолчанию	Описание
str	строковый	none	Текст в котором нужно произвести замену
search	строковый	none	Значение поиска
replacement	строковый	none	Значение для замены
flags?	строковый	g	Флаги регулярного выражения

Примеры

{- REPLACE(lacunabot.xyz; xyz; com) -} // lacunabot.com

TRUNCATE

Обрезает строку, если она превышает указанное количество символов.

Параметры

Параметр	Тип	По умолчанию	Описание
str	строковый	none	Строка, которую нужно обрезать
limit	числовой	100	Допустимое количество символов в строке
end	строковый	'...'	Символ(ы), которые будут заменять конец строки, если превышено допустимое количество символов

Примеры

{- TRUNCATE(Hello World; 5; ..) -} // Hello..

// Использование заменителей

{- TRUNCATE({ guild }; 10;  > ) -}

TRIM

Удаляет пробельные символы в строке.

Параметры

Параметр	Тип	По умолчанию	Описание
str	строковый	none	Строка с пробелами

Примеры

{- TRIM(    Hello    World    ) -} // Hello World

// Использование заменителей

{- TRIM({ guild.owner.username }) -}

UPPER

Преобразовывает и возвращает значение строки в верхнем регистре.

Параметры

Параметр	Тип	По умолчанию	Описание
str	строковый	none	Строка, которая будет преобразована в верхний регистр

Примеры

{- UPPER(Hello World) -} // HELLO WORLD

// Использование заменителей

{- UPPER({ guild.owner.username }) -}