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.

  • Per formattare i numeri, è possibile utilizzare formati numerici predefiniti o creare formati numerici definiti dall'utente.

Guardate le sezioni fornite alla fine di questo capitolo - Formati numerici predefiniti e formati numerici personalizzati per la funzione FORMAT.

  • Per formattare date e ore, è possibile utilizzare formati data / ora predefiniti o creare formati data / ora definiti dall'utente.

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.

  • Se l'espressione ha una cifra nella posizione in cui appare il carattere # nella stringa di formato, visualizza la cifra.

  • Altrimenti, non visualizza nulla in quella posizione.

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.

  • Se l'espressione di formato contiene solo # caratteri a sinistra di questo simbolo, i numeri inferiori a 1 iniziano con un separatore decimale.

  • Per visualizzare uno zero iniziale visualizzato con numeri frazionari, utilizzare zero come segnaposto della prima cifra a sinistra 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à".

  • I numeri inferiori a 1.000 ma maggiori o uguali a 500 vengono visualizzati come 1, mentre i numeri inferiori a 500 vengono visualizzati come 0.

  • Due migliaia di separatori adiacenti in questa posizione scala di un fattore di 1 milione e un fattore aggiuntivo di 1.000 per ogni separatore aggiuntivo.

  • Più separatori in qualsiasi posizione diversa da quella immediatamente a sinistra del separatore decimale o la posizione più a destra nella stringa vengono trattati semplicemente come se specifichino l'uso di un separatore di migliaia.

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 -

  • "#, 0." Utilizza il separatore delle migliaia per formattare il numero 100 milioni come stringa "100.000.000".

  • "# 0 ,." Utilizza il ridimensionamento di un fattore mille per formattare il numero 100 milioni come stringa "100000".

  • "#, 0 ,." Utilizza il separatore delle migliaia e il ridimensionamento di mille per formattare il numero 100 milioni come stringa "100.000".

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 .

  • Il numero di segnaposto di cifre a sinistra determina il numero di cifre nell'esponente.
  • Usa E- o e- per inserire un segno meno accanto agli esponenti negativi.
  • Usa E + o e + per inserire un segno meno accanto agli esponenti negativi e un segno più accanto agli esponenti positivi.
  • È inoltre necessario includere segnaposto per le cifre a destra di questo simbolo per ottenere la formattazione corretta.
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 (\).

  • La barra rovesciata stessa non viene visualizzata.
  • L'uso di una barra rovesciata equivale a racchiudere il carattere successivo tra virgolette doppie.
  • Per visualizzare un backslash, utilizzare due backslash.

Tuttavia, alcuni caratteri non possono essere visualizzati come caratteri letterali. Per esempio,

  • I caratteri di formattazione della data e dell'ora (a, c, d, h, m, n, p, q, s, t, w, y, / e :)
  • I caratteri di formattazione numerica (#, 0,%, E, e, virgola e punto)
  • I caratteri di formattazione della stringa (@, &, <,> e!)
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 (")).