MDX – Zelleigenschaften: FORMAT_STRING-Inhalte

Artikel
05/08/2023

Gilt für: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Die FORMAT_STRING -Zelleigenschaft formatiert die VALUE -Zelleigenschaft, indem sie den Wert für die FORMATTED_VALUE -Zelleigenschaft erstellt. Die FORMAT_STRING -Zelleigenschaft behandelt sowohl Zeichenfolgenwerte als auch numerische Rohdaten, indem sie einen Formatausdruck auf den Wert anwendet, um einen formatierten Wert für die FORMATTED_VALUE -Zelleigenschaft zurückzugeben. Die folgenden Tabellen geben die Syntax und die Formatierungszeichen detailliert an, mit denen Zeichenfolgenwerte und numerische Werte behandelt werden.

Zeichenfolgenwerte

Ein Formatausdruck für Zeichenfolgen kann aus einem Abschnitt oder aus zwei durch ein Semikolon (;) getrennten Abschnitten bestehen.

Verbrauch	Ergebnis
Ein Abschnitt	Das Format gilt für alle Zeichenfolgenwerte.
Zwei Abschnitte	Der erste Abschnitt gilt für Zeichenfolgendaten, der zweite Abschnitt für NULL-Werte und leere Zeichenfolgen ("").

Die in der folgenden Tabelle beschriebenen Zeichen können in der Formatzeichenfolge für Zeichenfolgen verwendet werden.

Zeichen	BESCHREIBUNG
@	Entspricht einem Zeichenplatzhalter, der ein Zeichen oder ein Leerzeichen anzeigt. Steht in der Zeichenfolge ein Zeichen an der Position, an der die Formatzeichenfolge ein @-Zeichen enthält, zeigt die formatierte Zeichenfolge das Zeichen an. Andernfalls zeigt die formatierte Zeichenfolge an dieser Position ein Leerzeichen an. Platzhalter werden von rechts nach links aufgefüllt, es sei denn, die Formatzeichenfolge enthält ein Ausrufezeichen (!).
&	Entspricht einem Zeichenplatzhalter, der ein Zeichen oder nichts anzeigt. Wenn die Zeichenfolge ein Zeichen an der Position des kaufmännischen Und-Zeichens (&) enthält, wird das Zeichen von der formatierten Zeichenfolge angezeigt. Andernfalls zeigt die formatierte Zeichenfolge nichts an. Platzhalter werden von rechts nach links aufgefüllt, es sei denn, die Formatzeichenfolge enthält ein Ausrufezeichen (!).
<	Erzwingt Kleinbuchstaben. Die formatierte Zeichenfolge zeigt alle Zeichen als Kleinbuchstaben an.
>	Erzwingt Großbuchstaben. Die formatierte Zeichenfolge zeigt alle Zeichen als Großbuchstaben an.
!	Erzwingt das Auffüllen von Platzhaltern von links nach rechts. (Standardmäßig werden Platzhalter von rechts nach links aufgefüllt.)

Numerische Werte

Ein benutzerdefinierter Formatausdruck für Zahlen kann ein bis vier Abschnitte enthalten, die durch ein Semikolon (;) getrennt sind. Falls das Formatargument eines der benannten numerischen Formate enthält, ist nur ein Abschnitt zulässig.

Verbrauch	Ergebnis
Ein Abschnitt	Der Formatausdruck gilt für alle Werte.
Zwei Abschnitte	Der erste Abschnitt gilt für positive Werte und Nullen, der zweite Abschnitt gilt für negative Werte.
Drei Abschnitte	Der erste Abschnitt gilt für positive Werte, der zweite Abschnitt für negative Werte und der dritte Abschnitt für Nullen.
Vier Abschnitte	Der erste Abschnitt gilt für positive Werte, der zweite Abschnitt für negative Werte, der dritte Abschnitt für Nullen und der vierte Abschnitt für NULL-Werte.

Das folgende Beispiel hat zwei Abschnitte. Der erste Abschnitt definiert das Format für positive Werte und Nullen, und der zweite Abschnitt definiert das Format für negative Werte.

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

Wenn Sie zwei Semikolons ohne etwas dazwischen einfügen, wird der fehlende Abschnitt entsprechend dem Format des positiven Wertes ausgegeben. Das folgende Format zeigt positive und negative Werte mit dem Format im ersten Abschnitt an und zeigt "Zero" an, wenn der Wert null ist:

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

In der folgenden Tabelle sind die Zeichen aufgeführt, die in der Formatzeichenfolge für numerische Formate enthalten sein können.

Zeichen	BESCHREIBUNG
Keine	Zeigt die Zahl ohne jegliche Formatierung an.
0	Entspricht einem Ziffernplatzhalter, der eine Ziffer oder eine Null (0) anzeigt. Wenn die Zahl an der Stelle, an der in der Formatzeichenfolge die Null vorkommt, eine Ziffer enthält, zeigt der formatierte Wert die Ziffer an. Andernfalls zeigt der formatierte Wert an dieser Position eine Null an. Hat die Zahl weniger Ziffern als der Formatausdruck Nullen (auf beiden Seiten des Dezimaltrennzeichens), zeigt der formatierte Wert führende oder nachfolgende Nullen an. Hat die Zahl rechts vom Dezimaltrennzeichen mehr Ziffern, als im Formatausdruck rechts vom Dezimaltrennzeichen Nullen vorkommen, wird der formatierte Wert auf so viele Dezimalstellen gerundet, wie Nullen vorhanden sind. Hat die Zahl links vom Dezimaltrennzeichen mehr Ziffern, als im Formatausdruck links vom Dezimaltrennzeichen Nullen vorkommen, werden die zusätzlichen Ziffern im formatierten Wert unverändert angezeigt.
#	Entspricht einem Ziffernplatzhalter, der eine Ziffer oder nichts anzeigt. Hat der Ausdruck eine Ziffer an der Stelle, an der in der Formatzeichenfolge das Nummernzeichen (#) vorkommt, zeigt der formatierte Wert die Ziffer an. Andernfalls zeigt der formatierte Wert an dieser Position nichts an. Der Platzhalter Nummernzeichen (#) führt zum gleichen Ergebnis wie der Ziffernplatzhalter null (0), mit dem einzigen Unterschied, dass keine führenden und nachfolgenden Nullen angezeigt werden, wenn die Zahl ebenso viele oder weniger Ziffern hat, wie # -Zeichen in der Formatzeichenfolge auf beiden Seiten des Dezimaltrennzeichens vorhanden sind.
.	Entspricht einem Dezimaltrennzeichen, das festlegt, wie viele Ziffern links und rechts vom Dezimaltrennzeichen angezeigt werden. Wenn der Formatausdruck links vom Punkt (#.) nur Nummernzeichen () enthält, beginnen Zahlen, die kleiner sind als 1, mit dem Dezimaltrennzeichen. Sollen Bruchzahlen mit einer führenden Null angezeigt werden, verwenden Sie 0 als ersten Ziffernplatzhalter links vom Dezimaltrennzeichen. Welches Zeichen tatsächlich als Dezimaltrennzeichen in der formatierten Ausgabe verwendet wird, hängt von dem Zahlenformat ab, das vom Computersystem erkannt wird. Hinweis: In manchen Gebietsschemas wird ein Komma als Dezimaltrennzeichen verwendet.
%	Entspricht einem Prozentwertplatzhalter. Der Ausdruck wird mit 100 multipliziert. Das Prozentzeichen (%) wird an der Position eingefügt, an der der Prozentsatz in der Formatzeichenfolge angezeigt wird.
,	Entspricht einem Tausendertrennzeichen, das in einer Zahl, die vier oder mehr Stellen links vom Dezimaltrennzeichen hat, die Tausender von den Hundertern trennt. Die standardmäßige Verwendung des Tausendertrennzeichens wird angegeben, wenn das Format ein Tausendertrennzeichen enthält, das in Ziffernplatzhaltern (0 oder #) eingeschlossen ist. Zwei benachbarte Tausendertrennzeichen oder ein Tausendertrennzeichen direkt links vom Dezimaltrennzeichen (unabhängig davon, ob ein Dezimaltrennzeichen angegeben ist oder nicht), bedeutet "die Zahl skalieren, indem sie die Zahl durch 1000 dividiert, nach Bedarf rundet". Sie können beispielsweise die Formatzeichenfolge "##0," verwenden, um 100 Millionen als 100 darzustellen. Zahlen, die kleiner als 1 Million sind, werden als 0 angezeigt. Zwei benachbarte Tausendertrennzeichen in jeder anderen Position als direkt links vom Dezimaltrennzeichen werden so behandelt, als würden sie die Verwendung eines Tausendertrennzeichens angeben. Welches Zeichen tatsächlich als Tausendertrennzeichen in der formatierten Ausgabe verwendet wird, hängt von dem Zahlenformat ab, das vom Computersystem erkannt wird. Hinweis: In manchen Gebietsschemas wird der Punkt als Tausendertrennzeichen verwendet.
:	Entspricht einem Zeittrennzeichen, das Stunden, Minuten und Sekunden trennt, wenn Zeitwerte formatiert werden. Hinweis: In manchen Gebietsschemas werden unter Umständen andere Zeichen als Zeittrennzeichen verwendet. Welches Zeichen tatsächlich als Zeittrennzeichen in der formatierten Ausgabe verwendet wird, hängt von den Systemeinstellungen des Computers ab.
/	Entspricht einem Datumstrennzeichen, das den Tag, den Monat und das Jahr trennt, wenn Datumswerte formatiert werden. Welches Zeichen tatsächlich als Datumstrennzeichen in der formatierten Ausgabe verwendet wird, hängt von den Systemeinstellungen des Computers ab. Hinweis: In manchen Gebietsschemas werden unter Umständen andere Zeichen als Datumstrennzeichen verwendet.
E- E+ e- e+	Entspricht dem wissenschaftlichen Format. Wenn der Formatausdruck mindestens einen Ziffernplatzhalter (0 oder #) rechts von E-, E+, e-oder e+enthält, wird der formatierte Wert im wissenschaftlichen Format angezeigt, und E oder e wird zwischen der Zahl und dem Exponenten der Zahl eingefügt. Die Anzahl der Ziffernplatzhalter auf der rechten Seite bestimmt die Anzahl der Ziffern im Exponenten. Verwenden Sie E- oder e- , um vor negativen Exponenten ein Minuszeichen einzufügen. Verwenden Sie E+ oder e+ , um vor negativen Exponenten ein Minuszeichen und vor positiven Exponenten ein Pluszeichen einzufügen.
- + $ ( )	Zeigt ein Literalzeichen an. Um ein anderes Zeichen als eines der aufgeführten anzuzeigen, setzen Sie einen umgekehrten Schrägstrich (\) vor das Zeichen, oder schließen Sie das Zeichen in doppelte Anführungszeichen (" ") ein.
\	Zeigt das nächste Zeichen in der Formatzeichenfolge an. Soll ein Zeichen, das eine spezielle Bedeutung hat, als Literalzeichen angezeigt werden, setzen Sie einen umgekehrten Schrägstrich (\) vor das Zeichen. Der umgekehrte Schrägstrich wird nicht angezeigt. Das Verwenden des umgekehrten Schrägstrichs ist gleichbedeutend mit dem Einschließen des nächsten Zeichens in doppelte Anführungszeichen. Um einen umgekehrten Schrägstrich anzuzeigen, verwenden Sie zwei umgekehrte Schrägstriche (\\). Folgende Zeichen gehören zu den Zeichen, die nicht als Literalzeichen angezeigt werden können: Die Datums- und Zeitformatierungszeichen-a, c, d, h, m, n, p, q, s, t, w, y, /und : Die numerischen Formatierungszeichen-#, 0, %, E, e, Komma und Punkt Die Zeichenfolgenformatierungszeichen,@&, <, >und !
"ABC"	Zeigt die Zeichenfolge in den doppelten Anführungszeichen (" ") an. Um aus Code heraus eine Zeichenfolge in ein Format einzuschließen, schließen Sie den Text mithilfe von Chr(34) ein. (Der Zeichencode für ein doppeltes Anführungszeichen ist 34.)

Benannte numerische Formate

Die folgende Tabelle enthält eine Übersicht über die vordefinierten numerischen Formate:

Formatname	BESCHREIBUNG
`General Number`	Zeigt die Zahl ohne Tausendertrennzeichen an.
`Currency`	Zeigt ggf. die Zahl mit einem Tausendertrennzeichen an. Zeigt zwei Ziffern rechts vom Dezimaltrennzeichen an. Die Ausgabe hängt vom verwendeten Systemgebietsschema ab.
`Fixed`	Zeigt mindestens eine Ziffer links und zwei Ziffern rechts vom Dezimaltrennzeichen an.
`Standard`	Zeigt die Zahl mit Tausendertrennzeichen und mindestens einer Ziffer links sowie zwei Ziffern rechts vom Dezimaltrennzeichen an.
`Percent`	Zeigt die mit 100 multiplizierte Zahl mit einem rechts anschließenden Prozentzeichen (%) an. Zeigt immer zwei Ziffern rechts vom Dezimaltrennzeichen an.
`Scientific`	Verwendet standardmäßige wissenschaftliche Notation.
`Yes/No`	Zeigt No an, wenn die Zahl 0 lautet. Andernfalls wird Yes angezeigt.
`True/False`	Zeigt False an, wenn die Zahl 0 lautet. Andernfalls wird True angezeigt.
`On/Off`	Zeigt Off an, wenn die Zahl 0 lautet. Andernfalls wird On angezeigt.

Datumswerte

Die folgende Tabelle identifiziert die Zeichen, die in der Formatzeichenfolge für Datums-/Zeitformate verwendet werden können.

Zeichen	BESCHREIBUNG
:	Entspricht einem Zeittrennzeichen, das Stunden, Minuten und Sekunden trennt, wenn Zeitwerte formatiert werden. Welches Zeichen tatsächlich als Zeittrennzeichen in der formatierten Ausgabe verwendet wird, hängt von den Systemeinstellungen des Computers ab. Hinweis: In manchen Gebietsschemas werden unter Umständen andere Zeichen als Zeittrennzeichen verwendet.
/	Entspricht einem Datumstrennzeichen, das den Tag, den Monat und das Jahr trennt, wenn Datumswerte formatiert werden. Welches Zeichen tatsächlich als Datumstrennzeichen in der formatierten Ausgabe verwendet wird, hängt von den Systemeinstellungen des Computers ab. Hinweis: In einigen Gebietsschemas werden unter Umständen andere Zeichen als Datumstrennzeichen verwendet.
C	Zeigt das Datum als ddddd und die Zeit als tttttan, in dieser Reihenfolge. Zeigt nur Datumsinformationen an, wenn die Datumsseriennummer keine Nachkommastellen enthält. Zeigt nur Zeitinformationen an, wenn kein ganzzahliger Teil vorhanden ist.
d	Zeigt den Tag als Zahl ohne führende Null (1-31) an.
dd	Zeigt den Tag als Zahl mit einer führenden Null (01-31) an.
Ddd	Zeigt den Tag als Abkürzung an (So-Sa).
Dddd	Zeigt den Tag als vollständigen Namen (Sonntag-Samstag) an.
ddddd	Zeigt das Datum als vollständiges Datum (einschließlich Tag, Monat und Jahr) an, formatiert entsprechend der Systemeinstellung für das kurze Datumsformat. In Microsoft Windows lautet das standardmäßige kurze Datumsformat dd.mm.yy.
dddddd	Zeigt eine Datumsseriennummer als vollständiges Datum (einschließlich Tag, Monat und Jahr) an, das entsprechend dem langen Datumsformat formatiert ist, auf das das Computersystem festgelegt ist. In Windows ist das standardmäßige lange Datumsformat dddd, d. mmmm yyyy.
w	Zeigt den Wochentag als Zahl an (1 für Sonntag bis 7 für Samstag).
ww	Zeigt die Woche des Jahres als Zahl (1-54) an.
m	Zeigt den Monat als Zahl ohne führende Null (1-12) an. Wenn m direkt auf h oder hhfolgt, wird nicht der Monat, sondern die Minute angezeigt.
mm	Zeigt den Monat als Zahl mit einer führenden Null (01-12) an. Wenn m direkt auf h oder hhfolgt, wird nicht der Monat, sondern die Minute angezeigt.
mmm	Zeigt den Monat als Abkürzung (Jan-Dez) an.
mmmm	Zeigt den Monat als vollständigen Monatsnamen (Januar-Dezember) an.
Q	Zeigt das Quartal des Jahres als Zahl (1-4) an.
y	Zeigt den Tag des Jahres als Zahl (1-366) an.
yy	Zeigt das Jahr als zweistellige Zahl (00-99) an.
yyyy	Zeigt das Jahr als vierstellige Zahl (100-9999) an.
h	Zeigt die Stunde als Zahl ohne führende Nullen (0-23) an.
hh	Zeigt die Stunde als Zahl mit führenden Nullen (00-23) an.
n	Zeigt die Minute als Zahl ohne führende Nullen (0-59) an.
nn	Zeigt die Minute als Zahl mit führenden Nullen (00-59) an.
s	Zeigt die zweite Als Zahl ohne führende Nullen (0-59) an.
ss	Zeigt die zweite Als Zahl mit führenden Nullen (00-59) an.
t t t t t	Zeigt eine Zeit als vollständige Zeit (einschließlich Stunde, Minute und Sekunde) an, wobei die Zeit mit dem Zeittrennzeichen formatiert ist, das durch das Zeitformat definiert ist, das vom Computersystem erkannt wird. Eine führende Null wird angezeigt, wenn die entsprechende Option ausgewählt und die Uhrzeit früher als 10:00 Uhr (z. B. 09:59) ist. Dies gilt im 12-Stunden-Format für A.M. und P.M. Das Standardzeitformat in Windows ist hh:mm:ss.
AM/PM	Zeigt die Großbuchstaben AM hinter jeder Stunde ab Mitternacht bis Mittag und die Großbuchstaben PM hinter jeder Stunde ab Mittag bis Mitternacht an. Hinweis: Verwendet ein 12-Stunden-Format.
AM/PM	Zeigt die Kleinbuchstaben am hinter jeder Stunde ab Mitternacht bis Mittag und die Kleinbuchstaben pm hinter jeder Stunde ab Mittag bis Mitternacht an. Hinweis: Verwendet ein 12-Stunden-Format.
A/P	Zeigt den Großbuchstaben A hinter jeder Stunde ab Mitternacht bis Mittag und den Großbuchstaben P hinter jeder Stunde ab Mittag bis Mitternacht an. Hinweis: Verwendet ein 12-Stunden-Format.
a/p	Zeigt den Kleinbuchstaben a hinter jeder Stunde ab Mitternacht bis Mittag und den Kleinbuchstaben p hinter jeder Stunde ab Mittag bis Mitternacht an. Hinweis: Verwendet ein 12-Stunden-Format.
AMPM	Zeigt entsprechend den Einstellungen des Computersystems das Zeichenfolgenliteral für vormittags (AM) hinter jeder Stunde ab Mitternacht bis Mittag und das Zeichenfolgenliteral für nachmittags (PM) hinter jeder Stunde ab Mittag bis Mitternacht an. AMPM kann in Großbuchstaben oder in Kleinbuchstaben angegeben sein, während die Groß-/Kleinschreibung der angezeigten Zeichenfolge mit der Definition der Zeichenfolge in den Systemeinstellungen des Computers übereinstimmt. Das Standardformat in Windows ist AM/PM. Hinweis: Verwendet ein 12-Stunden-Format.

Benannte Datumsformate

Die folgende Tabelle enthält eine Übersicht über die vordefinierten Datums- und Zeitformate:

Formatname	BESCHREIBUNG
`General Date`	Zeigt ein Datum und/oder eine Uhrzeit an. Zeigt für reelle Zahlen ein Datum und eine Uhrzeit an (z. B. 4/3/93 05:34 PM). Wenn es keinen Bruchteil gibt, wird nur ein Datum angezeigt (z. B. 4/3/93). Wenn es keinen ganzzahligen Teil gibt, wird nur eine Zeit angezeigt (z. B. 05:34 PM). Das Format der Datumsanzeige wird von den Systemeinstellungen bestimmt.
`Long Date`	Zeigt ein Datum entsprechend dem langen Datumsformat Ihres Systems an.
`Medium Date`	Zeigt ein Datum an, das dem mittleren Datumsformat für die Sprachversion der Hostanwendung entspricht.
`Short Date`	Zeigt ein Datum entsprechend dem kurzen Datumsformat Ihres Systems an.
`Long Time`	Zeigt eine Uhrzeit entsprechend dem langen Zeitformat Ihres Systems an. Dabei werden Stunden, Minuten und Sekunden angezeigt.
`Medium Time`	Zeigt eine Uhrzeit im 12-Stunden-Format mit Stunden und Minuten sowie AM/PM-Unterscheidung an.
`Short Time`	Zeigt eine Uhrzeit im 24-Stunden-Format an (z. B. 17:45).

Weitere Informationen

SPRACHE und FORMAT_STRING auf FORMATTED_VALUE
Verwenden von Zelleigenschaften (MDX)
Erstellen und Verwenden von Eigenschaftswerten (MDX)
Grundlegendes zu MDX-Abfragen (Analysis Services)