[mepr-show rules=”7898″ unauth=”message”]
[/mepr-show]
Formule e funzioni in Notion
Di seguito analizzeremo dettagli tecnici ed esempi per ogni funzione, operatore e costante di Notion, nonché i modelli utilizzati per formattare le date usando la funzione formatDate().
Formule
Le formule sono espressioni di calcolo che possiamo usare nelle proprietà di tipo Formula, che possono essere composte da operatori, funzioni, valori numerici, testuali e riferimenti a proprietà. I riferimenti a proprietà ci danno la possibilità di effettuare calcoli diversi e automatici per ciascuno dei record della tabella o del database inserendo una sola formula.
Tutte queste funzioni, operatori e costanti possono essere usati solo nell’ambiente di una tabella di Notion e più precisamente all’interno di una proprietà di tipo Formula.
Funzioni
Le funzioni ci aiutano a eseguire calcoli e operazioni, restituendo un risultato come risposta. Esistono molte funzioni e possono essere classificate in base al tipo di dati che restituiscono. Possiamo capire di che tipo sono osservando l’icona che precede la funzione nell’elenco.
Il tipo booleano restituisce un risultato di tipo logico, può avere due valori possibili: Vero o Falso. Notion rappresenta questo valore sotto forma di casella di controllo o checkbox: se è spuntata è vero, altrimenti è falso.
Caratteristiche delle funzioni
- Tutte le funzioni hanno questa struttura sintattica
nombre(parámetro, parámetro). Subito dopo il nome della funzione si apre sempre una parentesi, senza lasciare alcuno spazio tra il nome della funzione e la parentesi. Tra la parentesi di apertura e quella di chiusura inseriremo i parametri, separati da virgole, esempioequal(2, 4). - Ci sono funzioni che non necessitano di parametri, esempio
now(). - Possiamo includere come parametro il valore di una proprietà all’interno di una funzione, esempio
day(prop("fecha de alta")). Come vediamo nell’esempioprop("fecha de alta")è il modo in cui invochiamo la proprietà. - I parametri di tipo testo vanno sempre tra virgolette, esempio
length("Hello world"). Se il valore di testo si trova all’interno di una proprietà non è necessario aggiungere virgolette aggiuntive, esempiolength(prop("nombre")). - Tutte le funzioni restituiscono un risultato che può essere un numero, un testo, una data o ora, o un booleano.
- Le funzioni possono essere annidate l’una nell’altra, esempio
formatDate(now(), "DD/MM/YYYY")nell’esempio annidiamonow()all’interno diformatDate(). - Possiamo eseguire operazioni matematiche con i risultati restituiti dalle funzioni all’interno della stessa formula, esempio
round(prop("total")) + 10
Parametri e argomenti: questi concetti possono creare confusione perché sembrano essere la stessa cosa ma non lo sono. Ad esempio, quando enunciamo la funzione
subtract(número, número)possiamo dire che questa funzione necessita di due parametri di tipo numerico, tuttavia nel momento in cui passiamo i dati alla funzione questi vengono chiamati argomenti, esempiosubtract(5, 3)in questo caso 5 e 3 sono gli argomenti che passiamo ai parametri della funzione. Potremmo dire che il parametro è il contenitore e l’argomento il contenuto.
Funzioni logiche di Notion
Le funzioni logiche valutano test logici di tipo booleano. Di seguito puoi vedere una tabella con gli operatori logici che possiamo usare per eseguire questi confronti.
| Operatore | Descrizione | Esempio |
|---|---|---|
== | Uguale | 2 == 2 → "Coche" == "Casa" → |
!= | Diverso o disuguale | 2 != 2 → falso | "Coche" != "Casa" → verdadero |
> | Maggiore di | 2 > 2 → falso |
< | Minore di | 2 < 3 → verdadero |
<= | Minore o uguale a | 2 >= 3 → falso |
>= | Maggiore o uguale a | 2 <= 2 → verdadero |
Da tenere in considerazione
- Quando confrontiamo stringhe di testo, queste devono essere tra virgolette, esempio
"Coche" != "Casa". - Non è possibile confrontare in un test logico un numero con una stringa di testo poiché sono di tipi diversi, ma possiamo usare la funzione
format()(converte un numero in stringa di testo) otoNumber()(converte una stringa di testo in un numero) per convertirli e poterli confrontare. La funzionetoNumber()può anche convertire un booleano in un numero: se ètrue(vero) lo convertirà in un1e se èfalse(falso) in un0. - Possiamo usare nel test logico proprietà della tabella, esempio
prop("nombre")=="Antonio"oprop("total")>1000. Oppure usare funzioni annidate per convertire i valori nel tipo che ci interessa per poterli confrontare, esempiotoNumber(prop("valor1"))>prop("valor2").
and(test logico, test logico)
Verifica se i valori restituiti da due test logici sono true o meno. Restituisce un risultato booleano. Applicato a una proprietà, questa ci mostra una casella di controllo che, nel caso in cui il risultato sia true (vero), mostra questa casella di controllo spuntata e altrimenti disattivata. Questa funzione restituirà true se entrambe le espressioni di confronto sono vere e restituirà false se una o entrambe sono false.
Esempio 1: and( 2 == 2, 2 == 3 ) → false
Argomento 1: La prima espressione di confronto, deve valutare un valore booleano.
Argomento 2: La seconda espressione di confronto, deve valutare un valore booleano.
Questa funzione permette l’uso di espressioni regolari, se vuoi imparare a usarle clicca qui.
Esempio 2: and(prop("Prop 1"), prop("Prop 2") >= 10)
Argomento 1: Nel primo argomento non è necessario inserire alcuna espressione di confronto poiché l’argomento stesso è booleano, dato che la Proprietà “Prop 1” è di tipo Checkbox, quindi l’argomento stesso ci fornisce un true o un false.
Argomento 2: Il secondo argomento valuta se il valore della proprietà “Prop 2” in ogni riga è maggiore o uguale a 10.
empty(valore)
Verifica se l’argomento è vuoto; se è vuoto restituisce true, se è pieno false. Restituisce un booleano.
Esempio 1: empty( "Mundo" ) → false
Esempio 2: empty( "" ) → true
Argomento: L’espressione da controllare, che può valutare qualsiasi tipo di valore, ad esempio, un numero, una stringa di testo o una data.
Esempio 3: empty(prop("Valor"))
Argomento: Valuta se il valore della proprietà “Valore” in ogni riga è vuoto o meno. Nel caso in cui la proprietà sia vuota ci fornisce un true e quando non lo è false.
equal(valore, valore)
Verifica se i valori restituiti da due espressioni sono uguali. Restituisce un boleano.
Esempio 1: equal( 2, 3 ) → false
Esempio 2: equal( "rojo", "azul" ) → false
Esempio 3: equal(3 * 5, 15 ) → true
Esempio 4: equal( false, not true ) → true
Operatore equivalente: [expresión] == [expresión]
Argomento 1: L’espressione da controllare, che può valutare qualsiasi tipo di valore, ad esempio, un numero, una stringa di testo, una data o un booleano.
Argomento 2: L’espressione da controllare, che può valutare qualsiasi tipo di valore, ad esempio, un numero, una stringa di testo, una data o un booleano.
Esempio: equal(prop("Valor 1"), prop("Valor 2"))
Argomenti: Valuta se il valore della proprietà “Valore 1” e “Valore 2” sono uguali. Nel caso in cui entrambe le proprietà siano uguali ci fornisce un true e quando non lo sono false.
if(test logico, valore, valore)
La funzione if() permette di eseguire un’azione se una condizione è soddisfatta, o un’altra azione se la condizione non è soddisfatta. Annidando le funzioni if() (posizionandole una dentro l’altra), puoi specificare azioni per numerose condizioni. Questa funzione necessita di tre parametri:
- Test logico, che viene valutato come
verdaderoofalso. - Valore o operazione da restituire se l’operazione è
verdadero. - Valore o operazione da restituire se l’operazione è
falso.
Esempio 1: if(prop("Valor 1") > prop("Valor 2"), "Es mayor", "Es menor o igual")
Argomento 1: Valuta se il valore della proprietà “Valore 1” è maggiore della proprietà “Valore 2”. Solo nel caso in cui “Valore 1” sia maggiore di “Valore 2” il risultato del test logico sarà true (Vero).
Argomento 2: Se il test logico restituisce true, il risultato da mostrare sarà “È maggiore”.
Argomento 3: Se il test logico restituisce false, il risultato da mostrare sarà “È minore o uguale”.
Dato che questa formula annidata è un po’ più complessa, vedremo questi esempi in un nuovo video esplicativo.
Esempio 2: if(prop("Valor 1") > prop("Valor 2"), "Es mayor", if(prop("Valor 1") < prop("Valor 2"), "Es menor", "Es igual"))
Argomento 1: Valuta se il valore della proprietà “Valore 1” è maggiore della proprietà “Valore 2”. Solo nel caso in cui “Valore 1” sia maggiore di “Valore 2” il risultato del test logico sarà true (Vero).
Argomento 2: Se il test logico restituisce true, il risultato da mostrare sarà “È maggiore”.
Argomento 3: Se il test logico restituisce false, come terzo argomento includiamo un nuovo if(prop("Valor 1") < prop("Valor 2"), "Es menor", "Es igual") annidato; questo if ha a sua volta tre parametri.
Questa funzione permette l’uso di espressioni regolari, se vuoi imparare a usarle clicca qui.
larger(valore, valore)
Restituisce true (vero) se il primo argomento è più grande del secondo e false (falso) in caso contrario. Possiamo valutare qualsiasi tipo di valore, testi, numeri, date o booleani. Nel caso in cui i valori siano uguali restituirebbe false. Entrambi i parametri devono essere dello stesso tipo (numero, testo, …). Restituisce un booleano.
Esempio 1: larger("Ac","Ab") → true
Esempio 2: larger(2,3) → false
Esempio 3: larger(prop("Fecha 1"),prop("Fecha 2")) → true
Esempio 4: larger(true, false) → true
Argomento 1: La prima espressione, che può valutare qualsiasi tipo di valore, ad esempio, un numero, testo, data o booleano.
Argomento 2: L’espressione con cui confrontare la prima. Il suo tipo di valore deve corrispondere al tipo di valore della prima espressione.
Come vengono valutati i testi con larger()? prima valuta la lettera più a sinistra di ogni argomento; nell’esempio 1, poiché la prima lettera è la “A” in entrambi gli argomenti, passa a valutare la seconda lettera; in questo caso la “c” del primo argomento è maggiore della “b” del secondo argomento perché le lettere hanno il valore del loro ordine nell’alfabeto e in questo caso la “c” è nella terza posizione e quindi è maggiore della “b” del secondo argomento. Qualsiasi lettera minuscola è maggiore di qualsiasi maiuscola.
E le date? la data più recente è sempre la maggiore.
I booleani, se è true ha valore 1 e se è false ha valore 0. Pertanto il valore true è sempre maggiore del false.
largerEq(valore, valore)
È uguale alla precedente con la differenza che questa funzione ci restituisce anche true nel caso in cui gli argomenti siano uguali. Restituisce true (vero) se il primo argomento è maggiore o uguale al secondo e false (falso) in caso sia minore. Possiamo valutare qualsiasi tipo di valore, testi, numeri, date o booleani. Entrambi i parametri devono essere dello stesso tipo (numero, testo, …). Restituisce un booleano.
Esempio 1: largerEq("Ac","Ab") → true
Esempio 2: largerEq(2,2) → true
Esempio 3: largerEq(prop("fecha 1"),prop("fecha 2")) → true
Esempio 4: largerEq(true, false) → true
Argomento 1: La prima espressione, che può valutare qualsiasi tipo di valore, ad esempio, un numero, testo, data o booleano.
Argomento 2: L’espressione con cui confrontare la prima. Il suo tipo di valore deve corrispondere al tipo di valore della prima espressione.
Come vengono valutati i testi con larger()? prima valuta la lettera più a sinistra di ogni argomento; nell’esempio 1, poiché la prima lettera è la “A” in entrambi gli argomenti, passa a valutare la seconda lettera; in questo caso la “c” del primo argomento è maggiore della “b” del secondo argomento perché le lettere hanno il valore del loro ordine nell’alfabeto e in questo caso la “c” è nella terza posizione e quindi è maggiore della “b” del secondo argomento. Qualsiasi lettera minuscola è maggiore di qualsiasi maiuscola.
E le date? la data più recente è sempre la maggiore.
I booleani, se è true ha valore 1 e se è false ha valore 0. Pertanto il valore true è sempre maggiore del false.
not(test logico)
Verifica se il test logico restituisce false. Se il test logico è false restituisce true e viceversa. Restituisce un booleano.
Esempio 1: not(2 == 3) → true
Esempio 2: not(prop("País 1") == prop("País 2"))
Esempio 3: not prop("País 1") == prop("País 2")
L’Esempio 3 svolge la stessa funzione dell’Esempio 2; in Notion, quando inseriamo l’espressione nella forma che vediamo nell’Esempio 2, una volta premuto il pulsante Done, la cambia come la vediamo nell’Esempio 3.
Argomento 1: Il test logico valuta un booleano. In questo caso valuta se 2 == 3 il risultato è false (falso). La funzione restituisce il booleano contrario al risultato del test logico true.
Esempio 4: if (not prop("Finalizado"), "No finalizado", "Finalizado")
In questo esempio abbiamo incluso not annidato in una funzione if(), come vediamo questa funzione perde le parentesi e funziona come un operatore di negazione.
Questa funzione permette l’uso di espressioni regolari, se vuoi imparare a usarle clicca qui.
or(test logico, test logico)
Se uno o entrambi i test logici restituiscono true. Nel caso in cui entrambi siano false, restituisce false. Restituisce un booleano.
Esempio 1: or(2==2, 1==3) → true
Esempio 2: or(2==4, 1==3) → false
Argomento 1: La prima espressione di confronto, deve valutare un test logico dando come risultato un valore booleano.
Argomento 2: La seconda espressione di confronto, deve valutare un test logico dando come risultato un valore booleano.
Questa funzione permette l’uso di espressioni regolari, se vuoi imparare a usarle clicca qui.
smaller(valore, valore)
Restituisce true (vero) se il primo argomento è più piccolo del secondo e false (falso) in caso contrario. Possiamo valutare qualsiasi tipo di valore, testi, numeri, date o booleani. Nel caso in cui i valori siano uguali restituirebbe false. Entrambi i parametri devono essere dello stesso tipo (numero, testo, …). Restituisce un booleano.
Esempio 1: smaller( "Ac","Ab") → false
Esempio 2: smaller( 2, 3 ) → true
Esempio 3: smaller(prop("Fecha 1"),prop("Fecha 2")) → false
Esempio 4: smaller( true, false ) → false
Argomento 1: La prima espressione, che può valutare qualsiasi tipo di valore, ad esempio, un numero, testo, data o booleano.
Argomento 2: L’espressione con cui confrontare la prima. Il suo tipo di valore deve corrispondere al tipo di valore della prima espressione.
Come vengono valutati i testi con larger()? prima valuta la lettera più a sinistra di ogni argomento; nell’esempio 1, poiché la prima lettera è la “A” in entrambi gli argomenti, passa a valutare la seconda lettera; in questo caso la “c” del primo argomento è maggiore della “b” del secondo argomento perché le lettere hanno il valore del loro ordine nell’alfabeto e in questo caso la “c” è nella terza posizione e quindi è maggiore della “b” del secondo argomento. Qualsiasi lettera minuscola è maggiore di qualsiasi maiuscola.
E le date? la data più recente è sempre la maggiore.
I booleani, se è true ha valore 1 e se è false ha valore 0. Pertanto il valore true è sempre maggiore del false.
smallerEq(valore, valore)
Restituisce true (vero) se il primo argomento è più piccolo del secondo e false (falso) in caso contrario. Possiamo valutare qualsiasi tipo di valore, testi, numeri, date o booleani. Nel caso in cui i valori siano uguali restituirebbe true. Entrambi i parametri devono essere dello stesso tipo (numero, testo, …). Restituisce un booleano.
Esempio 1: smallerEq( "Ac","Ab") → false
Esempio 2: smallerEq( 2, 3 ) → true
Esempio 3: smallerEq(prop("Fecha 1"),prop("Fecha 2")) → false
Esempio 4: smallerEq( true, false ) → false
Argomento 1: La prima espressione, che può valutare qualsiasi tipo di valore, ad esempio, un numero, testo, data o booleano.
Argomento 2: L’espressione con cui confrontare la prima. Il suo tipo di valore deve corrispondere al tipo di valore della prima espressione.
Come vengono valutati i testi con larger()? prima valuta la lettera più a sinistra di ogni argomento; nell’esempio 1, poiché la prima lettera è la “A” in entrambi gli argomenti, passa a valutare la seconda lettera; in questo caso la “c” del primo argomento è maggiore della “b” del secondo argomento perché le lettere hanno il valore del loro ordine nell’alfabeto e in questo caso la “c” è nella terza posizione e quindi è maggiore della “b” del secondo argomento. Qualsiasi lettera minuscola è maggiore di qualsiasi maiuscola.
E le date? la data più recente è sempre la maggiore.
I booleani, se è true ha valore 1 e se è false ha valore 0. Pertanto il valore true è sempre maggiore del false.
unequal(valore, valore)
Verifica se i valori restituiti da due espressioni sono disuguali. Restituisce un booleano.
Esempio 1: unequal( 2, 3 ) → true
Esempio 2: unequal( "rojo", "rojo" ) → false
Esempio 3: unequal(6 * 9, 42 ) → false
Esempio 4: unequal( true, not false ) → false
Operatore equivalente: [expresión] != [expresión]
Argomento 1: L’espressione da controllare, che può valutare qualsiasi tipo di valore, ad esempio, un numero, una stringa di testo, una data o un booleano.
Argomento 2: L’espressione da controllare, che può valutare qualsiasi tipo di valore, ad esempio, un numero, una stringa di testo, una data o un booleano.
Funzioni numeriche di Notion
Le funzioni numeriche eseguono operazioni matematiche con i numeri e restituiscono sempre un numero. Di seguito puoi vedere una tabella con gli operatori matematici che possiamo usare per eseguire queste operazioni.
| Operatore | Descrizione | Esempi |
|---|---|---|
- | Sottrae l’operando destro dall’operando sinistro per restituirne la differenza. | 4 - 2 → 2 |
+ | Somma operandi numerici per restituirne la somma, o concatena (combina) operandi testuali (stringhe di testo). | 2 + 2 → 4 |
* | Moltiplica i suoi operandi per restituirne il prodotto. | 3 * 6 → 18 |
/ | Divide l’operando sinistro per l’operando destro per restituirne il quoziente. | 21 / 7 → 3 |
% | L’operatore modulo restituisce il resto dopo aver diviso l’operando sinistro per l’operando destro. | 23 % 7 → 2 |
^ | Restituisce il valore della base elevato alla potenza. | 2 ^ 4 → 16 |
abs(numero)
Restituisce il valore assoluto di un numero. Restituisce un numero.
Esempio 1: abs( -3 ) → 3
Argomento 1: Il numero di cui vogliamo ottenere il valore assoluto.
add(valore, valore)
Somma due numeri e restituisce la somma di entrambi. Concatena anche due stringhe di caratteri e restituisce la somma di entrambe. Restituisce un numero o un testo a seconda del tipo dei suoi argomenti.
Esempio 1: add( 3 , 4 ) → 7
Esempio 2: add( "Hola " , "mundo" )Hola mundo
Argomento 1: Primo numero o testo della somma o concatenazione.
Argomento 2: Secondo numero o testo della somma o concatenazione.
cbrt(numero)
Restituisce la radice cubica di un numero. Restituisce un numero.
Esempio 1: cbrt( 8 ) → 2
Argomento 1: Il numero di cui vogliamo ottenere la radice cubica.
ceil(numero)
Restituisce il numero intero più piccolo maggiore o uguale a un numero. Restituisce un numero.
Esempio 1: ceil( 4.2 ) → 5
Argomento 1: Il numero di cui vogliamo ottenere l’intero superiore o uguale più vicino.
Notion usa il punto come separatore per i decimali.
divide(numero, numero)
Divide due numeri e restituisce il loro quoziente. Restituisce un numero.
Esempio 1: divide( 21, 7 ) → 3
Argomento 1: Dividendo.
Argomento 1: Divisore.
exp(numero)
Restituisce E ^ x, dove x è l’argomento ed E è la costante di Eulero (2,718…), la base del logaritmo naturale. Restituisce un numero.
Esempio 1: exp( 2 ) → 7.389056098931
Argomento 1: Il numero che servirà come esponente di E.
floor(numero)
Restituisce il numero intero più grande minore o uguale a un numero. Restituisce un numero.
Esempio 1: floor( 4.2 ) → 4
Argomento 1: Il numero di cui vogliamo ottenere l’intero minore o uguale più vicino.
Notion usa il punto come separatore per i decimali.
ln(numero)
Restituisce il logaritmo naturale, noto come logaritmo neperiano, di un numero. Restituisce un numero.
Esempio 1: ln( 3 ) → 1.098612288668
Argomento 1: Il numero di cui vogliamo ottenere il logaritmo neperiano.
log10(numero)
Restituisce il logaritmo in base 10 di un numero. Restituisce un numero.
Esempio 1: log10( 100 ) → 2
Argomento 1: Il numero di cui vogliamo ottenere il logaritmo in base 10.
log2(numero)
Restituisce il logaritmo in base 2 di un numero. Restituisce un numero.
Esempio 1: log2( 8 ) → 3
Argomento 1: Il numero di cui vogliamo ottenere il logaritmo in base 2.
max(numero, numero, numero, …)
Restituisce il numero maggiore di un elenco; possiamo aggiungere quanti numeri vogliamo separati da virgole. Restituisce un numero.
Esempio 1: max( 2, 5, 7, 21, 3 ) → 21
Argomenti 1, 2, 3, …: Elenco di numeri separati da virgole.
min(numero, numero, numero, …)
Restituisce il numero minore di un elenco; possiamo aggiungere quanti numeri vogliamo separati da virgole. Restituisce un numero.
Esempio 1: min( 2, 5, 7, 21, 3 ) → 2
Argomenti 1, 2, 3, …: Elenco di numeri separati da virgole.
mod(numero, numero)
Divide due numeri e restituisce il resto. Restituisce un numero.
Esempio 1: mod( 7, 3 ) → 1
Argomenti 1: Dividendo.
Argomenti 1: Divisore.
multiply(numero, numero)
Moltiplica due numeri e restituisce il loro prodotto. Restituisce un numero.
Esempio 1: multiply( 2 , 3 ) → 6
Argomento 1: Primo numero o fattore della moltiplicazione.
Argomento 2: Secondo numero o fattore della moltiplicazione.
pow(numero, numero)
Restituisce la base elevata alla potenza dell’esponente. Restituisce un numero.
Esempio 1: pow( 2 , 5 ) → 32
Argomento 1: Base.
Argomento 2: Esponente.
round(numero)
Restituisce il valore di un numero arrotondato all’intero più vicino. Restituisce un numero.
Esempio 1: round( 4.4 ) → 4
Esempio 1: round( 4.5 ) → 5
Argomento 1: Numero da arrotondare.
sign(numero)
Restituisce il segno di un numero: se è positivo restituisce 1, se è negativo restituisce -1 e se è zero restituisce 0. Restituisce un numero.
Esempio 1: sign( -9 ) → -1
Esempio 1: sign( 5 ) → 1
Esempio 1: sign( 0 ) → 0
Argomento 1: Numero di cui vogliamo restituire il segno.
sqrt(numero)
Restituisce la radice quadrata di un numero. Restituisce un numero.
Esempio 1: sqrt( 16 ) → 4
Argomento 1: Numero di cui vogliamo restituire la radice quadrata.
subtract(numero, numero)
Sottrae due numeri e restituisce la loro differenza. Restituisce un numero.
Esempio 1: subtract( 4 , 3 ) → 1
Argomento 1: Primo numero o minuendo della sottrazione.
Argomento 2: Secondo numero o sottraendo della sottrazione.
toNumber(testo)
Converte un testo in un numero. Se la stringa di testo inizia con un numero seguito da testo, prende quel numero e lo restituisce come risultato. Restituisce un numero.
Esempio 1: toNumber( "7" ) → 7
Esempio 1: toNumber( "51 productos" ) → 51
Argomento 1: Il numero da convertire.
unaryMinus(numero)
Converte un numero negativo in positivo o un numero positivo in negativo. Restituisce un numero.
Esempio 1: unaryMinus( -2 ) → 2
Esempio 2: unaryMinus( 3 ) → -3
Argomento 1: Il numero da convertire.
Operatore equivalente: [número] * -1
unaryPlus(testo)
Converte un testo in un numero. Se la stringa di testo inizia con un numero seguito da testo, a differenza di toNumber() non prende quel numero e restituisce il campo vuoto. Restituisce un numero.
Esempio 1: unaryPlus( "7" ) → 7
Esempio 1: unaryPlus( "51 productos" ) →
Argomento 1: Il testo da convertire.
Funzioni di testo di Notion
Funzioni con cui potrai effettuare modifiche e processi relativi a testi o proprietà che contengono testi.
concat(testo, testo, …)
Concatena o combina testi, non ha limiti di argomenti, possono essere quanti ne vuoi includere. Restituisce un testo.
Esempio 1: concat( "La ","Colmena ", "Tecnológica" ) → "La Colmena Tecnológica"
Argomenti: I testi da concatenare.
contains(testo, testo)
Restituisce true (vero) se il secondo argomento è trovato nel primo. Restituisce un booleano.
Esempio 1: contains( "notion","ion" ) → true
Esempio 1: contains( "La Colmena","Tec" ) → false
Argomento 1: Il testo dove vogliamo cercare.
Argomento 1: Il testo da cercare.
format(valore)
Converte un numero, data o booleano in un testo. Restituisce un testo.
Esempio 1: format( 3 ) → "3"
Argomento 1: Numero, data o booleano da convertire.
join(testo, testo, …)
Concatena o combina testi con un delimitatore specificato. Restituisce un testo.
Esempio 1: join( ", ","Olga", "María", "Fernando", "Luisa" ) → "Olga, María, Fernando, Luisa"
Argomenti: Il primo argomento è il delimitatore, una stringa di testo. Gli argomenti rimanenti sono i testi che verranno combinati separati dal delimitatore. Possiamo includere quanti argomenti vogliamo.
length(testo, espressione, testo)
Restituisce il numero di caratteri in una stringa di testo. Restituisce un testo.
Esempio 1: length( "La Colmena Tecnológica" ) → 22
Argomento 1: Il testo per cui restituire la lunghezza.
replace(testo, espressione, testo)
Sostituisce la prima occorrenza di un’espressione regolare all’interno di una stringa di testo con un nuovo testo specificato. Restituisce una stringa di testo.
Esempio 1: replace( "La verdad", "La", "Es" ) → "Es verdad"
Esempio 2: replace("1-2-3", "-", "!") → "1!2-3"
Esempio 3: replace("Mi nombre es Isabel", "(?<=es ).+(?=.)", "María") → "Mi nombre es María"
Argomento 1: Il testo originale.
Argomento 2: Testo o Espressione regolare (tra virgolette).
Argomento 3: Il testo di sostituzione.
L’Esempio 3 usa espressioni regolari, se vuoi imparare a usarle clicca qui
replaceAll(testo, espressione, testo)
Sostituisce la prima occorrenza di un’espressione regolare all’interno di una stringa di testo con un nuovo testo specificato. Restituisce una stringa di testo.
Esempio 1: replaceAll( "Me gusta el verano. Me gusta nadar", "Me gusta", "Me encanta" ) → "Me encanta el verano. Me encanta nadar."
Esempio 2: replaceAll(prop("Nombre"), "Dra?. ", "") → Sustituye "Dr. " o "Dra. " que hubiera cualquier registro de la tabla por nada "", es decir los elimina.
Argomento 1: Il testo originale.
Argomento 2: Testo o Espressione regolare (tra virgolette).
Argomento 3: Il testo di sostituzione.
L’Esempio 3 usa espressioni regolari, se vuoi imparare a usarle clicca qui
slice(testo, numero, numero)
La funzione slice() ci restituisce un segmento o parte del testo che le abbiamo fornito. Questa funzione necessita di almeno due parametri, anche se opzionalmente possiamo usarne tre:
- Testo originale da cui otterremo una parte.
- Punto di inizio, dove il primo carattere è
0. - Punto finale (opzionale)
Esempio 1: slice("La Colmena Tecnológica.", 3, 10) → “Colmena”
Esempio 2: slice("La Colmena Tecnológica.", 11, 22) → “Tecnológica”
Anche gli spazi bianchi contano come un carattere. Il parametro punto finale, a differenza del punto di inizio, non include il carattere, per questo per includere il carattere finale dovremo mettere la posizione subito dopo di esso.
test(prova)
Verifica se una stringa di testo corrisponde a un’espressione regolare. Restituisce un booleano.
Esempio 1: test( "Rojo, Verde, Azul", "Verde" ) → true
Esempio 2: test(prop("Nombre"), "^A|^C") → Devuelve true para cualquier nombre que empiece por A o por C.
Argomento 1: Il testo originale.
Argomento 2: Testo o Espressione regolare (tra virgolette).
Argomento 3: Il testo di sostituzione.
L’Esempio 3 usa espressioni regolari, se vuoi imparare a usarle clicca qui
Funzioni Data e ora di Notion
Sono funzioni che ci aiutano a eseguire operazioni con proprietà di tipo data e ora. Ad esempio, per calcolare quanti giorni sono trascorsi tra due date, estrarre un solo dato da una data (giorno, mese, anno) e molto altro. Conosciamo ciascuna di queste funzioni.
date(data)
Restituisce il giorno del mese, un numero intero tra 1 e 31, per una determinata data. Restituisce un numero.
Esempio 1: date(now()) → [current_date format="d"]
Esempio 2: date(prop("Fecha")) → Devuelve día que tenga la fecha de la propiedad Fecha.
Argomento 1: La data da cui identificare il giorno del mese.
Notion permette di ottenere una data solo attraverso una proprietà di tipo Date (data e ora) o attraverso la funzione now() che restituisce la data e l’ora corrente.
dateAdd(data, numero, testo)
Aggiungere tempo a una data. L’ultimo argomento, che può essere uno di questi: "years" (anni), "quarters" (trimestri), "months" (mesi), "weeks" (settimane), "days" (giorni), "hours" (ore), "minutes" (minuti), "seconds" (secondi), o "miliseconds" (millisecondi). Restituisce una data.
Esempio 1: dateAdd(now(), 1, "months") → Supponiamo che oggi sia il 15/08/2021, il risultato è Sep 15, 2020 10:46 AM (questo risultato può essere formattato con la funzione formatDate().
Argomento 1: La data iniziale.
Argomento 2: La quantità da aggiungere.
Argomento 3: L’unità di tempo, che può essere anni, trimestri, mesi, settimane, giorni, ore, minuti, secondi, millisecondi, tra virgolette.
Notion permette di ottenere una data solo attraverso una proprietà di tipo Date (data e ora) o attraverso la funzione now() che restituisce la data e l’ora corrente.
dateBetween(data, data, testo)
Restituisce la quantità di tempo tra due date. L’ultimo argomento, che può essere uno di questi: "years" (anni), "quarters" (trimestri), "months" (mesi), "weeks" (settimane), "days" (giorni), "hours" (ore), "minutes" (minuti), "seconds" (secondi), o "miliseconds" (millisecondi). Restituisce un numero.
Esempio 1: dateBetween(now(), prop("Created time"), "minutes") → 43
Argomento 1: La data maggiore.
Argomento 2: La data minore.
Argomento 3: L’unità di tempo, che può essere anni, trimestri, mesi, settimane, giorni, ore, minuti, secondi, millisecondi, tra virgolette.
Notion permette di ottenere una data solo attraverso una proprietà di tipo Date (data e ora) o attraverso la funzione now() che restituisce la data e l’ora corrente.
dateSubtract(data, numero, testo)
Sottrae tempo a una data. L’ultimo argomento, che può essere uno dei seguenti: "years" (anni), "quarters" (trimestri), "months" (mesi), "weeks" (settimane), "days" (giorni), "hours" (ore), "minutes" (minuti), "seconds" (secondi), o "miliseconds" (millisecondi). Restituisce una data.
Esempio 1: dateSubtract(now(), 1, "years") → Supponiamo che oggi sia il 15/08/2021, il risultato è Aug 15, 2020 11:45 AM (questo risultato può essere formattato con la funzione formatDate()).
Argomento 1: La data iniziale.
Argomento 2: La quantità da sottrarre.
Argomento 3: L’unità di tempo, che può essere anni, trimestri, mesi, settimane, giorni, ore, minuti, secondi, millisecondi, tra virgolette.
Notion permette di ottenere una data solo attraverso una proprietà di tipo Date (data e ora) o attraverso la funzione now() che restituisce la data e l’ora corrente.
day(data)
Restituisce l’indice (numero) del giorno della settimana per una data, dove domenica è 0, lunedì 1, e così via. Restituisce un numero.
Esempio 1: day(now()) → [current_date format="w"]
Argomento 1: La data per la quale identificare il giorno della settimana.
Notion permette di ottenere una data solo attraverso una proprietà di tipo Date (data e ora) o attraverso la funzione now() che restituisce la data e l’ora corrente.
end(data)
Restituisce la data finale di una proprietà data che contiene un intervallo di date. Restituisce una data.
Esempio 1: end(prop("Duración")) → Jun 27, 2020 21:15 AMformatDate()).
Argomento 1: Un riferimento a una proprietà di tipo Date che contiene una data finale.
formatDate(data, testo)
Formatta una data con la stringa di formato orario standard di Moment.
Esempio 1: formatDate(now(),"DD/MM/YYYY") → [current_date format="d/m/Y"]
Argomento 1: La proprietà data o now() che vogliamo formattare.
Argomento 2: Formato orario standard di Moment tra virgolette.
Formati di data
Combina questi schemi per costruire il secondo argomento della funzione.
| Categoria | Schema | Rappresentazione |
|---|---|---|
| Anno | YYYYYY | [current_date format=”y”] [current_date format=”Y”] |
| Trimestre | QQo | 1 … 4 1º … 4º |
| Mese | MMoMMMMMMMMM | 1 … 12 1º … 12º 01 … 12 giu gennaio |
| Settimana dell’anno | wwoww | 1 … 53 1º … 53º 01 … 53 |
| Giorno dell’anno | DDDDDDoDDDD | 1 … 365 1º … 365º 001 … 365 |
| Giorno | DDoDD | 1 … 31 1º … 31º 01 … 31 |
| Giorno della settimana | dddddddddd | 0 … 6 Do Dom Domenica |
| 24 ore | HHH | 0 … 23 00 … 23 |
| 12 ore | hhh | 1 … 12 01 … 12 |
| Minuti | m | 0 … 59 00 … 59 |
| Secondi | sss | 0 … 59 00 … 59 |
| AM / PM | aA | a.m. A.M. |
| Fuso orario | ZZZ | +02:00 +0200 |
| Secondi precisi | SSS | 0 … 9 00 … 99 |
| Millisecondi | SSS | 000 … 999 |
| Timestamp Unix | X | 1597491300 |
| Timestamp Unix in millisecondi | x | 1597491300000 |
fromTimestamp(numero)
Restituisce un valore di data da un timestamp Unix in millisecondi, ovvero il numero di millisecondi dal 1° gennaio 1970. Restituisce una data.
Esempio 1: fromTimestamp(159749388000) → Aug 15, 2020 14:19 AMformatDate()).
Argomento 1: Numero di un timestamp Unix in millisecondi, o numero di millisecondi trascorsi dal 1° gennaio 1970.
hour(data)
Restituisce l’ora del giorno, un numero intero compreso tra 0 e 23 di una data. Restituisce un numero.
Esempio 1: hour(now()) → [current_date format="G"]
Argomento 1: Il valore data/ora dal quale vogliamo ottenere l’ora del giorno.
minute(data)
Restituisce il minuto dell’ora, un numero intero compreso tra 0 e 59 di una data. Restituisce un numero.
Esempio 1: minute(now()) → [current_date format="i"]
Argomento 1: Il valore data/ora dal quale vogliamo ottenere il minuto.
month(data)
Restituisce l’indice numerico del mese dell’anno, un numero intero compreso tra 0 e 11 di una data, dove gennaio è 0, febbraio è 1, … Restituisce un numero.
Esempio 1: month(now()) → 7
Argomento 1: La data dalla quale vogliamo ottenere l’indice numerico del mese dell’anno.
now()
Restituisce la data attuale. Restituisce una data.
Esempio 1: now() → Aug 15, 2021 14:34 PM
Argomenti: Questa funzione non accetta argomenti.
start(data)
Restituisce la data iniziale di una proprietà data che contiene un intervallo di date. Restituisce una data.
Esempio 1: start(prop("Duración")) → Jun 01, 2020 21:15 AMformatDate()).
Argomento 1: Un riferimento a una proprietà di tipo Date che contiene una data iniziale.
timestamp(data)
Restituisce il timestamp Unix in millisecondi, ovvero il numero di millisecondi dal 1° gennaio 1970 della data fornita. Restituisce una data.
Esempio 1: timestamp(now()) → 159749388000
Argomento 1: La data dalla quale vogliamo ottenere il timestamp.
year(data)
Restituisce l’anno di una data. Restituisce un numero.
Esempio 1: year(now()) → [current_date format="Y"]
Argomento 1: La data dalla quale vogliamo ottenere l’anno.
Costanti
Sono valori fissi che non possono essere alterati o modificati, possono essere solo letti. Possiamo usarli nelle formule:
| Costante | Descrizione | Valore |
|---|---|---|
e | La base del logaritmo naturale o neperiano. | 2.718281828459 |
false | Falso o 0 | false |
true | Vero o 1 | true |
pi | Il rapporto tra la circonferenza di un cerchio e il suo diametro | 3.14159265359 |