Құжатталған нұсқаның барлық функциялары: шақыру пішімі, мақсаты және мысалдары.
Формулаларды қалай оқу керек
Мынаны пайдаланыңыз: field("Назва") — баған үшін және param("Назва") — ағымдағы тармақтың алдыңғы блок параметрі үшін. Өрістер көрсетілген ретпен есептеледі; әлі есептелмеген өріске сілтеме қате береді. Сандық мәтінді алдымен сан пішімі блогымен қалыпқа келтіріңіз.
round(number(field("Quantity")) * number(field("Price")), 2)
Формула 2048 таңбамен және өрнек күрделілігінің шегімен шектеледі. Тек рұқсат етілген амалдар мен функциялар қолжетімді; бұл еркін код орындау ортасы емес.
Өрістер
| Функция | Мақсаты | Мысал |
|---|
field(назва) | Ағымдағы жол бағанының мәні. | field("Revenue") |
param(назва) | Тек ағымдағы тармақтың алдыңғы блоктарындағы параметр. | param("Rate") |
Сандар
| Функция | Мақсаты | Мысал |
|---|
number(значення) | Сан пішімі блогынан кейін мәнді санға түрлендіреді. | number("12.5") |
abs(число) | Абсолют мән. | abs(-12) |
round(число,знаків?) | Дәл жарты мәндерді нөлден алшақ дөңгелектейді; дәлдік −15-тен 15-ке дейін. | round(12.345, 2) |
min(числа*) | Берілген сандардың ең кішісі. | min(3, 8, 2) |
max(числа*) | Берілген сандардың ең үлкені. | max(3, 8, 2) |
sum(числа*) | Ағымдағы жол аргументтерінің қосындысы. Жолдар бойынша қосу үшін топтауды қолданыңыз. | sum(10, 20, 30) |
average(числа*) | Аргументтердің арифметикалық ортасы. | average(10, 20) |
ceil(число) | Оң шексіздікке қарай дөңгелектейді. | ceil(-1.2) |
floor(число) | Теріс шексіздікке қарай дөңгелектейді. | floor(-1.2) |
trunc(число,знаків?) | Бөлшек бөлікті дөңгелектемей алып тастайды. | trunc(12.349, 2) |
roundup(число,знаків?) | Нөлден алшақ дөңгелектейді. | roundup(12.341, 2) |
rounddown(число,знаків?) | Нөлге қарай дөңгелектейді. | rounddown(-12.349, 2) |
sqrt(число) | Теріс емес санның квадрат түбірі. | sqrt(144) |
power(основа,степінь) | Негізді дәрежеге шығарады (дәреже −1000-нан 1000-ға дейін). | power(2, 8) |
mod(число,дільник) | Бөлгіш таңбасымен бөлуден қалған қалдық. | mod(-7, 3) |
sign(число) | Теріс сан үшін −1, нөл үшін 0, оң сан үшін 1. | sign(-12) |
log(число,основа?) | Логарифм; әдепкі негізі 10. | log(1000, 10) |
exp(число) | Экспонента: e санының берілген дәрежесі. | exp(1) |
clamp(число,мінімум,максимум) | Санды көрсетілген аралықпен шектейді. | clamp(120, 0, 100) |
percent(число,відсоток) | Санның көрсетілген пайызы. | percent(200, 15) |
pi() | π саны. | pi() |
Мәтін
| Функция | Мақсаты | Мысал |
|---|
text(значення) | Мәнді мәтінге түрлендіреді. | text(125) |
concat(значення*) | Мәтіндік мәндерді біріктіреді. | concat("Plan", "-", 2026) |
upper(текст) | Бас әріптер. | upper("hello") |
lower(текст) | Кіші әріптер. | lower("HELLO") |
title(текст) | Әр сөздің алғашқы әрпін бас әріп етеді. | title("hello world") |
trim(текст) | Басы мен соңындағы бос орындарды жояды. | trim(" hello ") |
length(текст) | Unicode таңбаларының саны. | length("Київ") |
left(текст,кількість) | Алғашқы N таңба. | left("abcdef", 3) |
right(текст,кількість) | Соңғы N таңба. | right("abcdef", 3) |
mid(текст,позиція,кількість) | Мәтін үзіндісі; алғашқы орын — 1. | mid("abcdef", 2, 3) |
replace(текст,старий,новий) | Ішкі жолдың барлық кездесуін алмастырады. | replace("a-b-c", "-", "/") |
find(шукати,текст,позиція?) | Регистрді ескеретін ішкі жол орны; табылмаса 0. | find("b", "abc") |
search(шукати,текст,позиція?) | Регистрді ескермейтін ішкі жол орны; табылмаса 0. | search("B", "abc") |
contains(текст,частина) | Мәтінде ішкі жол бар-жоғы. | contains("abcdef", "cd") |
starts_with(текст,початок) | Мәтін көрсетілген ішкі жолдан бастала ма. | starts_with("ABC", "A") |
ends_with(текст,кінець) | Мәтін көрсетілген ішкі жолмен аяқтала ма. | ends_with("ABC", "C") |
clean(текст) | Басқару таңбаларын жояды. | clean("A\nB") |
repeat(текст,кількість) | Мәтінді 32768 таңба шегіне дейін қайталайды. | repeat("0", 3) |
padleft(текст,довжина,символ?) | Сол жақты бір таңбамен, әдепкі бос орынмен толтырады. | padleft("42", 5, "0") |
padright(текст,довжина,символ?) | Оң жақты бір таңбамен толтырады. | padright("42", 5, "0") |
transliterate(текст) | Кирилл/грек мәтінін бірізді транслитерациялау және латын диакритикаларын жою. | transliterate("Київ") |
Күндер
| Функция | Мақсаты | Мысал |
|---|
date(рік,місяць,день) | Жарамды ISO күнтізбелік күнін жасайды. | date(2026, 9, 27) |
today() | Бүкіл блокқа бекітілген ағымдағы UTC күні. | today() |
now() | Бүкіл блокқа бекітілген UTC уақыты. | now() |
datevalue(текст,формат?) | Күнді талдайды; әдепкі ISO немесе strptime пішімі. | datevalue("27.09.2026", "%d.%m.%Y") |
formatdate(дата,формат) | Күнді пішімдейді; %Y — жыл, %m — ай, %d — күн. | formatdate("2026-09-27", "%d.%m.%Y") |
year(дата) | Күннің жылы. | year("2026-09-27") |
month(дата) | Күннің айы, 1–12. | month("2026-09-27") |
day(дата) | Ай ішіндегі күн. | day("2026-09-27") |
hour(датачас) | UTC сағаты, 0–23. | hour("2026-09-27T12:30:00Z") |
minute(датачас) | Минут, 0–59. | minute("2026-09-27T12:30:00Z") |
second(датачас) | Секунд, 0–59. | second("2026-09-27T12:30:05Z") |
weekday(дата) | ISO апта күні: дүйсенбі — 1, жексенбі — 7. | weekday("2026-09-27") |
weeknum(дата) | ISO апта нөмірі. | weeknum("2026-09-27") |
adddays(дата,днів) | Күнтізбелік күндерді қосады немесе азайтады. | adddays("2026-09-27", 7) |
addmonths(дата,місяців) | Күнді айлар бойынша жылжытады; күн ай соңымен шектеледі. | addmonths("2026-01-31", 1) |
datediff(початок,кінець,одиниця?) | Күн, ай (толық айлар), жыл (толық жылдар), сағат, минут немесе секунд айырмасы. | datediff("2026-01-01", "2026-02-01", "days") |
eomonth(дата,зсув?) | Ағымдағы немесе жылжытылған айдың соңғы күні. | eomonth("2026-01-15", 1) |
Шарттар
| Функция | Мақсаты | Мысал |
|---|
coalesce(значення*) | null да, бос та емес алғашқы мән. | coalesce(None, "", 0, 5) |
ifelse(умова,так,ні) | Кейінге қалдырылған шарт: тек таңдалған тармақ есептеледі. | ifelse(10 > 5, "yes", "no") |
iferror(вираз,заміна) | Есептеу қатесінде балама мән қояды; синтаксис қателері мен жоқ өрістер жасырылмайды. | iferror(10 / 0, 0) |
isblank(значення) | Мән null немесе бос мәтін бе. | isblank("") |
isnumber(значення) | Мән мәтін не логикалық мән емес, сан ба. | isnumber(12.5) |
istext(значення) | Мән мәтін бе. | istext("12") |
and_(умови*) | Барлық шарт ақиқат; қажет болғанша есептеу. | and_(1 > 0, 2 > 1) |
or_(умови*) | Кемінде бір шарт ақиқат; қажет болғанша есептеу. | or_(False, True) |
not_(умова) | Логикалық терістеу. | not_(False) |
Мәтіннің екі шетінен таңбаларды жою
removeleft(text, count) алғашқы N таңбасы алынған мәтінді қайтарады; removeright(text, count) соңғы N таңбасын жояды. Қалған мәтін өзгермейді. Мысалы, removeleft("UA-001", 3) мына нәтижені береді: 001, ал removeright("report.csv", 4) мына нәтижені береді: report. Бұл мынадан өзгеше: left және right— олар тиісті үзіндіні сақтайды.