FORMÁTUM
A következőre vonatkozik:
Számított oszlop Számított tábla Mérték vizualizáció számítása
Egy értéket a megadott formátumnak megfelelően szöveggé alakít át.
Syntax
FORMAT(<value>, <format_string>[, <locale_name>])
Paraméterek
| Időszak | Definíció |
|---|---|
| Érték | 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 LocaleNameToLCID() Windows API-függvény által elfogadott sztringek. |
Visszaadott érték
A format_string által definiált értéket tartalmazó sztring.
Feljegyzés
Ha az érték ÜRES, a függvény egy üres sztringet ad vissza.
Ha format_string ÜRES, az érték "Általános szám" vagy "Általános dátum" formátumban van formázva (az érték adattípusának 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ág a Beállítások > területi beállítások > modellnyelvében módosítható. 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 DAX FORMAT 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 sztringek egy egyéni formátumsztring részeként vagy sztringkonstansként lesznek kezelve.
Ha többet szeretne megtudni egy területi beállítás formátummal való megadásáról, tekintse meg ezt a videót.
A FORMAT használatával a mérték eredménye szöveges adattípusra változik. Ha a mérték eredménye eredetileg numerikus adattípusú, akkor a FORMAT használatával 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 a mértékekhez , és 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:
Az 12345.67 "Általános szám" formázás nélkül jeleníti meg a számot.
A 12 345,67 USD "Pénznem" a pénznem területi formázásával jeleníti meg a számot. Az alábbi példában az alapértelmezett Egyesült Államok pénznemformázás látható.
Az 12345,67 "Rögzített" érték 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.
A 12 345,67 "Standard" 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, és ezer elválasztójelet tartalmaz. Az alábbi minta az alapértelmezett Egyesült Államok számformázást mutatja be.
1 234 567,00 % "Százalék" a számot százalékként jeleníti meg (100-zal megszorozva) formázással és a szám jobb oldalán lévő százalékjellel, egyetlen szóközzel elválasztva.
Az 1,23E+04 "Tudományos" szám 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 nap és idő előtti formátuma 24 órás. 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:
| Formátum | 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ékjellel (%) együtt; 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 az alábbi 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éssel rendelkező karaktert literális karakterként szeretne megjeleníteni, akkor azt egy 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 literális 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 jelenítse meg az időt tttttebben 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 napot rövidítésként (Sun-Sat) jeleníti meg. Lokalizált. |
| ddddd | A nap teljes névként (vasárnap-szombat) jelenik meg. Lokalizált. |
| dddddd | 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 a következő 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 a következő 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). |
| p | A hónap számként jelenik meg kezdő nulla nélkül (1-12). Ha m azonnal követi, h vagy hha 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 hha hónap helyett perc jelenik meg. |
| mmm | A hónap megjelenítése rövidítésként (január-dec). Lokalizált. |
| Mmmm | A hónap megjelenítése teljes hónapnévként (január-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). |
| yyyyy | Az év megjelenítése 4 jegyű számként (100-9999). |
| ó | 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 a következő 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 amerika 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" |
Cs | Ajánlott |
"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 |