FORMAT
Gilt für:
Berechnete Spalteberechnete TabelleMeasurevisuelle Berechnung
Wandelt eine value gemäß der angegebenen formatin Text um.
Syntax
FORMAT(<value>, <format_string>[, <locale_name>])
Parameter
| Ausdruck | Definition |
|---|---|
value |
Ein valueor Ausdruck, der zu einem einzelnen valueausgewertet wird. |
format_string |
Eine Zeichenfolge mit der Formatierungsvorlage. |
locale_name |
(Optional) Der Name des Gebietsschemas, das von der Funktion verwendet werden soll. Mögliche values sind Zeichenfolgen, die von der Windows-API-Funktion LocaleNameToLCID()akzeptiert werden. |
value zurückgeben
Eine Zeichenfolge, die value gemäß der Definition durch format_stringformatiert ist.
Anmerkung
If
value ist BLANK, gibt die Funktion eine leere Zeichenfolge zurück.
If
format_string ist BLANK, wird die value mit einer "General Number" or "General Date" format (gemäß value Datentyp) formatiert.
Bemerkungen
Vordefinierte format Zeichenfolgen verwenden die Modellkultureigenschaft beim Formatieren des Ergebnisses. Standardmäßig wird die Modellkultureigenschaft gemäß dem Benutzergebietsschema des Computers festgelegt. Bei neuen Power BI-Desktopmodellen kann die Modellkultureigenschaft in den Optionen > regionalen Einstellungen > Modellsprache geändert werden. Für Analysis Services wird die Modellkultur gemäß der von der Instanz anfänglich definierten Language-Eigenschaft festgelegt.
Die format Zeichenfolgen, die als Argument für die DAXFORMAT-Funktion unterstützt werden, basieren auf den format Zeichenfolgen, die von Visual Basic (OLE-Automatisierung) verwendet werden, not auf den format Zeichenfolgen, die von .NET Framework verwendet werden. Daher erhalten Sie möglicherweise unerwartete Ergebnisse, or ein errorif das Argument nicht mit definierten format Zeichenfolgen übereinstimmt. Beispielsweise wird "p" als Abkürzung für "Percent" nicht unterstützt. Zeichenfolgen, die Sie als Argument für die FORMAT-Funktion bereitstellen, die nicht in der Liste vordefinierter format Zeichenfolgen enthalten sind, werden als Teil einer benutzerdefinierten format Zeichenfolge or als Zeichenfolgenliteral behandelt.
Weitere Informationen zum Angeben eines Gebietsschemas mit FORMATfinden Sie in diesem Video.
Die Verwendung FORMAT ändert ein measure Ergebnis in einen Textdatentyp. If das measure Ergebnis ursprünglich vom numerischen Datentyp stammt, kann dann mit FORMATder measure nicht für visuelle Elemente verwendet werden, bei denen der values Abschnitt einen numerischen Datentyp erfordert, z. B. mit Diagrammen. In Power BI können Sie alternativ Dynamische format Zeichenfolgen für Measures verwenden, eine bedingte format Zeichenfolge angeben, die den numerischen Datentyp des measureverwaltet.
Diese Funktion wird not für die Verwendung im DirectQuery-Modus unterstützt, wenn sie in berechneten Spalten or Sicherheitsregeln auf Zeilenebene (RLS) verwendet wird.
Beispiele
Format Zeichenfolgen
= 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")
Ertrag:
12345.67 "Allgemeine Zahl" zeigt die Zahl ohne Formatierung an.
$12.345,67 "Currency" zeigt die Zahl mit Ihrer currency Gebietsschemaformatierung an. Die hier sample zeigt die standardformatierung "Usa currency".
12345,67 "Fixed" zeigt mindestens eine Ziffer für die left des Dezimaltrennzeichens and zwei Ziffern an die right des Dezimaltrennzeichens an.
12.345,67 "Standard" zeigt mindestens eine Ziffer für die left des Dezimaltrennzeichens and zwei Ziffern an die right des Dezimaltrennzeichens an, and tausend Trennzeichen enthält. Die sample hier zeigt die Standardformatierung für Us-Amerikanische Nummern an.
1.234.567,00 % "Prozent" zeigt die Zahl als Prozentsatz (multipliziert mit 100) mit Formatierung and prozentual sign an der right der Zahl an, die durch ein einzelnes Leerzeichen getrennt ist.
1,23E+04 "Wissenschaftlich" zeigt die Zahl in der wissenschaftlichen Schreibweise mit zwei Dezimalziffern an.
Datetime mit optionaler locale_name
= 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" )
Ertrag:
12.15.2020 12:30:59 Uhr Wo month vorangestellt ist dayandtime ist 12-hourformat.
15.12.2020 12:30:59 Wo day vorangestellt ist monthandtime ist 24-hourformat.
12.15.2020 12:30:59 Wo month vorangestellt ist dayandtime ist 24-hourformat. Da eine nicht gebietsschemaabhängige format Zeichenfolge angegeben ist, wird das Gebietsschema not angewendet, and das nicht gebietsschemabezogene format zurückgegeben wird.
Vordefinierte numerische Formate
Die folgenden vordefinierten numerischen Formate können im argument format_string angegeben werden:
Format |
Beschreibung |
|---|---|
"General Number" |
Zeigt Zahlen ohne Tausendertrennzeichen an. |
"Currency" |
Zeigt Zahl mit Tausendertrennzeichen an, if geeignet; zeigt dem right des Dezimaltrennzeichens zwei Ziffern an. Die Ausgabe basiert auf den Systemgebietsschemaeinstellungen. |
"Fixed" |
Zeigt dem right des Dezimaltrennzeichens mindestens eine Ziffer leftand zwei Ziffern an. |
"Standard" |
Zeigt die Zahl mit Tausendertrennzeichen an, mindestens eine Ziffer bis zur leftand zwei Ziffern bis zum right des Dezimaltrennzeichens. |
"Percent" |
Zeigt zahl multipliziert mit 100 mit einem Prozent sign (%) unmittelbar an die rightangefügt; zeigt immer zwei Ziffern an der right des Dezimaltrennzeichens an. |
"Scientific" |
Verwendet standardmäßige wissenschaftliche Schreibweise, die zwei signifikante Ziffern bereitstellt. |
"Yes/No" |
Zeigt keine if Zahl ist 0; andernfalls wird Ja angezeigt. |
"True/False" |
Zeigt Falseif Zahl 0 an; andernfalls wird Trueangezeigt. |
"On/Off" |
Zeigt aus, if Zahl 0 ist; andernfalls wird "Ein" angezeigt. |
Benutzerdefinierte numerische Formate
Ein benutzerdefinierter format Ausdruck für Zahlen kann von 1 bis drei Abschnitten durch Semikolons getrennt sein. If das argument format Zeichenfolge contains eines der benannten numerischen Formate, ist nur ein Abschnitt zulässig.
| If Sie verwenden | Das Ergebnis ist |
|---|---|
| Nur ein Abschnitt | Der format Ausdruck gilt für allvalues. |
| Zwei Abschnitte | Der abschnitt first gilt für positive valuesand Nullen, die second für negative values. |
| Drei Abschnitte | Der abschnitt first gilt für positive values, das second für negative values, and der dritte bis null. |
"$#,##0;($#,##0)"
If Sie Semikolons mit nichts dazwischen einfügen, wird der fehlende Abschnitt mithilfe der format des positiven valuedefiniert. Im folgenden format werden beispielsweise positive and negative values mit dem format im Abschnitt first angezeigt, and "Null" anzeigt, if die value null ist.
"$#,##0"
If Sie Semikolons mit nichts dazwischen einfügen, wird der fehlende Abschnitt mithilfe der format des positiven valueangezeigt.
Benutzerdefinierte numerische format Zeichen
Die folgenden benutzerdefinierten numerischen format Zeichen können im argument format_string angegeben werden:
| Zeichen | Beschreibung |
|---|---|
| None | Zeigt die Zahl ohne Formatierung an. |
(0) |
Ziffernplatzhalter. Zeigt eine Ziffer or null an. If der Ausdruck eine Ziffer an der Position aufweist, an der die 0 in der format Zeichenfolge angezeigt wird, zeigen Sie ihn an; andernfalls wird an dieser Position eine Null angezeigt.If die Zahl weniger Ziffern enthält, als im format Ausdruck nullen (auf beiden Seiten) vorhanden sind, zeigen Sie führende or nachfolgende Nullen an. If die Zahl mehr Ziffern für die right des Dezimaltrennzeichens aufweist, als nullen für die right des Dezimaltrennzeichens im format Ausdruck vorhanden sind, round die Zahl so viele Dezimalstellen wie Nullen. If die Zahl mehr Ziffern für die left des Dezimaltrennzeichens aufweist, als nullen für die left des Dezimaltrennzeichens im format Ausdruck vorhanden sind, zeigen Sie die zusätzlichen Ziffern ohne Änderung an. |
(#) |
Ziffernplatzhalter. Zeigt eine Ziffer or nichts an. If der Ausdruck eine Ziffer an der Position aufweist, an der die # in der format Zeichenfolge angezeigt wird, zeigen Sie ihn an; andernfalls wird an dieser Position nichts angezeigt. Dieses Symbol funktioniert wie der Platzhalter "0 Ziffern", except, dass führende and nachfolgende Nullen nicht angezeigt werden, if die Zahl die gleichen or weniger Ziffern aufweist als #-Zeichen auf beiden Seiten des Dezimaltrennzeichens im format Ausdruck. |
(.) |
Dezimalplatzhalter. In einigen Gebietsschemas wird ein Komma als Dezimaltrennzeichen verwendet. Der Dezimalplatzhalter bestimmt, wie viele Ziffern dem leftandright des Dezimaltrennzeichens angezeigt werden. If dem format Ausdruck contains nur Zahlenzeichen an die left dieses Symbols, beginnen Zahlen, die kleiner als 1 sind, mit einem Dezimaltrennzeichen. Um eine führende Null anzuzeigen, die mit Bruchzahlen angezeigt wird, verwenden Sie 0 als first Ziffernplatzhalter für die left des Dezimaltrennzeichens. Das tatsächliche Zeichen, das als Dezimalplatzhalter in der formatierten Ausgabe verwendet wird, hängt von der Zahl Format, die vom System erkannt wird. |
(%) |
Prozentplatzhalter. Der Ausdruck wird mit 100 multipliziert. Das Prozentzeichen (%) wird an der Position eingefügt, an der es in der format Zeichenfolge angezeigt wird. |
(,) |
Tausendertrennzeichen. In einigen Gebietsschemas wird ein Punkt als Tausendertrennzeichen verwendet. Das Tausendertrennzeichen trennt Tausende von Hunderten innerhalb einer Zahl, die vier or mehr Stellen zum left des Dezimaltrennzeichens enthält. Die Standardverwendung des Tausendertrennzeichens wird if dem formatcontains tausendertrennzeichen angegeben, das von Ziffernplatzhaltern umgeben ist (0or#). Zwei benachbarte Tausendertrennzeichen or ein Tausendertrennzeichen unmittelbar auf die left des Dezimaltrennzeichens (ob ornot eine Dezimalzahl angegeben ist) bedeutet " die Zahl skalieren, indem sie nach Bedarf durch 1000 dividiert wird." Sie können beispielsweise die format Zeichenfolge "##0," verwenden, um 100 Millionen als 100 darzustellen. Zahlen, die kleiner als 1 Million sind, werden als 0 angezeigt. Zwei benachbarte Tausendertrennzeichen an einer anderen Position als unmittelbar an der left des Dezimaltrennzeichens werden einfach als Angabe der Verwendung eines Tausendertrennzeichens behandelt. Das tatsächliche Zeichen, das als Tausendertrennzeichen in der formatierten Ausgabe verwendet wird, hängt von der Zahl Format ab, die vom System erkannt wird. |
(:) |
Time Trennzeichen. In einigen Gebietsschemas können andere Zeichen verwendet werden, um das trennzeichen time darzustellen. Das time trennzeichen trennt Stunden, Minuten and Sekunden, wenn timevalues formatiert sind. Das tatsächliche Zeichen, das als time Trennzeichen in formatierter Ausgabe verwendet wird, wird durch Die Systemeinstellungen bestimmt. |
(/) |
Date Trennzeichen. In einigen Gebietsschemas können andere Zeichen verwendet werden, um das trennzeichen date darzustellen. Das date Trennzeichen trennt die day, month, andyear, wenn datevalues formatiert sind. Das tatsächliche Zeichen, das als date Trennzeichen in formatierter Ausgabe verwendet wird, wird durch Die Systemeinstellungen bestimmt. |
(E- E+ e- e+) |
Wissenschaftliche format.
If den format Ausdruck contains mindestens einen Ziffernplatzhalter (0or#) an die right von E-, E+, E-, or e+, wird die Zahl in wissenschaftlicher formatand E or e zwischen der Zahl and ihrem Exponenten eingefügt. Die Anzahl der Ziffernplatzhalter für die right bestimmt die Anzahl der Ziffern im Exponenten. Verwenden Sie E- or e-, um ein Minus-signnext für negative Exponenten zu platzieren. Verwenden Sie E+ or e+ zum Platzieren eines Minus-signnext für negative Exponenten and ein Plus-signnext zu positiven Exponenten. |
- + $ ( ) |
Zeigt ein Literalzeichen an. Wenn Sie ein anderes Zeichen als eines der aufgeführten Zeichen anzeigen möchten, stellen Sie ihm einen umgekehrten Schrägstrich (\) voran, or es in doppelte Anführungszeichen einschließen (" "). |
(\\) |
Zeigt das next Zeichen in der format Zeichenfolge an. Um ein Zeichen anzuzeigen, das eine besondere Bedeutung als Literalzeichen hat, stellen Sie ihm einen umgekehrten Schrägstrich voran (\). Der umgekehrte Schrägstrich selbst wird nicht angezeigt. Die Verwendung eines umgekehrten Schrägstrichs entspricht dem Einschließen des next Zeichens in doppelte Anführungszeichen. Um einen umgekehrten Schrägstrich anzuzeigen, verwenden Sie zwei umgekehrte Schrägstriche (\\). Beispiele für Zeichen, die nicht als Literalzeichen angezeigt werden können, sind die date-formatierung andtime-formatierungszeichen (a, c, d, h, m, n, p, q, s, t, w, y, /, and :), die numerischen Formatierungszeichen (#, 0, %, E, e, Komma, and Punkt), and die Zeichenfolgenformatierungszeichen (@, &, <, >, and !). |
| ("ABC") | Anzeigen der Zeichenfolge innerhalb der doppelten Anführungszeichen (" "). |
Vordefinierte date/time Formate
Die folgenden vordefinierten date/time Formate können im argument format_string angegeben werden. Bei verwendung anderer Formate werden sie als benutzerdefinierte date/timeformatinterpretiert:
| Format | Beschreibung |
|---|---|
"General Date" |
Zeigt eine dateand/ortimean. Beispiel: 12.03.2008 11:07:31. Date Anzeige wird durch die aktuelle Kultur valueIhrer Anwendung bestimmt. |
"Long Date" or "Medium Date" |
Zeigt eine date entsprechend der langen dateformatIhrer aktuellen Kultur an. Beispiel: Mittwoch, den 12. März 2008. |
"Short Date" |
Zeigt eine date mithilfe der kurzen dateformatIhrer aktuellen Kultur an. Beispiel: 12.03.2008. |
"Long Time" or |
Zeigt eine time mit dem langen timeformatIhrer aktuellen Kultur an; enthält in der Regel Stunden, Minuten, Sekunden. Beispiel: 11:07:31. |
"Medium Time" |
Zeigt eine time in 12 hourformatan. Beispiel: 11:07 Uhr. |
"Short Time" |
Zeigt eine time in 24 hourformatan. Beispiel: 11:07. |
Benutzerdefinierte date/time Formate
Die folgenden format Zeichen können im format_string angegeben werden, um benutzerdefinierte date/time Formate zu erstellen:
| Zeichen | Beschreibung |
|---|---|
(:) |
Time Trennzeichen. In einigen Gebietsschemas können andere Zeichen verwendet werden, um das trennzeichen time darzustellen. Das time trennzeichen trennt Stunden, Minuten and Sekunden, wenn timevalues formatiert sind. Das tatsächliche Zeichen, das als time Trennzeichen in formatierter Ausgabe verwendet wird, wird durch Die Systemeinstellungen bestimmt. |
(/) |
Date Trennzeichen. In einigen Gebietsschemas können andere Zeichen verwendet werden, um das trennzeichen date darzustellen. Das date Trennzeichen trennt die day, month, andyear, wenn datevalues formatiert sind. Das tatsächliche Zeichen, das als date Trennzeichen in formatierter Ausgabe verwendet wird, wird durch Die Systemeinstellungen bestimmt. |
(\) |
Backslash. Zeigt das next Zeichen als Literalzeichen an. Es wird also not als Formatierungszeichen interpretiert. |
(") |
Doppeltes Anführungszeichen. Text, der in doppelte Anführungszeichen eingeschlossen ist, wird angezeigt. Es wird also not als Formatierungszeichen interpretiert. |
c |
Zeigt die date als dddddand die time in dieser Reihenfolge als tttttan. Zeigt nur date Informationen an, if es keine Bruchzahl für die date Seriennummer gibt; nur time Informationen anzeigen, if es keinen ganzzahligen Teil gibt. |
d |
Zeigt die day als Zahl ohne vorangestellte Null an (1-31). |
dd |
Zeigt die day als Zahl mit vorangestellter Null an (01-31). |
ddd |
Anzeigen der day als Abkürzung (Sun-Sat). Lokalisierte. |
dddd |
Anzeigen der day als vollständiger Name (Sunday-Saturday). Lokalisierte. |
ddddd |
Zeigen Sie die date als vollständige date an (einschließlich day, month, andyear), die entsprechend der kurzen dateformat Einstellung Ihres Systems formatiert sind. Die standardmäßige kurze dateformat ist mm/dd/yyyy. |
dddddd |
Zeigen Sie eine date Seriennummer als vollständige date (einschließlich day, month, andyear) an, die entsprechend der langen date Einstellung formatiert ist, die von Ihrem System erkannt wird. Der standard lange dateformat ist dddd, mmmm d, yyyy. |
w |
Zeigt die day der Woche als Zahl an (1 für Sonntag bis 7 für Samstag). |
ww |
Zeigt die Woche der year als Zahl an (1-54). |
m |
Zeigt die month als Zahl ohne vorangestellte Null an (1-12).
If
m folgt sofort horhh, minute anstelle der month angezeigt wird. |
mm |
Zeigt die month als Zahl mit vorangestellter Null an (01-12).
If
mm folgt sofort horhh, minute anstelle der month angezeigt wird. |
mmm |
Anzeigen der month als Abkürzung (Jan-Dec). Lokalisierte. |
mmmm |
Anzeigen der month als vollständiger month Name (January-December). Lokalisierte. |
q |
Zeigt die quarter der year als Zahl an (1-4). |
y |
Zeigt die day des year als Zahl an (1-366). |
yy |
Zeigt die year als 2-stellige Zahl an (00-99). |
yyyy |
Zeigt die year als vierstellige Zahl an (100-9999). |
h |
Zeigt die hour als Zahl ohne vorangestellte Null an (0-23). |
hh |
Zeigt die hour als Zahl mit vorangestellter Null an (00-23). |
n |
Zeigt die minute als Zahl ohne vorangestellte Null an (0-59). |
nn |
Zeigt die minute als Zahl mit vorangestellter Null an (00-59). |
s |
Zeigt die second als Zahl ohne vorangestellte Null an (0-59). |
ss |
Zeigt die second als Zahl mit vorangestellter Null an (00-59). |
ttttt |
Zeigen Sie eine time als vollständige time an (einschließlich hour, minute, andsecond), die mit dem time trennzeichen formatiert sind, das durch die vom System erkannten timeformat definiert ist. Eine führende Null wird angezeigt, if die führende Nulloption ausgewählt wird, and die time vor 10:00 Uhr or P.M. liegt. Die Standard-timeformat ist h:mm:ss. |
AM/PM |
Verwenden Sie die 12-hour Uhr, and mit jedem hour vor Mittag eine Großbuchstaben AM anzeigen; anzeigen einer Großbuchstaben-PM mit einer beliebigen hour zwischen Mittag and 11:59 Uhr. |
am/pm |
Verwenden Sie die 12-hour Uhr, and mit jedem hour vor Mittag eine Kleinbuchstaben AM anzeigen; anzeigen einer Kleinbuchstaben-PM mit einer beliebigen hour zwischen Mittag and 11:59 Uhr. |
A/P |
Verwenden Sie die 12-hour Uhr, and eine Großbuchstaben A mit allen hour vor Mittag anzeigen; zeigt ein P in Großbuchstaben mit einem beliebigen hour zwischen Mittag and 11:59 Uhr an. |
a/p |
Verwenden Sie die 12-hour Uhr, and ein Kleinbuchstabe A mit allen hour vor Mittag anzeigen; ein Kleinbuchstabe P mit einer beliebigen hour zwischen Mittag and 11:59 Uhr anzeigen |
AMPM |
Verwenden Sie die 12-hour Uhr, and das AM-Zeichenfolgenliteral wie vom System definiert mit jedem hour vor Mittag anzeigen; zeigen Sie das PM-Zeichenfolgenliteral an, wie es vom System mit jedem hour zwischen Mittag and 11:59 P.M. AMPM definiert wurde, kann entweder groß geschrieben or Kleinbuchstaben sein, aber die Groß-/Kleinschreibung der angezeigten Zeichenfolge entspricht der Zeichenfolge gemäß den Systemeinstellungen. Der Standardwert format ist AM/PM. If Ihr System auf 24-hour Uhr festgelegt ist, wird die Zeichenfolge typischerweise auf eine leere Zeichenfolge festgelegt. |
Date/time Formatierung verwendet das aktuelle Benutzergebietsschema, um die Zeichenfolge zu format. Betrachten Sie beispielsweise den date 25. Juni 2020. Wenn sie mit format Zeichenfolge "m/d/yyyy" formatiert ist, lautet dies wie folgt:
- Benutzergebietsschema ist Vereinigte Staaten von Amerika (en-US): "25.06.2020"
- Benutzergebietsschema ist Deutschland (de-DE): "6.25.2020"
Beispiele für benutzerdefinierte date/timeformat
In den folgenden Beispielen wird die date/time Donnerstag, 25. Juni 2020, um 1:23:45 Uhr verwendet. Deutschland (de-DE) verwendet ein 24-hour System. Es gibt keine Entsprechung von AM/PM.
| Format | Ergebnis (en-US) | Ergebnis (de-DE) |
|---|---|---|
"c" |
06/25/2020 13:23:45 | 25.06.2020 13:23:45 |
"d" |
25 | 25 |
"dd" |
25 | 25 |
"ddd" |
Thu | Tun |
"dddd" |
Donnerstag | Donnerstag |
"ddddd" |
06/25/2020 | 25.06.2020 |
"dddddd" |
Donnerstag, 25. Juni 2020 | Donnerstag, 25. Juni 2020 |
"w" |
5 | 5 |
"ww" |
26 | 26 |
"m" |
6 | 6 |
"mm" |
06 | 06 |
"mmm" |
Jun | Jun |
"mmmm" |
Juni | Juni |
"q" |
2 | 2 |
"y" |
177 | 177 |
"yy" |
20 | 20 |
"yyyy" |
2020 | 2020 |
"""Year"" yyyy" |
Year 2020 | Year 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 Uhr | 1:23:45 |
"hh:nn:ss" |
13:23:45 | 13:23:45 |
"hh:nn:ss AMPM" |
01:23:45 Uhr | 01:23:45 |
"ttttt" |
13:23:45 | 13:23:45 |
"ttttt AMPM" |
13:23:45 Uhr | 13:23:45 |
"mm/dd/yyyy hh:nn:ss AMPM" |
25.06.2020 01:23:45 Uhr | 6.25.2020 01:23:45 |