Contenuto FORMAT_STRING (MDX)

La FORMAT_STRING proprietà cell formatta la VALUE proprietà cell, creando il valore per la FORMATTED_VALUE proprietà cell. La FORMAT_STRING proprietà cell gestisce valori stringa e numerici non elaborati, applicando un'espressione di formato al valore per restituire un valore formattato per la FORMATTED_VALUE proprietà cell. Le tabelle seguenti illustrano in dettaglio la sintassi e la formattazione dei caratteri usati per gestire valori stringa e numerici.

Valori di stringa

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

Uso	Risultato
Una sezione	Il formato si applica a tutti i valori stringa.
Due sezioni	La prima sezione si applica ai dati stringa, mentre la seconda sezione si applica ai valori Null e alle stringhe di lunghezza zero ("").

I caratteri descritti nella tabella seguente possono essere visualizzati nella stringa di formato per le stringhe di caratteri.

Personaggio	Descrizione
@	Rappresenta un segnaposto di carattere che visualizza un carattere o uno spazio. Se la stringa contiene un carattere nella posizione in cui appare la chiocciola (@) nella stringa di formato, la stringa formattata visualizza il carattere. In caso contrario, la stringa formattata visualizza uno spazio in tale posizione. I segnaposto vengono riempiti da destra a sinistra, a meno che non sia presente un punto esclamativo (!) nella stringa di formato.
&	Rappresenta un segnaposto di carattere che visualizza un carattere o nulla. Se la stringa ha un carattere nella posizione in cui appare il simbolo &, la stringa formattata visualizza il carattere. In caso contrario, la stringa formattata non visualizza nulla. I segnaposto vengono riempiti da destra a sinistra, a meno che non sia presente un punto esclamativo (!) nella stringa di formato.
<	Forza l'utilizzo di lettere minuscole. La stringa formattata visualizza tutti i caratteri in formato minuscolo.
>	Forza maiuscole. La stringa formattata visualizza tutti i caratteri in formato maiuscolo.
!	Forza il riempimento dei segnaposto da sinistra a destra. L'impostazione predefinita consiste nel riempire i segnaposto da destra a sinistra.

Valori numerici

Un'espressione di formato definita dall'utente per i numeri può avere da una a quattro sezioni separate da punto e virgola. Se l'argomento format contiene uno dei formati numerici denominati, è consentita una sola sezione.

Uso	Risultato
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.
Quattro sezioni	La prima sezione si applica ai valori positivi, il secondo ai valori negativi, il terzo agli zeri e il quarto ai valori Null.

Nell'esempio seguente sono presenti due sezioni. La prima sezione definisce il formato per valori positivi e zeri e la seconda sezione definisce il formato per i valori negativi.

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

Se si includono punti e virgola senza nulla tra di essi, la sezione mancante verrà stampata secondo 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;;\Z\e\r\o"  

La tabella seguente identifica i caratteri che possono essere visualizzati nella stringa di formato per i formati numerici.

Personaggio	Descrizione
Nessuno	Visualizza il numero senza formattazione.
0	Rappresenta un segnaposto di cifra che visualizza una cifra o uno zero (0). Se il numero ha una cifra nella posizione in cui viene visualizzato lo zero nella stringa di formato, il valore formattato visualizza la cifra. In caso contrario, il valore formattato visualizza uno zero in tale posizione. Se il numero contiene meno cifre rispetto agli zeri (su entrambi i lati del decimale) nella stringa di formato, il valore formattato visualizza zeri iniziali o finali. Se il numero ha più cifre a destra del separatore decimale rispetto agli zeri presenti a destra del separatore decimale nell'espressione di formato, il valore formattato arrotonda il numero al numero di cifre decimali corrispondente agli zeri. Se il numero ha più cifre a sinistra del separatore decimale rispetto a zero a sinistra del separatore decimale nell'espressione di formato, il valore formattato visualizza le cifre aggiuntive senza alcuna modifica.
#	Rappresenta un segnaposto per cifre che mostra una cifra o nessuna. Se l'espressione ha una cifra nella posizione in cui viene visualizzato il segno di numero (#) nella stringa di formato, il valore formattato visualizza la cifra. In caso contrario, il valore formattato non visualizza nulla in tale posizione. Il segnaposto del segno di numero (#) funziona come il segnaposto zero (0), 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.
.	Rappresenta un segnaposto decimale che determina il numero di cifre visualizzate a sinistra e a destra del separatore decimale. Se l'espressione di formato contiene solo caratteri di segno di numero (#) a sinistra del punto (.), i numeri inferiori a 1 iniziano con un separatore decimale. Per visualizzare uno zero iniziale visualizzato con numeri frazionari, usare zero (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 informatico. Nota: in alcune impostazioni locali viene usata una virgola come separatore decimale.
%	Rappresenta un segnaposto percentuale. L'espressione viene moltiplicata per 100. Il carattere percentuale (%) viene inserito nella posizione in cui viene visualizzata la percentuale nella stringa di formato.
,	Rappresenta un separatore di migliaia che 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 contenga un separatore di migliaia racchiuso tra segnaposti per le 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 il numero 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 quella immediatamente a sinistra del separatore decimale vengono considerati come indicazione dell'uso del separatore delle migliaia. Il carattere effettivo utilizzato come separatore delle migliaia nell'output formattato dipende dal formato numerico riconosciuto dal sistema del computer. Nota: in alcune località si usa un punto come separatore delle migliaia.
:	Rappresenta un separatore di tempo che separa ore, minuti e secondi quando i valori di ora vengono formattati. Nota: in alcune impostazioni locali è possibile usare altri caratteri come separatore temporale. Il carattere effettivo utilizzato come separatore temporale nell'output formattato è determinato dalle impostazioni di sistema nel computer.
/	Rappresenta un separatore di data che separa il giorno, il mese e l'anno in cui i valori di data vengono formattati. Il carattere effettivo utilizzato come separatore di data nell'output formattato è determinato dalle impostazioni di sistema nel computer. Nota: in alcune impostazioni locali è possibile usare altri caratteri come separatore di data.
E- 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-oe+, il valore formattato viene visualizzato in formato scientifico e E o e viene inserito tra il numero e l'esponente del numero. Il numero di segnaposto di cifra a destra determina il numero di cifre nell'esponente. Usare E- o e- per includere un segno meno accanto a esponenti negativi. Usare E+ o e+ per includere un segno meno accanto a esponenti negativi e un segno più accanto a 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 con un significato speciale come carattere letterale, inserire una barra rovesciata (\) prima del carattere. 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 includono i caratteri seguenti: Caratteri di formattazione data e ora: 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 in formato dall'interno del codice, usare Chr(34) per racchiudere il testo. Il codice carattere per le virgolette doppie è 34.

Formati numerici denominati

La tabella seguente identifica i nomi di formato numerico predefiniti:

Nome formato	Descrizione
General Number	Visualizza il numero senza alcun separatore di migliaia.
Currency	Visualizza il numero con un separatore 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 separatore 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 (%) aggiunto a destra. Visualizza sempre due cifre a destra del separatore decimale.
Scientific	Usa la notazione scientifica standard.
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ì.

Valori delle date

La tabella seguente identifica i caratteri che possono essere visualizzati nella stringa di formato per i formati di data/ora.

Personaggio	Descrizione
:	Rappresenta un separatore di tempo che separa ore, minuti e secondi quando i valori di ora vengono formattati. Il carattere effettivo utilizzato come separatore temporale nell'output formattato è determinato dalle impostazioni di sistema del computer. Nota: in alcune impostazioni locali è possibile usare altri caratteri come separatore temporale.
/	Rappresenta un separatore di data che separa il giorno, il mese e l'anno in cui i valori di data vengono formattati. Il carattere effettivo utilizzato come separatore di data nell'output formattato è determinato dalle impostazioni di sistema del computer. Nota: in alcune impostazioni locali è possibile usare altri caratteri per rappresentare il separatore di data
C	Visualizza la data come ddddd e visualizza l'ora come ttttt, in tale ordine. Visualizza solo le informazioni sulla data se il numero seriale della data non ha una parte frazionaria. Visualizza solo le informazioni sull'ora se non è presente alcuna parte integer.
d	Visualizza il giorno come numero senza zero iniziale (1-31).
gg	Visualizza il giorno come numero con zero iniziale (01-31).
Ddd	Visualizza il giorno come abbreviazione (Sun-Sat).
ddd	Visualizza il giorno come nome completo (Sunday-Saturday).
ddddd	Visualizza la data come data completa (inclusi giorno, mese e anno), formattata in base all'impostazione del formato di data breve del sistema. Per Microsoft Windows, il formato di data breve predefinito è m/d/yy.
dddddd	Visualizza un numero di serie di data come data completa (incluso giorno, mese e anno), formattato in base all'impostazione di data estesa riconosciuta dal sistema del computer. Per Windows, il formato di data lunga predefinito è mmmm gg, aaaaa.
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.
millimetro	Visualizza il mese come numero con zero iniziale (01-12). Se m segue immediatamente h o hh, viene visualizzato il minuto anziché il mese.
Mmm	Visualizza il mese come abbreviazione (Jan-Dec).
Mmmm	Visualizza il mese come nome completo (January-December).
q	Visualizza il trimestre dell'anno come numero (1-4).
e	Visualizza il giorno dell'anno come numero (1-366).
aa ...	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 t	Visualizza un'ora come ora completa (inclusi ora, minuto e secondo), formattata usando il separatore di tempo definito dal formato ora riconosciuto dal sistema del computer. Se è selezionata l'opzione zero iniziale, viene visualizzato uno zero iniziale se l'ora è precedente alle 10:00 sia di mattina che di pomeriggio. Ad esempio, 09:59, Per Windows, il formato ora predefinito è h:mm:ss.
AM/PM	Visualizza un am maiuscolo con qualsiasi ora da mezzanotte a mezzogiorno; visualizza un PM maiuscolo con qualsiasi ora da mezzogiorno a mezzanotte. Nota: usa l'orologio di 12 ore.
am/pm	Visualizza un am minuscolo con qualsiasi ora da mezzanotte a mezzogiorno; visualizza un pm minuscolo con qualsiasi ora da mezzogiorno a mezzanotte. Nota: usa l'orologio di 12 ore.
A/P	Visualizza un carattere A maiuscolo con qualsiasi ora da mezzanotte a mezzogiorno; visualizza un P maiuscolo con qualsiasi ora da mezzogiorno a mezzanotte. Nota: usa l'orologio di 12 ore.
a/p	Visualizza una a minuscola con qualsiasi ora da mezzanotte a mezzogiorno; visualizza una p minuscola con qualsiasi ora da mezzogiorno a mezzanotte. Nota: usa l'orologio di 12 ore.
AMPM	Visualizza il valore letterale stringa AM come definito dal sistema informatico con qualsiasi ora da mezzanotte a mezzogiorno; visualizza il valore letterale stringa PM come definito dal sistema del computer con qualsiasi ora da mezzogiorno a mezzanotte. Nota: usa l'orologio di 12 ore. AMPM può essere maiuscolo o minuscolo, ma il caso della stringa visualizzata corrisponde alla stringa definita dalle impostazioni di sistema del computer. Per Windows, il formato predefinito è AM/PM.

Formati di data denominati

La tabella seguente identifica i nomi di formato di data e ora predefiniti:

Nome formato	Descrizione
General Date	Visualizza una data e/o un'ora. Per i numeri reali, visualizza una data e un'ora, ad esempio 4/3/93 05:34 PM. Se non è presente alcuna parte frazionaria, visualizza solo una data, ad esempio 4/3/93. Se non è presente alcuna parte integer, visualizza un'ora solo, ad esempio 05:34 PM. Il formato della visualizzazione della data è determinato dalle impostazioni di sistema.
Long Date	Visualizza una data in base al formato di data estesa del sistema.
Medium Date	Visualizza una data usando il formato di data medio appropriato per la versione della lingua dell'applicazione host.
Short Date	Visualizza una data usando il formato di data breve del sistema.
Long Time	Visualizza un periodo di tempo usando il formato a lungo termine del sistema; include ore, minuti e secondi.
Medium Time	Visualizza un'ora nel formato di 12 ore usando ore e minuti e l'identificatore AM/PM.
Short Time	Visualizza un'ora usando il formato di 24 ore, ad esempio 17:45.

Vedere anche

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