FORMAT

Converteert een waarde naar tekst volgens de opgegeven notatie.

Syntaxis

FORMAT(<value>, <format_string>[, <locale_name>])

Parameters

Term Definitie
waarde Een waarde of expressie die wordt geëvalueerd naar een enkele waarde.
format_string Een tekenreeks met de opmaaksjabloon.
locale_name (Optioneel) Naam van de locale die door de functie moet worden gebruikt. Mogelijke waarden zijn tekenreeksen die worden geaccepteerd door Windows API-functie LocaleNameToLCID().

Retourwaarde

Een tekenreeks met value opgemaakt zoals gedefinieerd door format_string.

Notitie

Als value BLANK is, wordt een lege tekenreeks geretourneerd.

Als format_string BLANK is, wordt de waarde opgemaakt met de notatie 'algemeen getal' of 'algemene datum' (overeenkomstig het gegevenstype van value).

Opmerkingen

  • Vooraf gedefinieerde opmaakreeksen gebruiken de eigenschap modelcultuur bij het opmaken van het resultaat. Standaard wordt de eigenschap modelcultuur ingesteld op basis van de landinstelling van de gebruiker van de computer. Voor nieuwe Power BI Desktop-modellen kan de eigenschap modelcultuur worden gewijzigd in > Opties Regionaal Instellingen > Modeltaal. Voor Analysis Services wordt de modelcultuur ingesteld op basis van de eigenschap Language die in eerste instantie is gedefinieerd.

  • De opmaakreeksen die worden ondersteund als een argument voor de DAX-functie FORMAT, zijn gebaseerd op de opmaakreeksen die worden gebruikt door Visual Basic (OLE Automation), niet op de opmaakreeksen die worden gebruikt door .NET Framework. Daarom is het mogelijk dat er onverwachte resultaten of een fout optreden als het argument niet overeenkomt met een gedefinieerde opmaakreeks. Zo wordt 'p' als afkorting voor 'procent' bijvoorbeeld niet ondersteund. Tekenreeksen die u opgeeft als een argument voor de functie FORMAT die niet zijn opgenomen in de lijst met vooraf gedefinieerde tekenreeksen, worden verwerkt als onderdeel van een aangepaste tekenreeksnotatie of als een letterlijke tekenreeks.

  • Bekijk deze video voor meer informatie over het opgeven van een taal met FORMAT.

  • Deze functie wordt niet ondersteund voor gebruik in de DirectQuery-modus wanneer deze wordt gebruikt in berekende kolommen of veiligheidsregels (RLS) op rijniveau.

Voorbeelden

Tekenreeksen opmaken

= 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")

Retourneert:

12345,67 'Algemeen getal' geeft het getal zonder notatie weer.

$12.345,67 'Valuta' geeft het getal weer met de valutanotatie van uw landinstellingen. Deze sample geeft de standaardvalutanotatie weer voor de Verenigde Staten.

12345,67 'Vast' geeft ten minste één cijfer links en twee cijfers rechts van het decimaalteken weer.

12.345,67 'Standaard' geeft ten minste één cijfer links en twee cijfers rechts van het decimaalteken weer en bevat scheidingstekens voor duizendtallen. De steekproef hier geeft de standaardgetalnotatie weer voor de Verenigde Staten.

1.234.567,00 % 'Procent' geeft het getal weer als een percentage (vermenigvuldigd met 100), met notatie en het procentteken rechts naast het getal, gescheiden met één spatie.

1,23E+04 'Wetenschappelijk' geeft het getal weer in de wetenschappelijke notatie, met twee cijfers achter de komma.

Datum/tijd met optionele 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" )

Retourneert:

15-12-2020 12:30:59 uur Waarbij maand voorafgaat aan dag en tijd de 12-uursnotatie is.

12-15-2020 12:30:59 Waarbij dag voorafgaat aan maand en tijd een 24-uursnotatie is.

15-12-2020 12:30:59 Waarbij maand voorafgaat aan dag en tijd een 24-uursnotatie is. Omdat een afhankelijke notatiereeks voor niet-lokale landen is opgegeven, wordt de lokatie niet toegepast en wordt de notatie niet-lokale indeling geretourneerd.

Vooraf gedefinieerde numerieke notaties

De volgende vooraf gedefinieerde numerieke notaties kunnen worden opgegeven in het argument format_string:

Indeling Beschrijving
"General Number" Geeft een getal weer zonder scheidingsteken voor duizendtallen.
"Currency" Geeft een getal weer met scheidingstekens voor duizendtallen, indien van toepassing, en twee cijfers rechts van het decimaalteken. De uitvoer is gebaseerd op de landinstellingen van het systeem.
"Fixed" Geeft een getal weer met ten minste één cijfer links en twee cijfers rechts van het decimaalteken.
"Standard" Geeft een getal weer met scheidingstekens voor duizendtallen en ten minste één cijfer links en twee cijfers rechts van het decimaalteken.
"Percent" Geeft een getal weer, vermenigvuldigd met 100 en een procentteken (%) erachter, en altijd twee cijfers rechts van het decimaalteken.
"Scientific" Gebruikt een standaard wetenschappelijke notatie, met twee significante cijfers.
"Yes/No" Geeft NO weer als getal 0 is; anders wordt YES weergegeven.
"True/False" Geeft FALSE weer als getal 0 is; anders wordt TRUE weergegeven.
"On/Off" Geeft OFF weer als getal 0 is; anders wordt ON weergegeven.

Aangepaste getalnotaties

Een aangepaste gedefinieerde expressie voor de notatie van getallen kan bestaan uit één tot drie secties, van elkaar gescheiden door puntkomma's. Als het notatiereeksargument een van de vooraf gedefinieerde numerieke notaties bevat, is maar één sectie toegestaan.

Als u gebruikmaakt van Het resultaat is
Niet meer dan één sectie De notatie-expressie is van toepassing op alle waarden.
Twee secties De eerste sectie is van toepassing op positieve waarden en nul, de tweede op negatieve waarden.
Drie secties De eerste sectie is van toepassing op positieve waarden, de tweede op negatieve waarden en de derde op nullen.
"$#,##0;($#,##0)"

Als u puntkomma's gebruikt zonder hier iets tussen te zetten, wordt de ontbrekende sectie gedefinieerd in de indeling van de positieve waarde. In de volgende notatie worden bijvoorbeeld positieve en negatieve waarden weergegeven met de notatie in de eerste sectie en wordt Nul weergegeven als de waarde nul is.

"$#,##0"

Als u puntkomma's gebruikt zonder hier iets tussen te zetten, wordt de ontbrekende sectie gedefinieerd in de indeling van de positieve waarde.

Tekens van aangepaste numerieke notaties

De volgende aangepaste tekens voor numerieke notaties kunnen worden opgegeven in het argument format_string:

Teken Beschrijving
Geen Het getal zonder opmaak weergeven.
(0) Tijdelijke aanduiding voor cijfer. Een cijfer of een nul weergeven. Als de expressie een cijfer heeft op de positie waar de 0 wordt weergegeven in de notatietekenreeks, deze weergeven. U kunt ook een nul op die positie weergeven. Als het getal minder cijfers heeft dan er nullen zijn (aan beide zijden van het decimaalteken) in de notatie-expressie, worden de verloopnullen of volgnullen weergegeven. Als het getal rechts van het decimaalteken meer cijfers bevat dan nullen rechts van het decimaalteken in de notatie-expressie, het getal afronden op zo veel decimaalposities als er nullen zijn. Als het getal links van het decimaalteken meer cijfers bevat dan nullen links van het decimaalteken in de notatie-expressie, de extra cijfers weergeven zoals ze zijn.
(#) Tijdelijke aanduiding voor cijfer. Een cijfer of niets weergeven. Als de expressie een cijfer bevat op de positie waar de # wordt weergegeven in de notatietekenreeks, dat cijfer weergeven, anders niets op die positie weergeven. Dit symbool werkt zoals de tijdelijke aanduiding voor het cijfer 0, behalve dat er geen voorloop- en volgnullen worden weergegeven als het getal evenveel of minder cijfers bevat dan #-tekens links of rechts van het decimaalteken in de notatie-expressie.
(.) Tijdelijke aanduiding voor decimalen. In sommige landen wordt een komma gebruikt als decimaalteken. De tijdelijke aanduiding voor decimalen bepaalt hoeveel cijfers er links en rechts van het decimaalteken worden weergegeven. Als de notatie-expressie alleen hekjes bevat links van dit symbool, beginnen getallen die kleiner zijn dan 1 met een decimaalteken. Als u een voorloopnul wilt weergeven voor breuken, gebruikt u 0 als tijdelijke aanduiding voor het eerste cijfer links van het decimaalteken. Het werkelijke teken dat wordt gebruikt als tijdelijke aanduiding voor decimalen in de opgemaakte uitvoer is afhankelijk van de getalnotatie die wordt herkend door uw systeem.
(%) Tijdelijke aanduiding voor percentage. De expressie wordt vermenigvuldigd met 100. Het procentteken ( % ) wordt ingevoegd op de positie waar het staat in de notatietekenreeks.
(,) Scheidingsteken voor duizendtallen. In sommige landen wordt een punt gebruikt als scheidingsteken voor duizendtallen. Het scheidingsteken voor duizendtallen scheidt duizendtallen van honderdtallen in een getal met vier of meer cijfers links van het decimaalteken. Standaardgebruik van het scheidingsteken voor duizendtallen wordt opgegeven als de notatie een scheidingsteken bevat dat is omgeven door tijdelijke aanduidingen voor cijfers (0 of # ). Twee aangrenzende scheidingstekens voor duizendtallen of een scheidingsteken voor duizendtallen direct links van het decimaalteken (ongeacht of er een decimaal is opgegeven) betekent 'het getal schalen door het te delen door 1000, naar behoefte afgerond'. U kunt bijvoorbeeld de notatiereeks ##0 gebruiken om 100.000.000.000 weer te geven als 100. Getallen die kleiner zijn dan 1.000.000 worden weergegeven als 0. Twee aangrenzende scheidingstekens voor duizendtallen op een andere positie dan direct links van het decimaalteken worden behandeld als het gebruik van een scheidingsteken voor duizendtallen. Het werkelijke teken dat wordt gebruikt als scheidingsteken voor duizendtallen in de opgemaakte uitvoer is afhankelijk van de getalnotatie die wordt herkend door uw systeem.
(:) Tijdscheidingsteken. In sommige landen kunnen andere tekens worden gebruikt als tijdscheidingsteken. Het tijdscheidingsteken wordt gebruikt om uren, minuten en seconden te scheiden bij het opmaken van tijdwaarden. Het werkelijke teken dat wordt gebruikt als tijdscheidingsteken in de opgemaakte uitvoer wordt bepaald door de systeeminstellingen.
(/) Datumscheidingsteken. In sommige landen kunnen andere tekens worden gebruikt als datumscheidingsteken. Het datumscheidingsteken wordt gebruikt om de dag, de maand en het jaar te scheiden bij het opmaken van datumwaarden. Het werkelijke teken dat wordt gebruikt als datumscheidingsteken in de opgemaakte uitvoer wordt bepaald door de systeeminstellingen.
(E- E+ e- e+ ) Wetenschappelijke notatie. Als de notatie-expressie ten minste één tijdelijke aanduiding voor een cijfer (0 of # ) rechts van E-, E+, e- of e+ bevat, wordt het getal weergegeven in de wetenschappelijke notatie en wordt E of e ingevoegd tussen het getal en de exponent. Het aantal tijdelijke aanduidingen voor cijfers aan de rechterkant bepaalt het aantal cijfers in de exponent. Gebruik E- of e- voor het plaatsen van een minteken naast negatieve exponenten. Gebruik E+ of e+ voor het plaatsen van een minteken naast negatieve exponenten en een plusteken naast positieve exponenten.
- + $ ( ) Een literal-teken weergeven. Als u een ander teken dan een van de vermelde tekens wilt weergeven, plaatst u een backslash (\) ervoor of plaatst u het tussen dubbele aanhalingstekens (" ").
(\) Het volgende teken in de notatietekenreeks weergeven. Als u een teken met een speciale betekenis als teken voor een letterlijke waarde wilt weergeven, plaatst u een backslash (\) ervoor. De backslash zelf wordt niet weergegeven. Een backslash gebruiken is hetzelfde als het volgende teken tussen dubbele aanhalingstekens plaatsen. Als u een backslash wilt weergeven, gebruikt u twee backslashes (\\). Voorbeelden van tekens die niet kunnen worden weergegeven als tekens voor letterlijke waarde zijn de tekens voor het opmaken van datum- en tijdnotaties (a, c, d, h, m, n, p, q, s, t, w, y, / en :), de tekens voor het opmaken van getalnotaties (#, 0, %, E, e, komma en punt), en de tekens voor het opmaken van tekenreeksen (@, &, <, > en !).
(ABC) De tekenreeks tussen dubbele aanhalingstekens (" ") weergeven.

Vooraf gedefinieerde datum-/tijdnotaties

De volgende vooraf gedefinieerde datum-/tijdnotaties kunnen worden opgegeven in het argument format_string. Bij gebruik van andere notaties worden deze geïnterpreteerd als een aangepaste datum-/tijdnotatie:

Indeling Beschrijving
"General Date" Hiermee wordt een datum en/of tijd weergegeven. Bijvoorbeeld 3/12/2008 11:07:31 AM. De datumweergave wordt bepaald door de huidige cultuurwaarde van uw toepassing.
"Long Date" of "Medium Date" Hiermee wordt een datum weergegeven volgens de lange datumnotatie van uw huidige cultuurwaarde. Bijvoorbeeld woensdag, 12 maart 2008.
"Short Date" Hiermee wordt een datum weergegeven volgens de korte datumnotatie van uw huidige cultuurwaarde. Bijvoorbeeld 3/12/2008.
"Long Time" of Hiermee wordt een tijd weergegeven volgens de lange datumnotatie van uw huidige cultuurwaarde; doorgaans is dit met inbegrip van uren, minuten en seconden. Bijvoorbeeld 11:07:31 AM.
"Medium Time" Hiermee wordt een tijd in 12-uursnotatie weergegeven. Bijvoorbeeld 11:07 AM.
"Short Time" Hiermee wordt een tijd in 24-uursnotatie weergegeven. Bijvoorbeeld 11:07.

Aangepaste datum-/tijdnotaties

De volgende tekens voor notaties kunnen worden opgegeven in de format_string voor een datum-/tijdnotatie:

Teken Beschrijving
(:) Tijdscheidingsteken. In sommige landen kunnen andere tekens worden gebruikt als tijdscheidingsteken. Het tijdscheidingsteken wordt gebruikt om uren, minuten en seconden te scheiden bij het opmaken van tijdwaarden. Het werkelijke teken dat wordt gebruikt als tijdscheidingsteken in de opgemaakte uitvoer wordt bepaald door de systeeminstellingen.
(/) Datumscheidingsteken. In sommige landen kunnen andere tekens worden gebruikt als datumscheidingsteken. Het datumscheidingsteken wordt gebruikt om de dag, de maand en het jaar te scheiden bij het opmaken van datumwaarden. Het werkelijke teken dat wordt gebruikt als datumscheidingsteken in de opgemaakte uitvoer wordt bepaald door de systeeminstellingen.
(\) Backslash. Geeft het volgende teken weer als een literal-teken. Dit wordt dus niet geïnterpreteerd als een opmaakteken.
(") Dubbele aanhalingstekens. Tekst tussen dubbele aanhalingstekens wordt weergegeven. Dit wordt dus niet geïnterpreteerd als opmaaktekens.
c De datum weergeven als ddddd en de tijd als ttttt, in die volgorde. Alleen datumgegevens weergeven als het serienummer van de datum geen fractioneel deel bevat; alleen tijdgegevens weergeven als er geen gedeelte met een geheel getal is.
d De dag weergeven als een getal zonder voorloopnul (1-31).
dd De dag weergeven als een getal met voorloopnul (01-31).
ddd De dag weergeven als een afkorting (zo-za). Gelokaliseerd.
dddd De dag weergeven als een volledige naam (zondag-zaterdag). Gelokaliseerd.
ddddd De datum weergeven als een volledige datum (inclusief dag, maand en jaar), genoteerd volgens de instelling voor de korte datumnotatie van uw systeem. De standaard korte datumnotatie is mm/dd/yyyy.
dddddd Een geldig datumserienummer weergeven als een volledige datum (inclusief dag, maand en jaar) op basis van de instelling voor lange datumnotatie die door uw systeem wordt herkend. De standaardnotatie voor lange datums is dddd, mmmm d, yyyy.
w De dag van de week weergeven als een getal (1 voor zondag tot en met 7 voor zaterdag).
ww De week van het jaar weergeven als een getal (1-54).
m De maand weergeven als een getal zonder voorloopnul (1-12). Als m direct volgt op h of hh, wordt de minuut weergegeven in plaats van de maand.
mm De maand weergeven als een getal met een voorloopnul (01-12). Als mm direct volgt op h of hh, wordt de minuut weergegeven in plaats van de maand.
mmm De maand weergeven als een afkorting (jan-dec). Gelokaliseerd.
mmmm De maand weergeven als een volledige naam (januari-december). Gelokaliseerd.
q Het kwartaal van het jaar weergeven als een getal (1-4).
y De dag van het jaar weergeven als een getal (1-366).
yy Het jaar weergeven als een getal van 2 cijfers (00-99).
yyyy Het jaar weergeven als een getal van 4 cijfers (100-9999).
h Het uur weergeven als een getal zonder een voorloopnul (0-23).
hh Het uur weergeven als een getal met voorloopnul (00-23).
n De minuut weergeven als een getal zonder voorloopnul (0-59).
nn De minuut weergeven als een getal met voorloopnul (00-59).
s De seconde weergeven als een getal zonder voorloopnul (0-59).
ss De seconde weergeven als een getal met voorloopnul (00-59).
ttttt Een tijd weergeven als een volledige tijd (inclusief uur, minuut en seconde), opgemaakt met het tijdscheidingsteken dat is gedefinieerd door de tijdnotatie die door uw systeem wordt herkend. Een vooraanstaand nul wordt weergegeven als de vooraandnllen optie is geselecteerd en de tijd vóór 10:00 uur of P.M. De standaardnotatie voor tijd is h:mm:ss.
AM/PM De 12-uurs klok gebruiken en AM in hoofdletters weergeven bij elk uur vóór 12 uur 's middags en PM in hoofdletters bij elk uur tussen twaalf uur 's middags en 23:59 uur.
am/pm Gebruik de 12-uurs klok en geef am weer in kleine letters bij tijden vóór 12 uur 's middags en geef pm in kleine letters weer voor tijden tussen twaalf uur 's middags en 11:59 pm.
A/P Gebruik de 12-uurs klok en geef een hoofdletter A weer bij tijden vóór 12 uur 's middags. Geef een hoofdletter P weer voor tijden tussen twaalf uur 's middags en 11:59 PM.
a/p Gebruik de 12-uurs klok en geef een kleine letter A weer bij tijden vóór 12 uur 's middags. Geef een hoofdletter P weer voor tijden tussen twaalf uur 's middags en 11:59 PM.
AMPM Gebruik de 12-uurs klok en geef de letterlijke AM-tekenreeks weer zoals gedefinieerd door uw systeem, met elk uur vóór 12 uur 's middags; de letterlijke tekenreeks pm weergeven zoals gedefinieerd door uw systeem met elk uur tussen 12.00 uur en 23.59 uur. AMPM kan hoofdletters of kleine letters zijn, maar het hoofdletter van de weergegeven tekenreeks komt overeen met de tekenreeks zoals gedefinieerd door de systeeminstellingen. De standaardnotatie is AM/PM. Als uw systeem is ingesteld op een 24-uurs klok, is de tekenreeks standaard ingesteld op een lege tekenreeks.

De notatie voor datum/tijd maakt gebruik van de huidige landinstellingen voor de gebruiker voor de notatie van de tekenreeks. Neem bijvoorbeeld deze datum: 25 juni 2020. Wanneer de datum is opgemaakt met de notatietekenreeks m/d/jjjj, wordt het:

  • Landinstellingen voor de gebruiker: Verenigde Staten van America (en-US): 6/25/2020
  • Landinstellingen voor de gebruiker: Duitsland (de-DE): 6.25.2020

Voorbeelden van aangepaste datum-/tijdnotaties

In de volgende voorbeelden wordt deze datum/tijd gebruikt: donderdag 25 juni 2020, om 1:23:45 PM. Duitsland (de-DE) gebruikt een systeem van 24 uur. Er is geen equivalent voor AM/PM.

Indeling Resultaat (en-US) Resultaat (de-DE)
"c" 06/25/2020 13:23:45 25.06.2020 13:23:45
"d" 25 25
"dd" 25 25
"ddd" Do Wel doen
"dddd" Donderdag Donnerstag
"ddddd" 06/25/2020 25.06.2020
"dddddd" Donderdag 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" Jaar 2020 Jaar 2020
"yyyy \Qq" 2020 Kw2 2020 Kw2
"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 PM 1:23:45
"hh:nn:ss" 13:23:45 13:23:45
"hh:nn:ss AMPM" 01:23:45 PM 01:23:45
"ttttt" 13:23:45 13:23:45
"ttttt AMPM" 13:23:45 PM 13:23:45
"mm/dd/yyyy hh:nn:ss AMPM" 06/25/2020 01:23:45 PM 6.25.2020 01:23:45