Funkcja generuje dane wyjściowe nazywane zwracaną wartością (zależnie od rodzaju funkcji może to być liczba, tekst, wartość prawda lub fałsz albo data). Większość funkcji wymaga parametrów. Parametry to dane wejściowe funkcji, które podaje się w nawiasach po jej nazwie i rozdziela przecinkami. Kolejność parametrów i format danych każdego z nich mają znaczenie. Gdy wybierzesz funkcję w menu, zamiast każdego parametru zostanie wstawiony tekst zastępczy. Aby dokończyć konfigurowanie funkcji, musisz zamiast tekstu zastępczego wpisać odpowiednią wartość każdego parametru. W przypadku funkcji, które na liście parametrów mają podany symbol „…”, można stosować dowolną liczbę parametrów dodatkowych.
Instrukcje korzystania z funkcji w kolumnach niestandardowych znajdziesz w artykule Tworzenie kolumn niestandardowych.
Kategoria | Typ zwracanej wartości | Funkcja | Opis |
Funkcje arytmetyczne | Liczba | round(x) |
Zaokrągla wartość [x] do najbliższej liczby całkowitej |
Funkcje arytmetyczne | Liczba | floor(x) |
Zwraca największą liczbę całkowitą, która jest co najwyżej równa [x] |
Funkcje arytmetyczne | Liczba | ceiling(x) |
Zwraca najmniejszą liczbę całkowitą, która jest co najmniej równa [x] |
Operatory logiczne | Różne | if(condition, if_true, if_false) |
Analizuje warunek [condition]: jeśli jest on prawdziwy, zwraca wartość [if_true], a jeśli jest fałszywy – [if_false]. Zwracana wartość będzie tego samego typu co [if_true] i [if_false]. |
Operatory logiczne | Prawda/Fałsz | or(x, y…) |
Zwraca wartość „Prawda”, jeśli jeden z parametrów jest prawdziwy |
Operatory logiczne | Prawda/Fałsz | not(x) |
Zwraca wartość „Prawda”, jeśli warunek [x] jest fałszywy, lub wartość „Fałsz”, jeśli jest on prawdziwy |
Operatory logiczne | Prawda/Fałsz | and(x, y…) |
Zwraca wartość „Prawda”, jeśli wszystkie parametry są prawdziwe |
Tekst | Tekst | concat(text1, text2…) |
Łączy co najmniej 2 ciągi tekstowe |
Tekst | Prawda/Fałsz | is_empty(text) |
Zwraca wartość „Prawda”, jeśli ciąg tekstowy [text] nie zawiera znaków |
Tekst | Tekst | trim(text) |
Usuwa odstępy na początku lub na końcu ciągu tekstowego |
Tekst | Prawda/Fałsz | starts_with(needle, haystack) |
Zwraca wartość „Prawda”, jeśli ciąg tekstowy [haystack] zaczyna się ciągiem [needle] |
Tekst | Prawda/Fałsz | ends_with(needle, haystack) |
Zwraca wartość „Prawda”, jeśli ciąg tekstowy [haystack] kończy się ciągiem [needle] |
Tekst | Liczba | search(needle, haystack) |
Zwraca pozycję początkową pierwszego wystąpienia ciągu tekstowego [needle] w ciągu [haystack] |
Tekst | Prawda/Fałsz | contains(needle, haystack) |
Zwraca wartość „Prawda”, gdy ciąg tekstowy [haystack] zawiera ciąg [needle] |
Tekst | Tekst | right(text, length) |
Zwraca ostatnie znaki ([length]) ciągu tekstowego [text] |
Tekst | Tekst | left(text, length) |
Zwraca pierwsze znaki ([length]) ciągu tekstowego [text] |
Tekst | Tekst | substitute(haystack, needle, replacement) |
Zastępuje wszystkie wystąpienia ciągu tekstowego [needle] w elemencie [haystack] ciągiem [replacement] |
Tekst | Tekst | upper(text) |
Przekształca wszystkie znaki w ciągu tekstowym [text] w WIELKIE LITERY |
Tekst | Tekst | lower(text) |
Przekształca wszystkie znaki w ciągu tekstowym [text] w małe litery |
Tekst | Liczba | length(text) |
Zwraca liczbę znaków w ciągu tekstowym [text] |
Konwersja | Tekst | to_text(value) |
Przekształca wartość [value] w tekst |
Konwersja | Liczba | to_number(value) |
Przekształca wartość [value] w liczbę |
Data | Data | date(year, month, day) |
Zwraca datę z dokładnością do roku [year], miesiąca [month] i dnia [day] |
Data | Liczba | day(date) |
Zwraca dzień miesiąca z funkcji [date] |
Data | Liczba | month(date) |
Zwraca miesiąc roku (1–12) z funkcji [date] |
Data | Liczba | quarter(date) |
Zwraca kwartał roku (1–4) z funkcji [date] |
Data | Liczba | year(date) |
Zwraca rok z funkcji [date] w postaci liczbowej |
Data | Liczba | weekday(date) |
Zwraca dzień tygodnia (1–7) z funkcji [date], przy czym niedziela to 1 |
Data | Liczba | weeknum(date) |
Zwraca numer bieżącego tygodnia roku (1–54) z funkcji [date], przy czym pierwszym dniem tygodnia jest niedziela |
Data | Liczba | daynum(date) |
Zwraca dzień roku (od 1 do 365 lub 366) z funkcji [date] |
Data | Liczba | days_between(date1, date2) |
Zwraca liczbę dni między [date1] a [date2] |
Data | Data | offset_days(date, days) |
Dodaje liczbę dni [days] do komponentu dni w dacie z funkcji [date], przy czym po przekroczeniu końca zakresu (1–31) odliczanie jest kontynuowane od jego początku (np. w przypadku miesiąca 31-dniowego 20 + 15 = 4) |
Data | Data | offset_months(date, months) |
Dodaje liczbę miesięcy [months] do komponentu miesięcy w dacie z funkcji [date]. Jeśli miesiąc wynikowy ma mniej dni niż źródłowy, zwracany jest ostatni dzień miesiąca wynikowego. |
Data | Data | offset_years(date, years) |
Dodaje liczbę lat [years] do komponentu roku w dacie z funkcji [date] |
Data | Data | today() |
Zwraca aktualną datę według strefy czasowej konta właściciela kolumny niestandardowej |
Data | Data | yesterday() |
Zwraca datę poprzedniego dnia według strefy czasowej konta właściciela kolumny niestandardowej |
Data | Data | week_start_sunday() |
Zwraca datę ostatniej niedzieli według strefy czasowej konta właściciela kolumny niestandardowej |
Data | Data | week_start_monday() |
Zwraca datę ostatniego poniedziałku według strefy czasowej konta właściciela kolumny niestandardowej |
Data | Data | month_start() |
Zwraca datę pierwszego dnia bieżącego miesiąca według strefy czasowej konta właściciela kolumny niestandardowej |
Data | Data | year_start() |
Zwraca datę pierwszego dnia bieżącego roku (1 stycznia) według strefy czasowej konta właściciela kolumny niestandardowej |
Data | Data | report_range_start() |
Zwraca datę rozpoczynającą bieżący zakres czasowy raportu. |
Data | Data | report_range_end() |
Zwraca datę kończącą bieżący zakres czasowy raportu |
Data | Liczba | report_days_count() |
Zwraca liczbę dni objętych raportem na podstawie daty rozpoczęcia i zakończenia jego zakresu czasowego |