FORMAT Function (DAX)

Converts a value to text according to the specified format.

Syntax

FORMAT(<value>, <format_string>)

Parameters

Term

Definition

value

A value or expression that evaluates to a single value.

format_string

A string with the formatting template.

Return Value

A string containing value formatted as defined by format_string.

Remarks

For information on how to use the format_string parameter, see the appropriate topic listed below:

To Format

Follow these instructions

Numbers

Use predefined numeric formats or create user-defined numeric formats.

Dates and times

Use predefined date/time formats or create user-defined date/time formats.

All predefined formatting strings use the current user locale when formatting the result.

Warning

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.