FORMAT DAX Function (Text)

Converts a value to text in the specified number format.


FORMAT ( <Value>, <Format> )
Parameter Attributes Description

A number, or a formula that evaluates to a numeric value.


A number format that you specify.

Return values

Scalar A single string value.

A string containing Value formatted as defined by Format string.
The result is always a string, even when the value is blank.


For information on how to use the Format string parameter:

The format strings supported as an argument to the DAX FORMAT function are based on the format strings used by Visual Basic (OLE Automation), not on the format strings used by the .NET Framework. Therefore, you might get unexpected results or an error if the argument does not match any defined format strings. For example, “p” as an abbreviation for “Percent” is not supported. Strings that you provide as an argument to the FORMAT function that are not included in the list of predefined format strings are handled as part of a custom format string, or as a string literal.

In order to make sure a literal is not interpreted as a format string, embed the literal between double quotes as in the examples.


FORMAT ( 0.742, "Percent" )                    -- Returns 74.20%
FORMAT ( 1234.567, "$#,0.00" )                 -- Returns $1,234.57 
FORMAT ( 1234.567, """US$"" #,0.00" )          -- Returns US$ 1,234.57 
FORMAT ( DATE ( 2019, 3, 28 ), "yyyy-mm-dd" )  -- Returns 2019-03-28
FORMAT ( DATE ( 2019, 3, 28 ), "m/d/yy" )      -- Returns 3/28/19

Related articles

Learn more about FORMAT in the following articles:

Last update: Nov 20, 2020   » Contribute   » Show contributors

Contributors: Alberto Ferrari, Marco Russo

MSDN documentation:

Cyber Monday
2018-2020 © SQLBI. All rights are reserved. Information coming from MSDN is property of Microsoft Corp. » Contact us   » Privacy Policy & Cookies

Context Transition

This function performs a Context Transition if called in a Row Context. Click to read more.

Row Context

This expression is executed in a Row Context. Click to read more.


Not recommended

The use of this function is not recommended. See Remarks and Related functions for alternatives.

Not recommended

The use of this parameter is not recommended.


This function is deprecated. Jump to the Alternatives section to see the function to use.


This parameter is deprecated and its use is not recommended.

DirectQuery compatibility

Limitations are placed on DAX expressions allowed in measures and calculated columns.
The state below shows the DirectQuery compatibility of the DAX function.


Want to improve the content of FORMAT? Did you find any issue?
Please, report it us! All submissions will be evaluated for possible updates of the content.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.