Функции
Логические функции
if( )
if(param1, param2, param3)
или param1 ? param2 : param3
Если выражение param1 истинно (true), то выполняется аргумент param2, если ложно (true) — то param3
Пример
Результат
if(-1 == 1, "-1 равно 1", "-1 не равно 1")
0 не равно 1
not( )
not(param1)
или not param1
Если выражение param1 истинно (true), то результат получается ложь (false)
Пример
Результат
not(-1 == 1)
true
and( )
and(param1, param2)
или param1 and param2
Если оба параметра истинны (true), то возвращает true, иначе возвращает ложь (false)
Пример
Результат
-1 == 1 and 1 == 1
false
or( )
or(param1, param2)
или param1 or param2
Если хотя бы один из параметров истинен (true), то возвращает true, иначе возвращает ложь (false)
Пример
Результат
-1 == 1 or 1 == 1
false
equal( )
param1 == param2
или equal(param1, param2)
Если параметры равны друг другу, то возвращает true, иначе возвращает false
Пример
Результат
-1 == 1
false
unequal( )
param1 != param2
или unequal(param1, param2)
Если параметры не равны друг другу, то возвращает true, иначе возвращает false
Пример
Результат
-1 == 1
false
larger( )
param1 > param2
или larger(param1, param2)
Если param1 больше param2, то возвращает true, иначе возвращает false
Пример
Результат
2 > 1
true
largerEq( )
param1 >= param2
или largerEq(param1, param2)
Если param1 больше или равен param2, то возвращает true, иначе возвращает false
Пример
Результат
2 >= 2.1
false
smaller( )
param1 < param2
или smaller(param1, param2)
Если param1 меньше param2, то возвращает true, иначе возвращает false
Пример
Результат
2 < 1
false
smallerEq( )
param1 <= param2
или smallerEq(param1, param2)
Если param1 меньше или равен param2, то возвращает true, иначе возвращает false
Пример
Результат
2 <= 2.1
true
empty( )
empty(prop("my_property"))
Если свойство "my_property" не содержит значений, то возвращает true, иначе возвращает false
Пример
Результат
empty(prop("Дата")), при этом ячейка свойства Дата пустая
true
Текстовые функции
concat( )
"text1" + ...
или concat("text1",...)
Соединяет текстовые элементы в один текст
Пример
Результат
"Меня " + "зовут " + "Джемс Бонд"
Меня зовут Джеймс Бонд
join( )
join("text1",...)
Объединяет аргументы, начиная со второго, вставляя между ними первый аргумент как разделитель
Пример
Результат
join(", ", "Мама", "папа", "я")
Мама, папа, я
slice( )
slice("text", number1)
slice("text", number1, number2)
Создает подстроку из строки "text", начиная с первого индекса (включительно), и заканчивая вторым (если есть, не включительно)
Пример
Результат
slice("Джеймс Бонд, агент 007", 7, 11)
Бонд
length( )
length("text")
Показывает количество символов в строке
Пример
Результат
length("Джеймс Бонд, агент 007")
22
format( )
format(значение)
Превращает значение в текстовую строку
Примеры
format(18) == "18"
format(true) == "true"
format(now()) == "10 Apr, 2021 10:48 AM"
toNumber( )
toNumber(значение)
Превращает значение (обычно текст) в число
Примеры
toNumber("43") == 43
toNumber(true) == "true"
contains( )
contains("text1", "text2")
Проверяет содержание одного текста в другом. Возвращает true, если "text2" является частью "text1"
Примеры
contains("В джазе только девушки", "джаз") == true
contains("В джазе только девушки", "блюз") == false
replace( )
replace(выражение, "text1", "text2")
Заменяет первое вхождение "text1" в выражении на "text2"
Пример
Результат
replace("В джазе играют джазмены", "джа", "блю")
"В блюзе играют джазмены"
replaceAll( )
replaceAll(выражение, "text1", "text2")
Заменяет все вхождения "text1" в выражении на "text2"
Пример
Результат
replaceAll("В джазе играют джазмены", "джа", "блю")
"В блюзе играют блюзмены"
test( )
test(выражение, "text")
Проверяет, если "text" входит в выражение (может быть строкой, числом или логическим значением)
Примеры
test(43, "3") == true
test(43, "5") == false
Числовые функции
abs( )
abs(number)
Модуль числа
Примеры
abs(17) == 17
abs(-17) == 17
cbrt( )
cbrt(number)
Кубический корень из числа
Примеры
cbrt(125) == 5
cbrt(-27) == -3
ceil( )
ceil(number)
Наименьшее целое число, которое больше либо равно аргумента
Примеры
ceil(3.7) == 4
ceil(-5.2) == -5
exp( )
exp(number)
Возводит число e в заданную степень
Примеры
exp(1) == 2.718281828459
exp(2) == 7.389056098931
floor( )
floor(number)
Наибольшее целое число, которое меньше или равно аргумента
Примеры
floor(3.9) == 3
ceil(-5.4) == -6
ln( )
ln(number)
Натуральный логарифм числа
Примеры
ln(5) == 1.609437912434
ln(1) == 0
max( )
max(number,...)
Максимальный из аргументов
Примеры
max(2.3, e, 5) == 5
max(-1, -3) == -1
min( )
min(number,...)
Минимальный из аргументов
Примеры
min(2.3, e, 5) == 2.3
min(-1, -3) == -3
round( )
round(number)
Округляет число до ближайшего целого
Примеры
round(4.2) == 4
round(-1.73) == -2
round(2.5) == 3
sign( )
sign(number)
Показывает, является ли число положительным, отрицательным или нулем
Примеры
sign(3) == 1
sign(-2.6) == -1
sign(0) == 0
sqrt( )
sqrt(number)
Возвращает положительный квадратный корень числа
Примеры
sqrt(16) == 4
sqrt(8) == 2.828427124746
Функции дат и времени
start( )
start(date)
Возвращает первую дату в интервале date. Если date — не интервал, а единичная дата, то возвращается её значение
Примеры
start(prop("Дата")) == Apr 12, 2021,
если в поле "Дата" стояло Apr 12, 2021 → May 5, 2021
start(prop("Дата")) == May 3, 2021,
если в поле "Дата" стояло May 3, 2021
end( )
end(date)
Возвращает последнюю дату в интервале date. Если date — не интервал, а единичная дата, то возвращается её значение
Примеры
end(prop("Дата")) == Apr 12, 2021,
если в поле "Дата" стояло Apr 12, 2021 → May 5, 2021
end(prop("Дата")) == May 3, 2021,
если в поле "Дата" стояло May 3, 2021
now( )
now()
Возвращает текущую дату
Пример
now() == Apr 12, 2021 10:00 AM
timestamp( )
timestamp(date)
Для даты возвращает её целую Юникс-отметку времени. Она равна количеству миллисекунд, прошедших с 1 января 1970 г. по точное время даты
Пример
timestamp(prop("Дата")) == 1619506800000,
если в поле "Дата" стояло Apr 27, 2021 10:00
fromTimestamp( )
fromTimestamp(date)
Восстанавливает дату по её Юникс-отметке времени — количеству миллисекунд, прошедших с 1 января 1970 г. по точное время даты
Пример
fromTimestamp(1619506800000) == Apr 27, 2021 10:00
dateBetween( )
dateBetween(date1, date2, param)
Вычисляет промежуток времени между двумя датами, в величинах, выраженных текстовым параметром param:
“years” — в годах, “quarters” — кварталах, “months” — месяцах, “weeks” — неделях, “days” — днях, “hours” — часах, “minutes” — минутах, “seconds” — секундах, or “milliseconds” — миллисекундах.
Если первая дата более ранняя, то результат будет отрицательным
Примеры
dateBetween(prop("Дата1"), prop("Дата2"), "months") == 3
dateBetween(prop("Дата1"), prop("Дата2"), "days") == 62
formatDate( )
formatDate(date, text)
Представляет дату date в заданном виде с помощью правила text
Примеры
formatDate(prop("Дата"), "DD.MM.YYYY") == "12.04.2021"
formatDate(prop("Дата"), "Сегодня DDD-й день YY-го года") == "Сегодня 92-й день 21-го года"
Правила форматирования дат и времени
Чтобы отображать дату и/или время в нужном вам виде, используйте функцию formatDate(). В качестве правила используйте текстовый формат, подставляя форматы дат и времени из таблицы ниже (данные взяты на notion.vip)
Категория
Параметр
Результат
Год
YYYYYY
21
2021
Квартал
QQo
1..4
1st, 2nd, 3rd, 4th
Месяц
MMoMMMMMMMMM
1...12
1st...12th
01...12
Jun
February
Неделя года
wwoww
1..53
1st...53rd
01...53
День года
DDDDDDoDDDD
1..365
1st...365th
001...365
День месяца
DDoDD
1..31
1st...31st
01...31
День недели
dddddddddd
0...6
Mo
Mon
Monday
Час по 24-часовой системе
HHH
1..24
01...24
Час по 12-часовой системе
hhh
1..12
01...12
Минута
mmm
0..59
00...59
Секунда
sss
0..59
00...59
AM/PM
Aa
AM или PM
am или pm
Часовой пояс
ZZZ
=+06:00
=+0600
Часовой пояс
ZZZ
=+06:00
=+0600