FORMAT
Converte un valore in testo in base al formato specificato.
Sintassi
FORMAT(<value>, <format_string>[, <locale_name>])
Parametri
| Termine | Definizione |
|---|---|
value |
Valore o espressione che restituisce un singolo valore. |
format_string |
Stringa con il modello di formattazione. |
locale_name |
(Facoltativo) Nome delle impostazioni locali da usare dalla funzione. I valori possibili sono stringhe accettate dalla funzione API di Windows LocaleNameToLCID(). |
Valore restituito
Stringa contenente value formattata come definito da format_string.
Nota
Se value è BLANK, la funzione restituisce una stringa vuota.
Se format_string è BLANK, il valore viene formattato con un formato "Numero generale" o "Data generale" (in base al tipo di dati value).
Osservazioni
Le stringhe di formato predefinite usano la proprietà delle impostazioni cultura del modello durante la formattazione del risultato. Per impostazione predefinita, la proprietà delle impostazioni cultura del modello viene impostata in base alle impostazioni locali dell'utente del computer. Per i nuovi modelli di Power BI Desktop, la proprietà delle impostazioni cultura del modello può essere modificata in Opzioni > Impostazioni internazionali > lingua del modello. Per Analysis Services, le impostazioni cultura del modello sono impostate in base alla proprietà Language definita inizialmente dall'istanza di .
Le stringhe di formato supportate come argomento per la funzione DAXFORMAT si basano sulle stringhe di formato usate da Visual Basic (automazione OLE), non sulle stringhe di formato usate da .NET Framework. Pertanto, è possibile ottenere risultati imprevisti o un errore se l'argomento non corrisponde ad alcuna stringa di formato definita. Ad esempio, "p" come abbreviazione di "Percent" non è supportato. Le stringhe fornite come argomento per la funzione FORMAT che non sono incluse nell'elenco di stringhe di formato predefinite vengono gestite come parte di una stringa di formato personalizzata o come valore letterale stringa.
Per altre informazioni su come specificare le impostazioni locali con FORMAT, vedere questo video .
L'uso di FORMAT modifica il risultato di una misura in un tipo di dati di testo. Se il risultato della misura è originariamente di tipo numerico, con FORMAT, la misura non può essere usata negli oggetti visivi in cui la sezione values richiede un tipo di dati numerico, ad esempio con i grafici. In Power BI è possibile usare in alternativa stringhe di formato dinamico per le misure specificare una stringa di formato condizionale che gestisce il tipo di dati numerico della misura.
Questa funzione non è supportata per l'uso in modalità DirectQuery quando viene usata nelle colonne calcolate o nelle regole di sicurezza a livello di riga.
Esempi
Stringhe di formato
= FORMAT( 12345.67, "General Number")
= FORMAT( 12345.67, "Currency")
= FORMAT( 12345.67, "Fixed")
= FORMAT( 12345.67, "Standard")
= FORMAT( 12345.67, "Percent")
= FORMAT( 12345.67, "Scientific")
Rendiconto:
12345.67 "Numero generale" visualizza il numero senza formattazione.
$12.345.67 "Valuta" visualizza il numero con la formattazione delle impostazioni locali della valuta. L'esempio seguente mostra la formattazione predefinita della valuta degli Stati Uniti.
12345.67 "Fixed" visualizza almeno una cifra a sinistra del separatore decimale e due cifre a destra del separatore decimale.
12.345.67 "Standard" visualizza almeno una cifra a sinistra del separatore decimale e due cifre a destra del separatore decimale e include i separatori delle migliaia. L'esempio seguente mostra la formattazione predefinita dei numeri degli Stati Uniti.
1.234.567.00 % "Percent" visualizza il numero come percentuale (moltiplicato per 100) con formattazione e il segno percentuale a destra del numero separato da uno spazio singolo.
1,23E+04 "Scientifico" visualizza il numero nella notazione scientifica con due cifre decimali.
Datetime con locale_name facoltativo
= FORMAT( dt"2020-12-15T12:30:59", BLANK(), "en-US" )
= FORMAT( dt"2020-12-15T12:30:59", BLANK(), "en-GB" )
= FORMAT( dt"2020-12-15T12:30:59", "mm/dd/yyyy", "en-GB" )
Rendiconto:
15/12/2020 12:30:59 PM Dove il mese precede giorno e ora è formato di 12 ore.
12/15/2020 12:30:59 Dove giorno precede mese e ora è formato di 24 ore.
15/12/2020 12:30:59 Dove il mese precede giorno e ora è formato di 24 ore. Poiché viene specificata una stringa di formato non dipendente dalle impostazioni locali, le impostazioni locali non vengono applicate e viene restituito il formato non locale.
Formati numerici predefiniti
Nell'argomento format_string è possibile specificare i formati numerici predefiniti seguenti:
Format |
Descrizione |
|---|---|
"General Number" |
Visualizza il numero senza separatori di migliaia. |
"Currency" |
Visualizza il numero con separatori delle migliaia, se appropriato; visualizza due cifre a destra del separatore decimale. L'output si basa sulle impostazioni locali di sistema. |
"Fixed" |
Visualizza almeno una cifra a sinistra e due cifre a destra del separatore decimale. |
"Standard" |
Visualizza il numero con separatori delle migliaia, almeno una cifra a sinistra e due cifre a destra del separatore decimale. |
"Percent" |
Visualizza il numero moltiplicato per 100 con un segno di percentuale (%) accodato immediatamente a destra; visualizza sempre due cifre a destra del separatore decimale. |
"Scientific" |
Usa la notazione scientifica standard, fornendo due cifre significative. |
"Yes/No" |
Visualizza No se il numero è 0; in caso contrario, visualizza Sì. |
"True/False" |
Visualizza False se il numero è 0; in caso contrario, visualizza True. |
"On/Off" |
Visualizza Disattivato se il numero è 0; in caso contrario, visualizza Sì. |
Formati numerici personalizzati
Un'espressione di formato personalizzata per i numeri può avere da una a tre sezioni separate da punto e virgola. Se l'argomento stringa di formato contiene uno dei formati numerici denominati, è consentita una sola sezione.
| Se si usa | Il risultato è |
|---|---|
| Solo una sezione | L'espressione di formato si applica a tutti i valori. |
| Due sezioni | La prima sezione si applica ai valori positivi e agli zeri, il secondo ai valori negativi. |
| Tre sezioni | La prima sezione si applica ai valori positivi, il secondo ai valori negativi e il terzo agli zeri. |
"$#,##0;($#,##0)"
Se si includono punti e virgola, la sezione mancante viene definita usando il formato del valore positivo. Ad esempio, il formato seguente visualizza valori positivi e negativi usando il formato nella prima sezione e visualizza "Zero" se il valore è zero.
"$#,##0"
Se si includono punti e virgola, la sezione mancante viene visualizzata usando il formato del valore positivo.
Caratteri di formato numerico personalizzati
Nell'argomento format_string è possibile specificare i caratteri di formato numerico personalizzati seguenti:
| Carattere | Descrizione |
|---|---|
| Nessuno | Visualizzare il numero senza formattazione. |
(0) |
Segnaposto cifre. Visualizzare una cifra o uno zero. Se l'espressione ha una cifra nella posizione in cui viene visualizzato il valore 0 nella stringa di formato, visualizzarlo; in caso contrario, visualizzare uno zero in tale posizione. Se il numero contiene meno cifre rispetto agli zeri (su entrambi i lati del decimale) nell'espressione di formato, visualizzare zeri iniziali o finali. Se il numero ha più cifre a destra del separatore decimale rispetto a zero a destra del separatore decimale nell'espressione di formato, arrotondare il numero a quante cifre decimali sono presenti zeri. Se il numero ha più cifre a sinistra del separatore decimale rispetto a zero a sinistra del separatore decimale nell'espressione di formato, visualizzare le cifre aggiuntive senza alcuna modifica. |
(#) |
Segnaposto cifre. Visualizzare una cifra o niente. Se l'espressione ha una cifra nella posizione in cui il file # viene visualizzato nella stringa di formato, visualizzarlo; in caso contrario, non visualizzare nulla in tale posizione. Questo simbolo funziona come il segnaposto di 0 cifre, ad eccezione del fatto che gli zeri iniziali e finali non vengono visualizzati se il numero ha le stesse o meno cifre rispetto a quelle presenti su entrambi i lati del separatore decimale nell'espressione di formato. |
(.) |
Segnaposto decimale. In alcune impostazioni locali viene usata una virgola come separatore decimale. Il segnaposto decimale determina il numero di cifre visualizzate a sinistra e a destra del separatore decimale. Se l'espressione di formato contiene solo segni numerici a sinistra di questo simbolo, i numeri inferiori a 1 iniziano con un separatore decimale. Per visualizzare uno zero iniziale visualizzato con numeri frazionari, usare 0 come segnaposto della prima cifra a sinistra del separatore decimale. Il carattere effettivo utilizzato come segnaposto decimale nell'output formattato dipende dal formato numerico riconosciuto dal sistema. |
(%) |
Segnaposto percentuale. L'espressione viene moltiplicata per 100. Il carattere percentuale (%) viene inserito nella posizione in cui viene visualizzato nella stringa di formato. |
(,) |
Separatore delle migliaia. In alcune impostazioni locali, un punto viene usato come separatore delle migliaia. Il separatore delle migliaia separa migliaia da centinaia all'interno di un numero con quattro o più posizioni a sinistra del separatore decimale. L'uso standard del separatore delle migliaia viene specificato se il formato contiene un separatore di migliaia racchiuso tra segnaposto di cifre (0 o #). Due separatori di migliaia adiacenti o un separatore di migliaia immediatamente a sinistra del separatore decimale (indipendentemente dal fatto che sia specificato un separatore decimale) significa "ridimensionare il numero dividendo per 1000, arrotondando in base alle esigenze". Ad esempio, è possibile usare la stringa di formato "##0", per rappresentare 100 milioni come 100. I numeri inferiori a 1 milione vengono visualizzati come 0. Due separatori di migliaia adiacenti in qualsiasi posizione diversa da immediatamente a sinistra del separatore decimale vengono considerati semplicemente come specificare l'uso di un separatore delle migliaia. Il carattere effettivo usato come separatore delle migliaia nell'output formattato dipende dal formato numerico riconosciuto dal sistema. |
(:) |
Separatore di tempo. In alcune impostazioni locali è possibile usare altri caratteri per rappresentare il separatore di tempo. Il separatore di tempo separa ore, minuti e secondi quando vengono formattati i valori di ora. Il carattere effettivo usato come separatore temporale nell'output formattato è determinato dalle impostazioni di sistema. |
(/) |
Separatore di data. In alcune impostazioni locali è possibile usare altri caratteri per rappresentare il separatore di data. Il separatore di data separa il giorno, il mese e l'anno in cui i valori di data vengono formattati. Il carattere effettivo usato come separatore di data nell'output formattato è determinato dalle impostazioni di sistema. |
(E- E+ e- e+) |
Formato scientifico. Se l'espressione di formato contiene almeno un segnaposto di cifra (0 o #) a destra di E-, E+, e-o e+, il numero viene visualizzato in formato scientifico e E o e viene inserito tra il numero e il relativo esponente. Il numero di segnaposto di cifra a destra determina il numero di cifre nell'esponente. Usare E- o e- per posizionare un segno meno accanto a esponenti negativi. Usare E+ o e+ per posizionare un segno meno accanto a esponenti negativi e un segno più accanto a esponenti positivi. |
- + $ ( ) |
Visualizzare un carattere letterale. Per visualizzare un carattere diverso da uno di quelli elencati, precederlo con una barra rovesciata (\) o racchiuderla tra virgolette doppie (" "). |
(\\) |
Visualizzare il carattere successivo nella stringa di formato. Per visualizzare un carattere con un significato speciale come carattere letterale, precederlo con una barra rovesciata (\). La barra rovesciata non viene visualizzata. L'uso di una barra rovesciata equivale a racchiudere il carattere successivo tra virgolette doppie. Per visualizzare una barra rovesciata, utilizzare due barre rovesciata (\\). Esempi di caratteri che non possono essere visualizzati come caratteri letterali sono i caratteri di formattazione della data e della formattazione temporale (a, c, d, h, m, n, p, q, s, t, w, y, /, e :), i caratteri di formattazione numerica (#, 0, %, E, e, virgola e punto) e i caratteri di formattazione delle stringhe (@, &, <, >e !). |
| ("ABC") | Visualizzare la stringa tra virgolette doppie (" "). |
Formati di data/ora predefiniti
I formati di data/ora predefiniti seguenti possono essere specificati nell'argomento format_string. Quando si usano formati diversi da questi, vengono interpretati come un formato di data/ora personalizzato:
| Formato | Descrizione |
|---|---|
"General Date" |
Visualizza una data e/o un'ora. Ad esempio, 12/3/2008 11:07:31. La visualizzazione della data è determinata dal valore delle impostazioni cultura correnti dell'applicazione. |
"Long Date" o "Medium Date" |
Visualizza una data in base al formato di data estesa delle impostazioni cultura correnti. Ad esempio, mercoledì 12 marzo 2008. |
"Short Date" |
Visualizza una data usando il formato di data breve delle impostazioni cultura correnti. Ad esempio, 12/3/2008. |
"Long Time" o |
Visualizza un'ora usando il formato a lungo termine delle impostazioni cultura correnti; in genere include ore, minuti, secondi. Ad esempio, 11:07:31. |
"Medium Time" |
Visualizza un'ora in formato 12 ore. Ad esempio, alle 11:07. |
"Short Time" |
Visualizza un'ora in formato 24 ore. Ad esempio, 11:07. |
Formati di data/ora personalizzati
I caratteri di formato seguenti possono essere specificati nel format_string per creare formati di data/ora personalizzati:
| Carattere | Descrizione |
|---|---|
(:) |
Separatore di tempo. In alcune impostazioni locali è possibile usare altri caratteri per rappresentare il separatore di tempo. Il separatore di tempo separa ore, minuti e secondi quando vengono formattati i valori di ora. Il carattere effettivo usato come separatore temporale nell'output formattato è determinato dalle impostazioni di sistema. |
(/) |
Separatore di data. In alcune impostazioni locali è possibile usare altri caratteri per rappresentare il separatore di data. Il separatore di data separa il giorno, il mese e l'anno in cui i valori di data vengono formattati. Il carattere effettivo usato come separatore di data nell'output formattato è determinato dalle impostazioni di sistema. |
(\) |
Barra rovesciata. Visualizza il carattere successivo come carattere letterale. Quindi, non viene interpretato come carattere di formattazione. |
(") |
Virgolette doppie. Viene visualizzato il testo racchiuso tra virgolette doppie. Quindi, non viene interpretato come caratteri di formattazione. |
c |
Visualizzare la data come ddddd e visualizzare l'ora come ttttt, in tale ordine. Visualizza solo le informazioni sulla data se non è presente alcuna parte frazionaria per il numero di serie della data; visualizzare solo le informazioni sull'ora se non è presente alcuna parte intera. |
d |
Visualizza il giorno come numero senza zero iniziale (1-31). |
dd |
Visualizza il giorno come numero con uno zero iniziale (01-31). |
ddd |
Visualizzare il giorno come abbreviazione (Sun-Sat). Localizzato. |
dddd |
Visualizzare il giorno come nome completo (Sunday-Saturday). Localizzato. |
ddddd |
Visualizza la data come data completa (inclusi giorno, mese e anno), formattata in base all'impostazione del formato di data breve del sistema. Il formato di data breve predefinito è mm/dd/yyyy. |
dddddd |
Visualizzare un numero di serie di date come data completa (inclusi giorno, mese e anno) formattati in base all'impostazione di data estesa riconosciuta dal sistema. Il formato di data estesa predefinito è dddd, mmmm d, yyyy. |
w |
Visualizza il giorno della settimana come numero (da 1 per domenica a 7 per sabato). |
ww |
Visualizza la settimana dell'anno come numero (1-54). |
m |
Visualizza il mese come numero senza zero iniziale (1-12). Se m segue immediatamente h o hh, viene visualizzato il minuto anziché il mese. |
mm |
Visualizza il mese come numero con zero iniziale (01-12). Se mm segue immediatamente h o hh, viene visualizzato il minuto anziché il mese. |
mmm |
Visualizzare il mese come abbreviazione (Jan-Dec). Localizzato. |
mmmm |
Visualizzare il mese come nome completo del mese (January-December). Localizzato. |
q |
Visualizzare il trimestre dell'anno come numero (1-4). |
y |
Visualizza il giorno dell'anno come numero (1-366). |
yy |
Visualizzare l'anno come numero a 2 cifre (00-99). |
yyyy |
Visualizza l'anno come numero a 4 cifre (100-9999). |
h |
Visualizzare l'ora come numero senza zero iniziale (0-23). |
hh |
Visualizzare l'ora come numero con zero iniziale (00-23). |
n |
Visualizzare il minuto come numero senza zero iniziale (0-59). |
nn |
Visualizzare il minuto come numero con zero iniziale (00-59). |
s |
Visualizzare il secondo come numero senza zero iniziale (0-59). |
ss |
Visualizzare il secondo come numero con uno zero iniziale (00-59). |
ttttt |
Visualizzare un'ora come ora completa (inclusi ora, minuti e secondi), formattata usando il separatore di tempo definito dal formato ora riconosciuto dal sistema. Viene visualizzato uno zero iniziale se è selezionata l'opzione iniziale zero e l'ora è precedente alle 10:00 o alle 10:00 Il formato ora predefinito è h:mm:ss. |
AM/PM |
Usa l'orologio di 12 ore e visualizza un AM maiuscolo con qualsiasi ora prima di mezzogiorno; visualizzare un PM maiuscolo con qualsiasi ora tra mezzogiorno e 11:59. |
am/pm |
Usa l'orologio di 12 ore e visualizza un AM minuscolo con qualsiasi ora prima di mezzogiorno; visualizzare un PM minuscolo con qualsiasi ora tra mezzogiorno e 11:59 P.M. |
A/P |
Usa l'orologio di 12 ore e visualizza una A maiuscola con qualsiasi ora prima del mezzogiorno; visualizzare un P maiuscolo con qualsiasi ora tra mezzogiorno e 11:59 P.M. |
a/p |
Usa l'orologio di 12 ore e visualizza una A minuscola con qualsiasi ora prima di mezzogiorno; visualizzare un P minuscolo con qualsiasi ora tra mezzogiorno e 11:59 |
AMPM |
Usa l'orologio di 12 ore e visualizza il valore letterale stringa AM come definito dal sistema con qualsiasi ora prima del mezzogiorno; visualizzare il valore letterale stringa PM come definito dal sistema con qualsiasi ora compresa tra mezzogiorno e 11:59 AMPM può essere maiuscolo o minuscolo, ma il caso della stringa visualizzata corrisponde alla stringa come definito dalle impostazioni di sistema. Il formato predefinito è AM/PM. Se il sistema è impostato su 24 ore, la stringa viene in genere impostata su una stringa vuota. |
La formattazione di data/ora usa le impostazioni locali dell'utente corrente per formattare la stringa. Si consideri ad esempio la data del 25 giugno 2020. Quando viene formattato usando la stringa di formato "m/d/aaaa", sarà:
- Le impostazioni locali utente sono Stati Uniti d'America (en-US): "25/6/2020"
- Le impostazioni locali utente sono Germania (de-DE): "6.25.2020"
Esempi di formato di data/ora personalizzati
Gli esempi seguenti usano la data/ora giovedì 25 giugno 2020 alle 13:45. Germania (de-DE) utilizza un sistema di 24 ore. Non esiste un equivalente di AM/PM.
| Formato | Risultato (en-US) | Risultato (de-DE) |
|---|---|---|
"c" |
06/25/2020 13:23:45 | 25.06.2020 13:23:45 |
"d" |
25 | 25 |
"dd" |
25 | 25 |
"ddd" |
Gio | Fare |
"dddd" |
Giovedì | Donnerstag |
"ddddd" |
06/25/2020 | 25.06.2020 |
"dddddd" |
Giovedì 25 giugno 2020 | Donnerstag, 25. Juni 2020 |
"w" |
5 | 5 |
"ww" |
26 | 26 |
"m" |
6 | 6 |
"mm" |
06 | 06 |
"mmm" |
Giu | Giu |
"mmmm" |
Giugno | Juni |
"q" |
2 | 2 |
"y" |
177 | 177 |
"yy" |
20 | 20 |
"yyyy" |
2020 | 2020 |
"""Year"" yyyy" |
Anno 2020 | Anno 2020 |
"yyyy \Qq" |
2020 Q2 | 2020 Q2 |
"dd/mm/yyyy" |
25/06/2020 | 25.06.2020 |
"mm/dd/yyyy" |
06/25/2020 | 06.25.2020 |
"h:nn:ss" |
13:23:45 | 13:23:45 |
"h:nn:ss AMPM" |
1:23:45 PM | 1:23:45 |
"hh:nn:ss" |
13:23:45 | 13:23:45 |
"hh:nn:ss AMPM" |
01:23:45 PM | 01:23:45 |
"ttttt" |
13:23:45 | 13:23:45 |
"ttttt AMPM" |
13:23:45 PM | 13:23:45 |
"mm/dd/yyyy hh:nn:ss AMPM" |
25/06/2020 01:23:45 PM | 6.25.2020 01:23:45 |