Operatori operators

Questa sezione contiene informazioni strutturate che supportano l’interpretazione, il recupero e la risposta alle domande relative a questo argomento.

Per una comprensione completa, queste informazioni devono essere unite alla documentazione su questa pagina. Nessuna delle due origini è progettata per essere indipendente; la pagina descrive la funzione, mentre questa sezione fornisce un contesto aggiuntivo che aiuta a non ambiguare la terminologia, le finalità, l’applicabilità e i vincoli.

• TL;DR: Questa pagina è un riferimento completo degli operatori disponibili nell’editor di espressioni avanzate del Percorso, che include analisi logiche (and, or, not), confronti (==, !=, >, >=, <, <=, is null, is not null, has null), aritmetiche (+, -, /, *, %), controllo del tipo di corrispondenza (is numeric, is integer, is decimal), concatenazione di stringhe e operatori aritmetici di data.

Intenti:

• Combinare condizioni booleane utilizzando gli operatori logici and, or e not
• Verificare se il valore di un campo o di un’espressione è null o non null utilizzando is null / is not null
• Rilevare valori Null in un elenco utilizzando l’operatore has null
• Confronta valori numerici, datetime e datetimeonly utilizzando >, >=, <, <=, == e !=
• Eseguire l’aritmetica sui valori numerici utilizzando +, -, /, * e %
• Aggiungere una durata a un valore dateTime, dateTimeOnly o duration utilizzando l’operatore +

Glossario:

• Operatore unario: operatore applicato a un singolo operando; può essere mano sinistra (esempio: not) o mano destra (esempio: is null) (specifico per prodotto)
• Operatore binario: operatore applicato tra due operandi (ad esempio and, ==, +) (specifico per prodotto)
• ha null: operatore unario destro che restituisce true se un elenco contiene almeno un elemento null (specifico per prodotto)
• è numerico / è intero / è decimale: operatori di verifica dei tipi che restituiscono un valore booleano basato sul sottotipo numerico dell’espressione (specifico per prodotto)

Guardrail:

• Quando si utilizza la moltiplicazione (*), entrambi gli operandi devono essere dello stesso tipo numerico (intero o entrambi i decimali). La combinazione dei tipi causa un errore
• Quando si utilizza l’operatore + per l’aritmetica delle date, l’espressione deve essere racchiusa tra parentesi per evitare errori di analisi
• Gli operatori di confronto (>, >=, <, <=) sono validi solo tra tipi compatibili: Datetime con Datetime, DatetimeOnly con DatetimeOnly o numeric con numeric. Qualsiasi altra combinazione non è consentita
• Una stringa vuota "" non è considerata nulla — has null restituisce false per un elenco contenente ""
• Gli operatori == e != non eseguono alcun controllo del tipo di dati tra operandi

Terminologia:

• Nome canonico: Operators — Acronym: none — variants: expression operators, percorsi operators
• Sinonimi: and = “AND logico”; or = “OR logico”; not = “NOT logico”; % = “modulo”
• Non confondere: is null (l’espressione non ha un valore valutato) ≠ == null (sintassi non valida); has null (l’elenco contiene null) ≠ is null (l’espressione stessa è null)

Domande frequenti:

• Q: è possibile moltiplicare direttamente un numero intero per un numero decimale? — No; entrambi gli operandi di * devono essere dello stesso tipo. Utilizzare 3.0 * 4.0 (entrambi decimali) o 3 * 4 (entrambi interi).
• Q: come si aggiungono 15 minuti a un dateTime? — Utilizza (toDateTime("...")) + (toDuration("PT15M")).
• Q: Qual è la differenza tra is null e has null? — is null controlla se una singola espressione non ha un valore valutato; has null controlla se un elenco contiene almeno un elemento null.
• Q: "" has null restituisce true? — No; una stringa vuota non è considerata nulla, pertanto il risultato è falso.
• Q: perché 3 * 4.0 causa un errore? — L’operatore * richiede che entrambi gli operandi siano dello stesso tipo numerico. La combinazione di numeri interi e decimali non è consentita.