FORMAT
A következőkre vonatkozik:Számított oszlop
Számított tábla
Mérték
Vizualizációszámítási
Egy értéket a megadott formátumnak megfelelően szöveggé alakít át.
Szintaxis
FORMAT(<value>, <format_string>[, <locale_name>])
Paraméterek
Kifejezés | Definíció |
---|---|
value |
Egyetlen értékre kiértékelt érték vagy kifejezés. |
format_string |
A formázási sablont tartalmazó sztring. |
locale_name |
(Nem kötelező) A függvény által használandó területi beállítás neve. A lehetséges értékek a Windows API-függvény által elfogadott sztringek, LocaleNameToLCID(). |
Visszaadott érték
A value
által definiált format_string
tartalmazó sztring.
Jegyzet
Ha value
BLANK, a függvény üres sztringet ad vissza.
Ha format_string
BLANK, az érték "Általános szám" vagy "Általános dátum" formátumban van formázva (value
adattípusnak megfelelően).
Megjegyzések
Az előre definiált formázási sztringek a modellkultúra tulajdonságot használják az eredmény formázásához. Alapértelmezés szerint a modellkultúra tulajdonság a számítógép felhasználói területi beállításainak megfelelően van beállítva. Az új Power BI Desktop-modellek esetében a modellkultúra tulajdonsága módosítható a Beállítások > a Területi beállítások > Modell nyelvében. Az Analysis Services esetében a modellkultúra a példány által eredetileg definiált Language tulajdonságnak megfelelően van beállítva.
A DAXFORMAT függvény argumentumaként támogatott formátumsztringek a Visual Basic (OLE Automation) által használt formátumsztringeken alapulnak, nem pedig a .NET-keretrendszer által használt formátumsztringeken. Ezért előfordulhat, hogy váratlan eredmények vagy hiba jelenik meg, ha az argumentum nem egyezik meg a megadott formázási sztringekkel. A "p" például a "Százalék" rövidítéseként nem támogatott. Az előre definiált formázási sztringek listájában nem szereplő FORMAT függvény argumentumaként megadott sztringeket egy egyéni formátumsztring részeként vagy sztringkonstansként kezeli a rendszer.
Ha többet szeretne megtudni a területi beállítások FORMATvaló megadásáról, tekintse meg ezt a videó.
A FORMAT szöveges adattípusra módosítja a mértékeredményeket. Ha a mérték eredménye eredetileg numerikus adattípus, akkor FORMATesetén a mérték nem használható olyan vizualizációkban, ahol az értékek szakasz numerikus adattípust igényel, például diagramok esetében. A Power BI-ban dinamikus formázási sztringeket is használhat mértékekhez, megadhat egy feltételes formázási sztringet, amely fenntartja a mérték numerikus adattípusát.
Ez a függvény nem támogatott DirectQuery módban, ha számított oszlopokban vagy sorszintű biztonsági (RLS) szabályokban használják.
Példák
Sztringek formázása
= 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")
Visszatér:
12345.67 "Általános szám" formázás nélkül jeleníti meg a számot.
12 345,67 USD "Pénznem" a pénznem területi formázásával együtt jeleníti meg a számot. Az alábbi példában az Egyesült Államok alapértelmezett pénznemformázása látható.
12345,67 "Rögzített" a tizedeselválasztótól balra legalább egy számjegyet, a tizedeselválasztótól jobbra pedig két számjegyet jelenít meg.
12 345,67 "Standard" a tizedeselválasztótól balra legalább egy számjegyet, a decimális elválasztótól jobbra pedig két számjegyet jelenít meg, és ezer elválasztójelet tartalmaz. Az alábbi példában az Egyesült Államok alapértelmezett számformázása látható.
1 234 567,00 % "Százalék" százalékként jeleníti meg a számot (100-zal megszorozva) formázással és a szám jobb oldalán lévő százalékjellel, egyetlen szóközzel elválasztva.
1,23E+04 "Scientific" két tizedesjegyet tartalmazó tudományos jelölésben jeleníti meg a számot.
Dátumidő választható 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" )
Visszatér:
2020. 12. 15. 12:30:59 Ahol a hónap a napot és az időt megelőző 12 órás formátum.
2020.12.15. 12:30:59 Ahol a hónap és az idő előtti nap 24 órás formátumú.
2020.12.15. 12:30:59 Ahol a hónap a napot és az időt megelőző 24 órás formátum. Mivel egy nem területi beállítástól függő formátumsztring van megadva, a rendszer nem alkalmazza a területi beállítást, és visszaadja a nem területi formátumot.
Előre definiált numerikus formátumok
Az alábbi előre definiált numerikus formátumok adhatók meg a format_string
argumentumban:
Format |
Leírás |
---|---|
"General Number" |
Ezres elválasztójel nélküli számot jelenít meg. |
"Currency" |
Ha szükséges, ezres elválasztójellel jeleníti meg a számot; két számjegyet jelenít meg a decimális elválasztótól jobbra. A kimenet a rendszer területi beállításain alapul. |
"Fixed" |
Legalább egy számjegyet jelenít meg balra és két számjegyet a tizedeselválasztótól jobbra. |
"Standard" |
Ezres elválasztójellel rendelkező számot jelenít meg, legalább egy számjegyet balra és két számjegyet a tizedeselválasztótól jobbra. |
"Percent" |
A számot 100-zal szorozva jeleníti meg, a jobb oldalon közvetlenül hozzáfűzött százalékjel (%) mellett; mindig két számjegyet jelenít meg a tizedeselválasztótól jobbra. |
"Scientific" |
Szabványos tudományos jelölést használ, amely két jelentős számjegyet biztosít. |
"Yes/No" |
Nemet jelenít meg, ha a szám 0; ellenkező esetben az Igen jelenik meg. |
"True/False" |
Hamis értéket jelenít meg, ha a szám 0; ellenkező esetben a True (Igaz) érték jelenik meg. |
"On/Off" |
Ki van kapcsolva, ha a szám 0; ellenkező esetben a Be gomb jelenik meg. |
Egyéni numerikus formátumok
A számok egyéni formátumkifejezései egytől háromig lehetnek pontosvesszővel elválasztva. Ha a formázási sztring argumentum a nevesített numerikus formátumok egyikét tartalmazza, csak egy szakasz engedélyezett.
Ha a | Az eredmény: |
---|---|
Csak egy szakasz | A formátumkifejezés minden értékre érvényes. |
Két szakasz | Az első szakasz a pozitív értékekre és nullákra, a második a negatív értékekre vonatkozik. |
Három szakasz | Az első szakasz a pozitív értékekre, a második a negatív értékekre, a harmadik a nullákra vonatkozik. |
"$#,##0;($#,##0)"
Ha olyan pontosvesszőket tartalmaz, amelyek között nincs köztük semmi, a hiányzó szakasz a pozitív érték formátumával lesz definiálva. Az alábbi formátum például pozitív és negatív értékeket jelenít meg az első szakaszban szereplő formátummal, és a "Nulla" értéket jeleníti meg, ha az érték nulla.
"$#,##0"
Ha olyan pontosvesszőket tartalmaz, amelyek között nincs köztük semmi, a hiányzó szakasz a pozitív érték formátumával jelenik meg.
Egyéni numerikus formázási karakterek
A format_string
argumentumban a következő egyéni numerikus formátumkarakterek adhatók meg:
Karakter | Leírás |
---|---|
Egyik sem | A szám formázás nélkül jelenik meg. |
(0 ) |
Számjegy helyőrzője. Számjegy vagy nulla megjelenítése. Ha a kifejezésnek van egy számjegye abban a pozícióban, ahol a 0 megjelenik a formátumsztringben, jelenítse meg; ellenkező esetben egy nulla jelenik meg ebben a pozícióban. Ha a számnak kevesebb számjegye van, mint nullának (a tizedesvessző mindkét oldalán) a formátumkifejezésben, akkor a kezdő vagy záró nullák jelennek meg. Ha a számnak több számjegye van a tizedeselválasztótól jobbra, mint a decimális elválasztótól jobbra lévő nullák a formátumkifejezésben, kerekítsd a számot annyi tizedesjegyre, amennyi nulla. Ha a számnak több számjegye van a tizedeselválasztótól balra, mint a decimális elválasztótól balra lévő nullák a formátumkifejezésben, a további számjegyeket módosítás nélkül jeleníti meg. |
(# ) |
Számjegy helyőrzője. Számjegy vagy semmi megjelenítése. Ha a kifejezés egy számjegyet tartalmaz abban a pozícióban, ahol a #megjelenik a formátumsztringben, akkor jelenítse meg; ellenkező esetben semmit sem jeleníthet meg ebben a pozícióban. Ez a szimbólum a 0 jegyű helyőrzőhöz hasonlóan működik, azzal a kivételsel, hogy a kezdő és záró nullák nem jelennek meg, ha a szám ugyanolyan vagy kevesebb számjegyet tartalmaz, mint a formátumkifejezésben a tizedeselválasztó mindkét oldalán # karakter. |
(. ) |
Tizedesjegyek helyőrzője. Egyes területi beállításokban vesszőt használunk tizedesjelként. A tizedesjegy-helyőrző határozza meg, hogy hány számjegy jelenjen meg a tizedeselválasztó bal és jobb oldalán. Ha a formátumkifejezés csak a szimbólumtól balra lévő számjeleket tartalmazza, az 1-nél kisebb számok tizedeselválasztóval kezdődnek. A törtszámmal megjelenített kezdő nulla megjelenítéséhez használja a 0-t a tizedeselválasztótól balra lévő első számjegy helyőrzőjeként. A formázott kimenetben tizedesjegyként használt tényleges karakter a rendszer által felismert számformátumtól függ. |
(% ) |
Százalékos helyőrző. A kifejezés megszorozva 100-tal. A százalék karakter (% ) abban a pozícióban lesz beszúrva, ahol a formátumsztringben megjelenik. |
(, ) |
Ezer elválasztó. Egyes területi beállításokban egy pontot használnak ezer elválasztóként. Az ezer elválasztó több ezert választ el száztól egy számon belül, amelynek négy vagy több helye van a tizedesjeltől balra. Az ezer elválasztó szabványos használata akkor van megadva, ha a formátum számjegyek (0 vagy # ) által körülvett ezer elválasztót tartalmaz. Két szomszédos ezer elválasztó vagy ezer elválasztó közvetlenül a tizedeselválasztótól balra (akár tizedesvessző van megadva, akár nem) azt jelenti, hogy "skálázza a számot 1000-rel elosztva, szükség szerint kerekítve". A "##0" formátumsztring használatával például 100 milliót jelölhet 100-ként. Az 1 milliónál kisebb számok 0-ként jelennek meg. A decimális elválasztótól közvetlenül balra lévő két szomszédos ezer elválasztót egyszerűen úgy kell kezelni, mint amely ezer elválasztó használatát határozza meg. A formázott kimenet ezer elválasztójaként használt tényleges karakter a rendszer által felismert számformátumtól függ. |
(: ) |
Időelválasztó. Egyes területi beállításokban más karakterek is használhatók az időelválasztó megjelenítéséhez. Az időelválasztó elválasztja az órákat, perceket és másodperceket az időértékek formázásakor. A formázott kimenet időelválasztójaként használt tényleges karaktert a rendszerbeállítások határozzák meg. |
(/ ) |
Dátumelválasztó. Egyes területi beállításokban más karakterek is használhatók a dátumelválasztó megjelenítéséhez. A dátumelválasztó elválasztja a dátumértékek formázásának napját, hónapjait és évét. A formázott kimenetben dátumelválasztóként használt tényleges karaktert a rendszerbeállítások határozzák meg. |
(E- E+ e- e+ ) |
Tudományos formátum. Ha a formátumkifejezés legalább egy számjegyhelyőrzőt (0 vagy # ) tartalmaz az E-, E+, e- vagy e+-érték jobb oldalán, a szám tudományos formátumban jelenik meg, és az E vagy e karakter be lesz szúrva a szám és a kitevő közé. A jobb oldali számjegyhelyőrzők száma határozza meg a kitevőben lévő számjegyek számát. Az E- vagy e- jellel mínuszjelet helyezhet a negatív kitevők mellé. Az E+ vagy az e+ billentyűvel mínuszjelet helyezhet el a negatív kitevők mellett, a pozitív kitevők mellett pedig pluszjelet. |
- + $ ( ) |
Literális karakter megjelenítése. Ha a felsoroltaktól eltérő karaktert szeretne megjeleníteni, akkor azt fordított perjellel (\ ) kell megelőznie, vagy idézőjelek közé kell foglalnia (" "). |
(\\ ) |
A következő karakter megjelenítése a formátumsztringben. Ha egy speciális jelentésű karaktert szeretne literális karakterként megjeleníteni, akkor azt fordított perjel (\ ) előzi meg. Maga a fordított perjel nem jelenik meg. A fordított perjel használata ugyanaz, mint a következő karakter dupla idézőjelek közé helyezése. Fordított perjel megjelenítéséhez használjon két fordított perjelet (\\ ). A konstans karakterként nem megjeleníthető karakterek például a dátum- és időformázási karakterek (a, c, d, h, m, n, p, q, s, t, w, y, /és :), a numerikus formázási karakterek (#, 0, %, E, e, vessző és pont) és a sztringformázási karakterek (@, &, <, >és !). |
("ABC") | A sztring megjelenítése a kettős idézőjeleken (" "). |
Előre definiált dátum-/időformátumok
Az alábbi előre definiált dátum-/időformátumok adhatók meg a format_string
argumentumban. Ezeken kívül más formátumok használata esetén a rendszer egyéni dátum-/időformátumként értelmezi őket:
Formátum | Leírás |
---|---|
"General Date" |
Dátumot és/vagy időt jelenít meg. Például: 2008. 03. 12. 11:07:31. A dátummegjelenítést az alkalmazás aktuális kulturális értéke határozza meg. |
"Long Date" vagy "Medium Date" |
A jelenlegi kultúra hosszú dátumformátumának megfelelő dátumot jelenít meg. Például 2008. március 12., szerda. |
"Short Date" |
A jelenlegi kultúra rövid dátumformátumával jeleníti meg a dátumot. Például: 2008. 03. 12. |
"Long Time" vagy |
Az aktuális kulturális környezet hosszú időformátumával jeleníti meg az időt; általában órákat, perceket, másodperceket tartalmaz. Például: 11:07:31. |
"Medium Time" |
12 órás formátumban jeleníti meg az időt. Például: 11:07. |
"Short Time" |
24 órás formátumban jeleníti meg az időt. Például: 11:07. |
Egyéni dátum-/időformátumok
Az egyéni dátum-/időformátumok létrehozásához a következő formátumkarakterek adhatók meg a format_string
:
Karakter | Leírás |
---|---|
(: ) |
Időelválasztó. Egyes területi beállításokban más karakterek is használhatók az időelválasztó megjelenítéséhez. Az időelválasztó elválasztja az órákat, perceket és másodperceket az időértékek formázásakor. A formázott kimenet időelválasztójaként használt tényleges karaktert a rendszerbeállítások határozzák meg. |
(/ ) |
Dátumelválasztó. Egyes területi beállításokban más karakterek is használhatók a dátumelválasztó megjelenítéséhez. A dátumelválasztó elválasztja a dátumértékek formázásának napját, hónapjait és évét. A formázott kimenetben dátumelválasztóként használt tényleges karaktert a rendszerbeállítások határozzák meg. |
(\ ) |
Fordított perjel. A következő karaktert konstans karakterként jeleníti meg. Tehát ez nem formázási karakterként van értelmezve. |
(" ) |
Dupla idézőjel. A dupla idézőjelek közé zárt szöveg jelenik meg. Tehát ez nem formázási karakterekként van értelmezve. |
c |
Jelenítse meg a dátumot ddddd , és az időt ttttt ként jelenítse meg ebben a sorrendben. Csak akkor jelenítse meg a dátumadatokat, ha a dátum sorozatszámának törtrésze nincs; csak akkor jelenítse meg az időadatokat, ha nincs egész szám. |
d |
A napot számként jeleníti meg kezdő nulla nélkül (1-31). |
dd |
A napot számként jeleníti meg egy kezdő nullával (01-31). |
ddd |
A nap rövidítése (Sun-Sat). Lokalizált. |
dddd |
A nap megjelenítése teljes névként (Sunday-Saturday). Lokalizált. |
ddddd |
A dátumot teljes dátumként jeleníti meg (beleértve a napot, a hónapot és az évet is), a rendszer rövid dátumformátum-beállításának megfelelően formázva. Az alapértelmezett rövid dátumformátum mm/dd/yyyy . |
dddddd |
Dátum sorozatszámának megjelenítése teljes dátumként (beleértve a napot, a hónapot és az évet is) a rendszer által felismert hosszú dátumbeállítás szerint formázva. Az alapértelmezett hosszú dátumformátum dddd, mmmm d, yyyy . |
w |
A hét napját számként jeleníti meg (vasárnaptól szombatig 7-et). |
ww |
Az év hetének megjelenítése számként (1-54). |
m |
A hónap számként jelenik meg kezdő nulla nélkül (1-12). Ha m azonnal követi h vagy hh , a hónap helyett perc jelenik meg. |
mm |
A hónap megjelenítése számként, kezdő nullával (01-12). Ha mm azonnal követi h vagy hh , a hónap helyett perc jelenik meg. |
mmm |
A hónap rövidítése (Jan-Dec). Lokalizált. |
mmmm |
A hónap megjelenítése teljes hónapnévként (January-December). Lokalizált. |
q |
Az év negyedévének megjelenítése számként (1-4). |
y |
Az év napját jeleníti meg számként (1-366). |
yy |
Az év megjelenítése kétjegyű számként (00-99). |
yyyy |
Az év megjelenítése 4 jegyű számként (100-9999). |
h |
Az órát bevezető nullát nem tartalmazó számként jeleníti meg (0-23). |
hh |
Az órát számként jeleníti meg egy kezdő nullával (00-23). |
n |
A perc bevezető nullát nem tartalmazó számként jelenik meg (0-59). |
nn |
A perc megjelenítése számként, kezdő nullával (00-59). |
s |
A másodikat számként jeleníti meg kezdő nulla nélkül (0-59). |
ss |
A másodikat számként jeleníti meg egy kezdő nullával (00-59). |
ttttt |
Az időt teljes időként jeleníti meg (beleértve az órát, a percet és a másodpercet is), a rendszer által felismert időformátum által meghatározott időelválasztóval formázva. A kezdő nulla akkor jelenik meg, ha a kezdő nulla lehetőség van kiválasztva, és az idő 10:00 előtt van. Az alapértelmezett időformátum h:mm:ss . |
AM/PM |
Használja a 12 órás órát, és jelenítsen meg egy nagybetűs AM-t bármely órával dél előtt; kis- és nagybetűket jelenít meg, dél és 11:59 óra között bármilyen órával. |
am/pm |
Használja a 12 órás órát, és jelenítsen meg kisbetűs AM-t bármely órával dél előtt; kisbetűs pm megjelenítése dél és 11:59 óra között bármely órával |
A/P |
Használja a 12 órás órát, és jelenítsen meg egy nagybetűs A-t bármely órával dél előtt; nagybetűs P megjelenítése dél és 11:59 óra között bármely órával |
a/p |
Használja a 12 órás órát, és jelenítsen meg egy kis A kisbetűt bármely órával dél előtt; kisbetűs P megjelenítése dél és 11:59 óra között |
AMPM |
Használja a 12 órás órát, és a rendszer által definiált AM-sztring literálját dél előtt egy órával jelenítse meg; a pm sztringnek a rendszer által meghatározott konstansának megjelenítése a dél és 11:59 óra közötti órákban. Az AMPM lehet nagybetűs vagy kisbetűs, de a megjelenített sztring esete megegyezik a rendszerbeállítások által meghatározott sztringgel. Az alapértelmezett formátum az AM/PM. Ha a rendszer 24 órásra van állítva, a sztring általában üres sztringre van állítva. |
A dátum/idő formázás az aktuális felhasználói területi beállítás használatával formázza a sztringet. Vegyük például a 2020. június 25-i dátumot. Ha az "m/d/yyyy" formátumsztring használatával van formázva, a következő lesz:
- A felhasználói területi beállítás az Amerikai Egyesült Államok (en-US): "2020.06.25."
- A felhasználói területi beállítás Németország (de-DE): "6.25.2020"
Egyéni dátum-/időformátum-példák
Az alábbi példák a dátum/idő 2020. június 25., csütörtök 13:23:45 időpontban használatosak. Németország (de-DE) 24 órás rendszert használ. Nincs egyenértékű am/PM.
Formátum | Eredmény (en-US) | Eredmény (de-DE) |
---|---|---|
"c" |
06/25/2020 13:23:45 | 25.06.2020 13:23:45 |
"d" |
25 | 25 |
"dd" |
25 | 25 |
"ddd" |
Thu | Csinál |
"dddd" |
Csütörtök | Donnerstag |
"ddddd" |
06/25/2020 | 25.06.2020 |
"dddddd" |
2020. június 25., csütörtök | Donnerstag, 25 éves. Juni 2020 |
"w" |
5 | 5 |
"ww" |
26 | 26 |
"m" |
6 | 6 |
"mm" |
06 | 06 |
"mmm" |
Jún | Jún |
"mmmm" |
Június | Juni |
"q" |
2 | 2 |
"y" |
177 | 177 |
"yy" |
20 | 20 |
"yyyy" |
2020 | 2020 |
"""Year"" yyyy" |
2020. év | 2020. év |
"yyyy \Qq" |
2020 2. negyedév | 2020 2. negyedév |
"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" |
13:23:45 | 1:23:45 |
"hh:nn:ss" |
13:23:45 | 13:23:45 |
"hh:nn:ss AMPM" |
13:23:45 | 01:23:45 |
"ttttt" |
13:23:45 | 13:23:45 |
"ttttt AMPM" |
13:23:45 | 13:23:45 |
"mm/dd/yyyy hh:nn:ss AMPM" |
2020. 06. 25. 13:23:45 | 6.25.2020 01:23:45 |