Proprietà delle celle MDX - Contenuto di FORMAT_STRING

Si applica a: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

La proprietà FORMAT_STRING di una cella determina la formattazione della proprietà VALUE della cella, creando il valore della proprietà FORMATTED_VALUE della cella. La proprietà FORMAT_STRING della cella è in grado di gestire valori non elaborati di tipo stringa e numerici, applicando un'espressione di formato a un valore per restituire un valore formattato per la proprietà FORMATTED_VALUE . Nelle tabelle seguenti vengono indicati in dettaglio la sintassi e i caratteri di formattazione utilizzati per gestire valori di tipo stringa e numerici.

Valori stringa

Un'espressione di formato per le stringhe può includere una sezione oppure due sezioni separate da un punto e virgola (;).

Utilizzo	Risultato
Una sezione	Il formato viene applicato a tutti i valori stringa.
Due	La prima sezione viene applicata ai dati stringa, mentre la seconda sezione viene applicata ai valori Null e alle stringhe di lunghezza zero ("").

Nella tabella seguente vengono illustrati i caratteri che è possibile utilizzare nella stringa di formato per le stringhe di caratteri.

Carattere	Descrizione
@	Rappresenta un segnaposto di carattere al posto del quale viene visualizzato un carattere o uno spazio. Se nella stringa è presente un carattere nella posizione in cui nella stringa di formato è presente il simbolo chiocciola (@), verrà visualizzato il carattere. In caso contrario, in tale posizione della stringa formattata verrà visualizzato uno spazio. I segnaposti vengono sostituiti da destra verso sinistra, a meno che la stringa di formato non includa un punto esclamativo (!).
&	Rappresenta un segnaposto di carattere al posto del quale viene visualizzato un carattere oppure nulla. Se nella stringa è presente un carattere nella posizione in cui è presente il simbolo (&) nella stringa formattata verrà visualizzato il carattere. In caso contrario, nella stringa formattata non verrà visualizzato nulla. I segnaposti vengono sostituiti da destra verso sinistra, a meno che la stringa di formato non includa un punto esclamativo (!).
<	Impone la visualizzazione di caratteri minuscoli. Tutti i caratteri nella stringa formattata vengono visualizzati in minuscolo.
>	Impone la visualizzazione di caratteri maiuscoli. Tutti i caratteri nella stringa formattata vengono visualizzati in maiuscolo.
!	Impone la sostituzione dei segnaposti da sinistra verso destra. Per impostazione predefinita, i segnaposti vengono sostituiti da destra verso sinistra.

Valori numerici

Un'espressione di formato definita dall'utente per i numeri può includere da una a quattro sezioni separate da punti e virgola. Se l'argomento del formato include un formato numerico predefinito, sarà possibile utilizzare una sola sezione.

Utilizzo	Risultato
Una sezione	L'espressione di formato viene applicata a tutti i valori.
Due	La prima sezione viene applicata ai valori positivi e agli zeri, la seconda ai valori negativi.
Tre	La prima sezione viene applicata ai valori positivi, la seconda ai valori negativi e la terza agli zeri.
Quattro sezioni	La prima sezione viene applicata ai valori positivi, la seconda ai valori negativi, la terza agli zeri e la quarta ai valori Null.

Nell'esempio seguente vengono utilizzate due sezioni. La prima definisce il formato per i valori positivi e gli zeri, la seconda definisce il formato per i valori negativi.

"$#,##0;($#,##0)"  

Se si specificano punti e virgola (;) consecutivi, per i valori corrispondenti alla sezione mancante verrà utilizzando il formato per i valori positivi. La stringa di formato seguente, ad esempio, visualizza i valori positivi e negativi utilizzando il formato specificato nella prima sezione e visualizza "Zero" se il valore è zero:

"$#,##0;;\Z\e\r\o"  

Nella tabella seguente sono indicati i caratteri che è possibile utilizzare nella stringa di formato per i formati numerici.

Carattere	Descrizione
nessuno	Visualizza il numero senza formattazione.
0	Rappresenta un segnaposto di cifra al posto del quale viene visualizzata una cifra o uno zero (0). Se nel numero è presente una cifra nella posizione in cui nella stringa di formato è presente lo zero, nel valore formattato verrà visualizzata la cifra. In caso contrario, in tale posizione del valore formattato verrà visualizzato uno zero. Se il numero include meno cifre di quanti sono gli zeri nella stringa di formato, su entrambi i lati del separatore decimale, nel valore formattato verranno visualizzati zeri iniziali o finali. Se, a destra del separatore decimale, il numero include più cifre di quanti sono gli zeri a destra del separatore decimale nell'espressione di formato, il valore formattato verrà arrotondato specificando tante cifre decimali quanti sono gli zeri. Se, a sinistra del separatore decimale, il numero include più cifre di quanti sono gli zeri a sinistra del separatore decimale nell'espressione di formato, nel valore formattato le cifre aggiuntive verranno visualizzate senza modifiche.
#	Rappresenta un segnaposto di cifra al posto del quale viene visualizzata una cifra oppure nulla. Se nell'espressione è presente una cifra nella posizione in cui nella stringa di formato è presente il simbolo cancelletto (#), nel valore formattato verrà visualizzata la cifra. In caso contrario, in tale posizione del valore formattato non verrà visualizzato nulla. Come segnaposto il simbolo cancelletto (#) funziona come lo zero (0), con la differenza che, se il valore include un numero di cifre minore o uguale a quello dei caratteri # su entrambi i lati del separatore decimale nell'espressione di formato, non verranno visualizzati gli zeri iniziali e finali.
.	Rappresenta un segnaposto di decimali che determina il numero di cifre visualizzate a sinistra e a destra del separatore decimale. Se l'espressione di formato include solo simboli cancelletto (#) a sinistra del separatore decimale (.), i numeri inferiori a 1 inizieranno con il separatore decimale. Per visualizzare uno zero iniziale con i numeri frazionari, utilizzare zero (0) come primo segnaposto di cifra a sinistra del separatore decimale. Il carattere effettivo utilizzato come segnaposto di decimali nell'output formattato dipende dal formato numerico riconosciuto dal computer in uso. Nota: in alcune impostazioni locali viene usata la virgola come separatore decimale.
%	Rappresenta un segnaposto di percentuale. L'espressione viene moltiplicata per 100. Il segno di percentuale (%) viene inserito nella posizione in cui viene visualizzata la percentuale nella stringa di formato.
,	Rappresenta il separatore delle migliaia, che separa le migliaia dalle centinaia all'interno di un numero con quattro o più posizioni a sinistra del separatore decimale. Se il formato include un separatore delle migliaia racchiuso tra segnaposti di cifra (0 o #), il separatore delle migliaia verrà usato in modo standard. Due separatori adiacenti migliaia o un separatore di migliaia immediatamente a sinistra del separatore decimale (se è specificato o meno un decimale), significa "ridimensionare il numero suddividendo il numero per 1000, arrotondamento in base alle esigenze". Ad esempio, è possibile usare la stringa di formato "##0", per rappresentare 100 milioni di dollari come 100. I numeri inferiori a 1 milione vengono visualizzati come 0. Due separatori delle migliaia adiacenti in una posizione diversa da quella immediatamente a sinistra del separatore decimale vengono considerati elementi che specificano l'utilizzo di un separatore delle migliaia. Il carattere effettivo utilizzato come separatore delle migliaia nell'output formattato dipende dal formato numerico riconosciuto dal computer in uso. Nota: in alcune impostazioni locali viene usato il punto come separatore delle migliaia.
:	Rappresenta il separatore dell'ora che separa le ore, i minuti e i secondi nei valori di ora formattati. Nota: in alcune impostazioni locali potrebbero essere usati altri caratteri come separatore dell'ora. Il carattere effettivo utilizzato come separatore dell'ora nell'output formattato è determinato dalle impostazioni di sistema del computer in uso.
/	Rappresenta il separatore della data che separa il giorno, il mese e l'anno nei valori di data formattati. Il carattere effettivo utilizzato come separatore della data nell'output formattato è determinato dalle impostazioni di sistema del computer in uso. Nota: in alcune impostazioni locali potrebbero essere usati altri caratteri come separatore della data.
E- E+ e+	Rappresenta il formato scientifico. Se l'espressione di formato contiene almeno un segnaposto di cifra (0 o #) a destra di E-, E+, e-o e+, il valore formattato verrà visualizzato in formato scientifico e tra il numero e l'esponente verrà inserito il carattere E o e. Il numero di segnaposti di cifra a destra determina il numero di cifre nell'esponente. Usare E- o e- per inserire un segno di sottrazione accanto agli esponenti negativi. Usare E+ o e+ per inserire un segno di sottrazione accanto agli esponenti negativi e un segno di addizione accanto agli esponenti positivi.
- + $ ( )	Visualizza un carattere letterale. Per visualizzare un carattere diverso da uno di quelli elencati, inserire una barra rovesciata () prima del carattere o racchiudere il carattere tra virgolette doppie (\" ).
\	Visualizza il carattere successivo nella stringa di formato. Per visualizzare un carattere dotato di significato speciale come carattere letterale, inserire una barra rovesciata (\) prima del carattere. La barra rovesciata non viene visualizzata. Utilizzare una barra rovesciata equivale a racchiudere il carattere successivo tra virgolette doppie. Per visualizzare una barra rovesciata, usare due barre rovesciate (\\). I caratteri che non possono essere visualizzati come caratteri letterali includono i seguenti: Caratteri di formattazione e ora di formattazione della data, a, c, d, h, m, n, p, q, s, t, w, y, /e : Caratteri di formattazione numerica,#0, %, E, e, virgola e punto Caratteri di formattazione@ delle stringhe, &, , <>e !
"ABC"	Visualizza la stringa all'interno delle virgolette doppie (" "). Per includere una stringa formattata dal codice, racchiudere il testo tra due Chr(34). 34è il codice carattere per la virgoletta doppia.

Formati numerici denominati

Nella tabella seguente sono indicati i nomi dei formati numerici predefiniti:

Nome del formato	Descrizione
General Number	Il numero viene visualizzato senza il separatore delle migliaia.
Currency	Il numero viene visualizzato con il separatore delle migliaia, quando necessario. Il numero viene visualizzato con cifre a destra del separatore decimale. L'output dipende dalle impostazioni locali del sistema.
Fixed	Il numero viene visualizzato con almeno una cifra a sinistra e due a destra del separatore decimale.
Standard	In numero viene visualizzato con il separatore delle migliaia e con almeno una cifra a sinistra e due a destra del separatore decimale.
Percent	Il numero viene visualizzato moltiplicato per 100 con un segno di percentuale (%) aggiunto a destra. Il numero viene sempre visualizzato con due cifre a destra del separatore decimale.
Scientific	Utilizza la notazione scientifica standard.
Yes/No	Viene visualizzato No se il numero è 0; in caso contrario, viene visualizzato Sì.
True/False	Viene visualizzato Falso se il numero è 0; in caso contrario, viene visualizzato Vero.
On/Off	Viene visualizzato Disattivato se il numero è 0; in caso contrario, viene visualizzato Attivato.

Valori di data

Nella tabella seguente sono indicati i caratteri che è possibile utilizzare nella stringa di formato per i formati di data e di ora.

Carattere	Descrizione
:	Rappresenta il separatore dell'ora che separa le ore, i minuti e i secondi nei valori di ora formattati. Il carattere effettivo utilizzato come separatore dell'ora nell'output formattato è determinato dalle impostazioni di sistema del computer in uso. Nota: in alcune impostazioni locali potrebbero essere usati altri caratteri come separatore dell'ora.
/	Rappresenta il separatore della data che separa il giorno, il mese e l'anno nei valori di data formattati. Il carattere effettivo utilizzato come separatore della data nell'output formattato è determinato dalle impostazioni di sistema del computer in uso. Nota: in alcune impostazioni locali potrebbero essere usati altri caratteri per rappresentare il separatore della data
C	Visualizza la data come ddddd e l'ora come ttttt, in questo ordine. Se il numero seriale della data non include una parte frazionaria, verranno visualizzate solo le informazioni della data. Se non esiste una parte intera, verranno visualizzate solo le informazioni dell'ora.
d	Visualizza il giorno come numero senza zero iniziale (1-31).
dd	Visualizza il giorno come numero con zero iniziale (01-31).
Ddd	Visualizza il giorno come abbreviazione (Sun-Sat).
dddd	Visualizza il giorno come nome completo (domenica-sabato).
ddddd	Visualizza la data completa, inclusi il giorno, il mese e l'anno, formattata in base all'impostazione del formato di data breve del sistema in uso. In Microsoft Windows il formato di data breve predefinito è g/m/aa.
dddddd	Visualizza un numero seriale di data sotto forma di una data completa, inclusi il giorno, il mese e l'anno, formattata in base all'impostazione del formato di data estesa riconosciuta dal computer in uso. In Windows il formato di data estesa predefinito è gg mmmm aaaa.
w	Visualizza il giorno della settimana sotto forma di numero (1 corrisponde al lunedì e 7 alla domenica).
Ww	Visualizza la settimana dell'anno come numero (1-54).
m	Visualizza il mese come numero senza zero iniziale (1-12). Se il segnaposto m è indicato immediatamente dopo h o hh, anziché il mese verrà visualizzato il minuto.
mm	Visualizza il mese come numero con zero iniziale (01-12). Se il segnaposto m è indicato immediatamente dopo h o hh, anziché il mese verrà visualizzato il minuto.
mmm	Visualizza il mese come abbreviazione (Jan-Dec).
mmmm	Visualizza il mese come nome completo del mese (gennaio-dicembre).
D	Visualizza il trimestre dell'anno come numero (1-4).
y	Visualizza il giorno dell'anno come numero (1-366).
yy	Visualizza l'anno come numero a due cifre (00-99).
yyyy	Visualizza l'anno come numero a quattro cifre (100-9999).
h	Visualizza l'ora come numero senza zeri iniziali (0-23).
hh	Visualizza l'ora come numero con zeri iniziali (00-23).
n	Visualizza il minuto come numero senza zeri iniziali (0-59).
nn	Visualizza il minuto come numero con zeri iniziali (00-59).
s	Visualizza il secondo come numero senza zeri iniziali (0-59).
ss	Visualizza il secondo come numero con zeri iniziali (00-59).
t t t t t	Visualizza l'ora completa, inclusi ora, minuti e secondi, formattata utilizzando il separatore dell'ora definito dal formato di ora riconosciuto dal computer in uso. Se è selezionata l'opzione relativa allo zero iniziale e l'ora è anteriore alle 10.00, verrà visualizzato uno zero iniziale. Ad esempio, 09.59. In Windows il formato di ora predefinito è h.mm.ss.
AM/PM	Visualizza i caratteri AM maiuscoli accanto a tutte le ore da mezzanotte a mezzogiorno e i caratteri PM maiuscoli accanto a tutte le ore da mezzogiorno a mezzanotte. Nota: usa il formato a 12 ore.
am/pm	Visualizza i caratteri am minuscoli accanto a tutte le ore da mezzanotte a mezzogiorno e i caratteri pm minuscoli accanto a tutte le ore da mezzogiorno a mezzanotte. Nota: usa il formato a 12 ore.
A/P	Visualizza il carattere A maiuscolo accanto a tutte le ore da mezzanotte a mezzogiorno e il carattere P maiuscolo accanto a tutte le ore da mezzogiorno a mezzanotte. Nota: usa il formato a 12 ore.
a/p	Visualizza il carattere a minuscolo accanto a tutte le ore da mezzanotte a mezzogiorno e il carattere p minuscolo accanto a tutte le ore da mezzogiorno a mezzanotte. Nota: usa il formato a 12 ore.
AMPM	Visualizza la stringa letterale AM in base a quanto specificato dal computer in uso accanto a tutte le ore da mezzanotte e mezzogiorno e la stringa letterale PM in base a quanto specificato dal computer in uso accanto a tutte le ore da mezzogiorno a mezzanotte. AMPM può essere formattato in maiuscolo o in minuscolo, ma la formattazione della stringa effettivamente visualizzata corrisponde alla stringa definita dalle impostazioni di sistema del computer. In Windows viene usato il formato AM/PMper impostazione predefinita. Nota: usa il formato a 12 ore.

Formati di data denominati

Nella tabella seguente sono indicati i nomi dei formati di data e ora predefiniti:

Nome del formato	Descrizione
General Date	Vengono visualizzate una data e/o un'ora. Per i numeri reali, vengono visualizzate una data e ora, ad esempio, 4/3/93 17:34. Se non vi è parte frazionaria, viene visualizzata solo la data, ad esempio, 4/3/93. Se non vi è parte intera, viene visualizzata solo l'ora, ad esempio, 17:35. Il formato della visualizzazione relativa alla data è determinato dalle impostazioni del sistema.
Long Date	Viene visualizzata la data in base al formato di data esteso del sistema.
Medium Date	Viene visualizzata una data utilizzando il formato d data medio appropriato alla versione di lingua dell'applicazione host.
Short Date	Viene visualizzata la data in base al formato di data breve del sistema.
Long Time	Viene visualizzata l'ora in base al formato di data esteso del sistema; in genere comprende ore, minuti e secondi.
Medium Time	Viene visualizzata l'ora nel formato a 12 ore utilizzando ore e minuti e l'identificatore AM/PM.
Short Time	Viene visualizzata l'ora utilizzando il formato a 24 ore, ad esempio, 17:45.

Vedere anche

LANGUAGE e FORMAT_STRING in FORMATTED_VALUE
Utilizzo delle proprietà delle celle (MDX)
Creazione e utilizzo di valori di proprietà (MDX)
Nozioni fondamentali sulle query MDX (Analysis Services)