Le funzioni generano un output denominato valore restituito che, a seconda della funzione, può essere un numero, testo, un valore vero/falso o un tipo di data. La maggior parte delle funzioni richiede dei parametri. I parametri sono i dati inseriti nella funzione e vengono separati da virgole e indicati tra parentesi dopo il nome della funzione. L'ordine dei parametri e il formato dei dati di ciascun parametro sono fattori importanti. Quando inserisci una funzione da un menu, viene inserito un testo segnaposto per ogni parametro. Per completare la funzione, devi sostituire il testo segnaposto di ciascun parametro. Le funzioni con "..." ammettono un numero qualsiasi di parametri aggiuntivi.
Per istruzioni su come utilizzare le funzioni nelle colonne personalizzate, consulta l'articolo Creare colonne personalizzate.
Categoria | Tipo restituito | Funzione | Descrizione |
Aritmetica | Numero | round(x) |
Arrotonda [x] al numero intero più vicino |
Aritmetica | Numero | floor(x) |
Restituisce il numero intero più grande minore di o uguale a [x] |
Aritmetica | Numero | ceiling(x) |
Restituisce il numero intero più piccolo maggiore di o uguale a [x] |
Funzione logica | Variabile | if(condition, if_true, if_false) |
Valuta [condition] e restituisce [if_true] se la condizione è vera e [if_false] se la condizione è falsa. Il tipo di valore restituito sarà lo stesso di [if_true] e [if_false]. |
Funzione logica | Vero/Falso | or(x, y, ...) |
Restituisce True se uno dei parametri è vero |
Funzione logica | Vero/Falso | not(x) |
Restituisce True se [x] è falso e restituisce False se [x] è vero |
Funzione logica | Vero/Falso | and(x, y, ...) |
Restituisce True se tutti i parametri sono veri |
Testo | Testo | concat(text1, text2, ...) |
Combina due o più stringhe di testo |
Testo | Vero/Falso | is_empty(text) |
Restituisce True se [text] non ha caratteri |
Testo | Testo | trim(text) |
Rimuove lo spazio vuoto intorno a una stringa di testo |
Testo | Vero/Falso | starts_with(needle, haystack) |
Restituisce True se la stringa di testo [haystack] inizia con [needle] |
Testo | Vero/Falso | ends_with(needle, haystack) |
Restituisce True se la stringa di testo [haystack] termina con [needle] |
Testo | Numero | search(needle, haystack) |
Restituisce la posizione iniziale della prima istanza di [needle] in [haystack] |
Testo | Vero/Falso | contains(needle, haystack) |
Restituisce True se la stringa di testo [haystack] contiene [needle] |
Testo | Testo | right(text, length) |
Restituisce gli ultimi [length] caratteri di [text] |
Testo | Testo | left(text, length) |
Restituisce i primi [length] caratteri di [text] |
Testo | Testo | substitute(haystack, needle, replacement) |
Sostituisce tutte le istanze di [needle] in [haystack] con [replacement] |
Testo | Testo | upper(text) |
Converte tutti i caratteri in [text] in MAIUSCOLO |
Testo | Testo | lower(text) |
Converte tutti i caratteri in [text] in minuscolo |
Testo | Numero | length(text) |
Restituisce il numero di caratteri in [text] |
Conversione | Testo | to_text(value) |
Converte [value] in testo |
Conversione | Numero | to_number(value) |
Converte [value] in un numero |
Data | Data | date(year, month, day) |
Restituisce la data con l'anno, il mese e il giorno specificati |
Data | Numero | day(date) |
Restituisce il giorno del mese di [date] |
Data | Numero | month(date) |
Restituisce il mese dell'anno (da 1 a 12) di [date] |
Data | Numero | quarter(date) |
Restituisce il trimestre dell'anno (da 1 a 4) di [date] |
Data | Numero | year(date) |
Restituisce l'anno di [date] sotto forma di numero |
Data | Numero | weekday(date) |
Restituisce il giorno della settimana (da 1 a 7) per [date], con 1 che equivale a domenica |
Data | Numero | weeknum(date) |
Restituisce il numero della settimana corrente dell'anno (da 1 a 54) per [date], con le settimane che iniziano la domenica |
Data | Numero | daynum(date) |
Restituisce il giorno dell'anno (da 1 a 355 o 356) per [date] |
Data | Numero | days_between(date1, date2) |
Restituisce il numero di giorni compresi tra [date1] e [date2] |
Data | Data | offset_days(date, days) |
Aggiunge [days] a [date], conteggiando in avanti o all'indietro nel tempo in giorni di calendario |
Data | Data | offset_months(date, months) |
Aggiunge [months] al componente mese di [date]; se il mese risultante non ha abbastanza giorni per il componente giorno, viene restituito l'ultimo giorno del nuovo mese. |
Data | Data | offset_years(date, years) |
Aggiunge [years] al componente anno di [date] |
Data | Data | today() |
Restituisce la data corrente nel fuso orario dell'account del proprietario della colonna personalizzata |
Data | Data | yesterday() |
Restituisce la data del giorno precedente nel fuso orario dell'account del proprietario della colonna personalizzata |
Data | Data | week_start_sunday() |
Restituisce la data dell'ultima domenica nel fuso orario dell'account del proprietario della colonna personalizzata |
Data | Data | week_start_monday() |
Restituisce la data dell'ultimo lunedì nel fuso orario dell'account del proprietario della colonna personalizzata |
Data | Data | month_start() |
Restituisce la prima data del mese corrente nel fuso orario dell'account del proprietario della colonna personalizzata |
Data | Data | year_start() |
Restituisce la prima data dell'anno corrente (1 gennaio) nel fuso orario dell'account del proprietario della colonna personalizzata |
Data | Data | report_range_start() |
Restituisce la data all'inizio dell'attuale intervallo di tempo del report |
Data | Data | report_range_end() |
Restituisce la data alla fine dell'attuale intervallo di tempo del report |
Data | Numero | report_days_count() |
Restituisce il numero di giorni a cui fa riferimento il report, calcolato in base alla data di inizio e di fine |