Funcții utile în expresii: text, numere și date
O expresie nu doar copiază o valoare: o poate și transforma. Transformi un nume în majuscule, calculezi prețul cu TVA, scrii data de azi în formatul românesc. Toate acestea se fac cu funcții (numite și metode) adăugate după un punct, ca .toUpperCase(). În această lecție înveți câteva pe care le vei folosi zilnic.
Cum se scrie o funcție
O funcție este o acțiune pe care o aplici unei valori. O scrii după valoare, cu un punct, iar la final pui paranteze rotunde: valoare.functie(). Dacă funcția are nevoie de o informație în plus (de exemplu, câte zecimale), o pui între paranteze.
{{ $json.nume.toUpperCase() }} → LAPTOP NOVA 14
{{ $json.pret.round(2) }} → 3499E ca în Excel, unde scrii =MAJUSCULE(B2) sau =ROUND(C2; 2), doar că aici funcția vine după valoare. Le poți și înlănțui: $json.nume.trim().toUpperCase() taie întâi spațiile, apoi face majuscule.
Parantezele de la final sunt obligatorii, chiar și goale: .toUpperCase(). Fără ele, n8n nu execută funcția. Și literele mari din numele funcției contează: toUpperCase, nu touppercase.
Funcții pentru text
| Funcția | Ce face | Exemplu (nume = „Laptop Nova 14”) |
|---|---|---|
| .toUpperCase() | totul cu majuscule | LAPTOP NOVA 14 |
| .toLowerCase() | totul cu litere mici | laptop nova 14 |
| .trim() | taie spațiile de la început și de la sfârșit | „ Ana ” → „Ana” |
| .split(' ')[0] | împarte textul la spații și ia prima bucată | Laptop |
| .includes('Laptop') | verifică dacă textul conține ceva (true / false) | true |
.split(' ')[0] merită explicat: split(' ') taie textul acolo unde sunt spații și obține o listă de cuvinte (["Laptop", "Nova", "14"]), iar [0] ia primul element din listă. În programare, numărătoarea începe de la 0. Cu asta afli, de exemplu, prenumele unui client: din „Ana Popescu” obții „Ana”.
Numere și calcule
În expresii poți face calcule ca într-un calculator: +, -, * (înmulțire), / (împărțire). Prețul cu TVA de 19% este prețul înmulțit cu 1.19:
{{ $json.pret * 1.19 }} → 4163.8099999999995
{{ ($json.pret * 1.19).round(2) }} → 4163.81
{{ ($json.pret * 1.19).toFixed(2) }} → "4163.81" (text)Prima linie arată o ciudățenie a calculatoarelor: unele zecimale nu se pot scrie exact, așa că apar multe cifre. De aceea rotunjești:
- .round(2): rotunjește la 2 zecimale și rămâne număr. O folosești când valoarea merge mai departe în calcule sau în câmpuri de tip Number.
- .toFixed(2): rotunjește și îl transformă în text, mereu cu exact 2 zecimale (89.00). Bun pentru mesaje afișate oamenilor.
Când calculezi și apoi aplici o funcție, pune calculul între paranteze: ($json.pret * 1.19).round(2). Fără paranteze, $json.pret * 1.19.round(2) ar rotunji doar numărul 1.19, nu rezultatul.
Data și ora
n8n are două valori gata pregătite pentru timp:
- $now: momentul de acum (data și ora).
- $today: ziua de azi, la ora 00:00.
Cu .toFormat() alegi cum se afișează. Literele din format înseamnă: dd ziua, MM luna, yyyy anul, HH ora, mm minutele (atenție: MM mare = luna, mm mic = minutele). În simulator ceasul arată luni, 2 martie 2026, ora 9:00:
{{ $now.toFormat('dd.MM.yyyy') }} → 02.03.2026
{{ $now.toFormat('dd.MM.yyyy HH:mm') }} → 02.03.2026 09:00
{{ $today.toFormat('dd.MM.yyyy HH:mm') }} → 02.03.2026 00:00
{{ $now.toFormat('cccc') }} → luniDespre adunarea de zile (scadența peste 30 de zile) și fusurile orare vorbim într-o lecție separată, în modulul al doilea.
$if: o alegere simplă
$if(conditie, daca_da, daca_nu) alege una din două valori, la fel ca funcția IF din Excel:
{{ $if($json.stoc > 0, 'în stoc', 'epuizat') }}Pentru „Laptop Nova 14” (stoc 8) rezultatul este „în stoc”, iar pentru „Monitor 27 inch” (stoc 0), „epuizat”. Pentru decizii mai mari, care schimbă drumul datelor, vei folosi nodul If din modulul următor.
Când expresia are o greșeală
Dacă scrii greșit o funcție, previzualizarea Result devine roșie și arată un mesaj care începe cu [EROARE: …]. Dacă rulezi oricum, nodul se oprește. Exemple:
| Ce ai scris | Mesajul | Ce înseamnă |
|---|---|---|
| $json.nume.toUpperCas() | „$json.nume.toUpperCas” nu este o funcție | numele funcției e scris greșit |
| $json.adresa.oras fără adresa | Nu pot citi „oras” dintr-o valoare undefined | câmpul de dinainte nu există |
| json.nume | „json” nu este definit | lipsește $ |
Citește mesajul de la coadă la cap: îți spune numele exact care nu merge. Compară-l cu ce ai scris și cu câmpurile din Input.
Exemple din viața reală
Oferta trimisă clientului are prețul cu TVA calculat și rotunjit la 2 zecimale.
„Bună, {{ $json.nume.split(' ')[0] }}!” sună mai prietenos decât numele complet.
Subiectul emailului de luni: „Raport vânzări {{ $now.toFormat('dd.MM.yyyy') }}”.
Pregătește lista de prețuri TehnoPlus pentru un afiș din magazin: pentru fiecare produs, numele cu majuscule, prețul cu TVA și data de azi.
- Apasă Execute workflow, ca Edit Fields să aibă produsele în Input.
- În Edit Fields creează nume_mare (String) = numele produsului cu majuscule (.toUpperCase()).
- Creează pret_cu_tva (Number) = pret înmulțit cu 1.19, rotunjit la 2 zecimale (.round(2)).
- Creează data (String) = data de azi în formatul dd.MM.yyyy ($now.toFormat(...)).
- Rulează și verifică: pentru primul produs trebuie să obții LAPTOP NOVA 14, 4163.81 și 02.03.2026.
Soluția exercițiului
1. Apasă Execute workflow.
2. În Edit Fields, Add Field: nume_mare (String) = {{ $json.nume.toUpperCase() }}
3. Add Field: pret_cu_tva (Number) = {{ ($json.pret * 1.19).round(2) }}
4. Add Field: data (String) = {{ $now.toFormat('dd.MM.yyyy') }}
5. Apasă Execute workflow. 