Testo DAX - funzione FORMAT
Descrizione
Converte un valore in testo in base al formato specificato.
Sintassi
FORMAT (<value>, <format_string>)
Parametri
Sr.No. | Parametro e descrizione |
---|---|
1 | value Un valore o un'espressione che restituisce un singolo valore. |
2 | format_string Una stringa che rappresenta uno stile di formattazione.
Guardate le sezioni fornite alla fine di questo capitolo - Formati numerici predefiniti e formati numerici personalizzati per la funzione FORMAT.
Fare riferimento all'esercitazione - DAX in questa libreria di esercitazioni per i dettagli sulla formattazione di date e ore. |
Valore di ritorno
Una stringa contenente un valore formattato come definito da format_string.
Osservazioni
Se il valore è BLANK (), la funzione FORMAT restituisce una stringa vuota.
Se format_string è BLANK (), il valore è formattato con un formato "Numero generale" o "Data generale" (in base al tipo di dati del valore).
Esempio
La tabella seguente mostra i risultati della funzione FORMAT con il primo valore di argomento fornito nella prima riga e format_string fornito nella prima colonna. Fare riferimento alle sezioni fornite sotto questa tabella per comprendere le stringhe di formato.
"5" | "-5" | "0,5" | "0" | |
Stringa di lunghezza zero ("") | 5 | -5 | 0,5 | 0 |
0 | 5 | -5 | 1 | 0 |
0.00 | 5.00 | -5.00 | 0.50 | 0.00 |
#, ## 0 | 5 | -5 | 1 | 0 |
$ #, ## 0; ($ #, ## 0) | $ 5 | ($ 5) | $ 1 | $ 0 |
$ #, ## 0.00; ($ #, ## 0.00) | $ 5,00 | ($ 5,00) | $ 0,50 | $ 0,00 |
0% | 500% | -500% | 50% | 0% |
0,00% | 500,00% | -500,00% | 50,00% | 0,00% |
0.00E + 00 | 5,00 E + 00 | -5.00E + 00 | 5.00E-01 | 0.00E + 00 |
0.00E-00 | 5.00E00 | -5.00E00 | 5.00E-1 | 0.00E00 |
"$ #, ## 0 ;; \ Z \ e \ r \ o" | $ 5 | $ -5 | $ 1 | Zero |
Formati numerici predefiniti per la funzione FORMAT
La tabella seguente identifica i nomi di formato numerico predefinito che possono essere utilizzati in base al nome per l'argomento dello stile di formato della funzione Format.
Sr.No. | Formato stringa e descrizione |
---|---|
1 | "General Number" Visualizza il numero senza mille separatori. |
2 | "Currency" Visualizza il numero con migliaia di separatori, se appropriato. Visualizza due cifre a destra del separatore decimale. L'output si basa sulle impostazioni locali del sistema. |
3 | "Fixed" Visualizza almeno una cifra a sinistra e due cifre a destra del separatore decimale. |
4 | "Standard" Visualizza un numero con migliaia di separatori, almeno una cifra a sinistra e due cifre a destra del separatore decimale. |
5 | "Percent" Visualizza il numero moltiplicato per 100 con un segno di percentuale (%) aggiunto immediatamente a destra. Visualizza sempre due cifre a destra del separatore decimale. |
6 | "Scientific" Utilizza la notazione scientifica standard, fornendo due cifre significative. |
7 | "Yes/No" Visualizza No se il numero è 0. In caso contrario, visualizza Sì. |
8 | "True/False" Visualizza False se il numero è 0. In caso contrario, visualizza True. |
9 | "On/Off" Visualizza Off se il numero è 0. In caso contrario, visualizza On. |
Formati numerici personalizzati per la funzione FORMAT
Un'espressione di formato definita dall'utente per i numeri può avere da una a tre sezioni separate da punto e virgola.
Se l'argomento format_string della funzione Format contiene uno dei formati numerici predefiniti, è consentita solo una sezione.
La tabella seguente mostra come le sezioni vengono applicate durante la formattazione.
Sr.No. | Numero di sezione e risultato formato |
---|---|
1 | One section only L'espressione di formato si applica a tutti i valori. |
2 | Two sections La prima sezione si applica ai valori positivi e agli zeri. Il secondo si applica ai valori negativi. |
3 | Three sections La prima sezione si applica ai valori positivi. La seconda sezione si applica ai valori negativi. La terza sezione si applica agli zeri. |
Se includi punti e virgola senza niente tra loro, la sezione mancante viene stampata utilizzando il formato del valore positivo.
La tabella seguente identifica i caratteri che è possibile utilizzare per creare formati numerici definiti dall'utente.
Sr.No. | Specifica e descrizione del formato |
---|---|
1 | None Visualizza il numero senza formattazione. |
2 | 0 (zero character) Segnaposto di cifra. Visualizza una cifra o uno zero. Se l'espressione ha una cifra nella posizione in cui appare lo zero nella stringa di formato, visualizza la cifra. Altrimenti, visualizza uno zero in quella posizione. Se il numero ha meno cifre rispetto agli zeri (su entrambi i lati del decimale) nell'espressione di formato, visualizza gli zeri iniziali o finali. Se il numero ha più cifre a destra del separatore decimale di quanti sono gli zeri a destra del separatore decimale nell'espressione di formato, arrotonda il numero a tante cifre decimali quanti sono gli zeri. Se il numero ha più cifre a sinistra del separatore decimale di quanti sono gli zeri a sinistra del separatore decimale nell'espressione di formato, visualizza le cifre aggiuntive senza modifiche.
Questo simbolo funziona come il segnaposto a 0 cifre, tranne per il fatto che gli zeri iniziali e finali non vengono visualizzati se il numero ha meno cifre di quanti sono i caratteri # su entrambi i lati del separatore decimale nell'espressione di formato. |
3 | . (dot character) Segnaposto decimale. Il segnaposto decimale determina quante cifre vengono visualizzate a sinistra ea destra del separatore decimale.
In alcune versioni locali, una virgola viene utilizzata come separatore decimale. Il carattere effettivo utilizzato come segnaposto decimale nell'output formattato dipende dal formato numerico riconosciuto dal sistema. Pertanto, è necessario utilizzare il punto come segnaposto decimale nei formati anche se ci si trova in una locale che utilizza una virgola come segnaposto decimale. La stringa formattata apparirà nel formato corretto per le impostazioni internazionali. |
4 | % Segnaposto percentuale. Moltiplica l'espressione per 100. Il carattere percentuale (%) viene inserito nella posizione in cui appare nella stringa di formato. |
5 | , (comma character) Mille separatori. Il separatore delle migliaia separa migliaia da centinaia all'interno di un numero che ha quattro o più posizioni a sinistra del separatore decimale. L'uso standard del separatore delle migliaia è specificato se il formato contiene un separatore delle migliaia circondato da segnaposto di cifre (0 o #). Un separatore di migliaia immediatamente a sinistra del separatore decimale (indipendentemente dal fatto che sia specificato o meno un decimale) o come il carattere più a destra nella stringa significa "ridimensionare il numero dividendolo per 1.000, arrotondando secondo necessità".
In alcune località, un punto viene utilizzato come separatore di mille. Il carattere effettivo utilizzato come separatore delle migliaia nell'output formattato dipende dal formato numero riconosciuto dal sistema. Pertanto, dovresti usare la virgola come separatore delle migliaia nei tuoi formati, anche se ti trovi in una locale che utilizza un punto come separatore delle migliaia. La stringa formattata apparirà nel formato corretto per le impostazioni internazionali. Esempi -
|
6 | : (colon character) Separatore di tempo. Il separatore dell'ora separa ore, minuti e secondi quando i valori dell'ora vengono formattati. In alcune impostazioni locali, possono essere utilizzati altri caratteri per rappresentare il separatore dell'ora. Il carattere effettivo utilizzato come separatore dell'ora nell'output formattato è determinato dalle impostazioni di sistema. |
7 | / (forward slash character) Separatore di data. Il separatore della data separa il giorno, il mese e l'anno in cui vengono formattati i valori della data. In alcune versioni locali, possono essere utilizzati altri caratteri per rappresentare il separatore della data. Il carattere effettivo utilizzato come separatore della data nell'output formattato è determinato dalle impostazioni di sistema. |
8 | E- , E+ , e- , e+ Scientific format. Se l'espressione di formato contiene almeno un segnaposto di una cifra (0 o #) a sinistra di E-, E +, e- o e +, il numero viene visualizzato in formato scientifico e E o e viene inserito tra il numero e il suo esponente .
|
9 | -+$() Personaggi letterali. Questi caratteri vengono visualizzati esattamente come digitati nella stringa di formato. Per visualizzare un carattere diverso da uno di quelli elencati, anteporlo a una barra rovesciata (\) o racchiuderlo tra virgolette doppie (""). |
10 | \ (backward slash character) Visualizza il carattere successivo nella stringa di formato. Per visualizzare un carattere che ha un significato speciale come carattere letterale, farlo precedere da una barra rovesciata (\).
Tuttavia, alcuni caratteri non possono essere visualizzati come caratteri letterali. Per esempio,
|
11 | "ABC" Visualizza la stringa tra virgolette doppie (""). Per includere una stringa nell'argomento di stile dall'interno del codice, è necessario utilizzare Chr (34) per racchiudere il testo (34 è il codice carattere per virgolette (")). |