Compartilhar via


Função FORMAT

Converte um valor em texto de acordo com o formato especificado.

Sintaxe

FORMAT(<value>, <format_string>)

Parâmetros

Termo

Definição

value

Um valor ou expressão que avalia como um valor único.

format_string

Uma cadeia de caracteres com o modelo de formatação.

Valor de retorno

Uma cadeia de caracteres que contém value formatada conforme definido por format_string.

Observação importanteImportante

Se value for BLANK(), a função retornará uma cadeia de caracteres vazia.

Se format_string for BLANK (), o valor será formatado com um formato "Número Geral" ou "Data Geral" (de acordo com o tipo de valor).

Comentários

Para obter informações sobre como usar o parâmetro format_string, consulte o tópico apropriado listado abaixo:

Para formatar

Siga estas instruções

Números

Use formatos numéricos predefinidos ou crie formatos numéricos definidos pelo usuário.

Datas e horas

Use formatos de data/hora predefinidos ou crie formatos de data/hora definidos pelo usuário.

Todas as cadeias de caracteres de formatação predefinidas usam a localidade do usuário atual ao formatar o resultado.

Observação sobre cuidadosCuidado

As cadeias de formato que têm suporte como um argumento para a função FORMAT do DAX são baseadas nas cadeias de formato usadas pelo Visual Basic (Automação OLE), não nas cadeias de formado usadas pelo .NET Framework. Portanto, você poderá obter resultados inesperados ou um erro se o argumento não corresponder a qualquer cadeia de formato definido. Por exemplo, "p" como uma abreviação porque não há suporte para "Porcentagem". As cadeias de caracteres que você fornece como um argumento à função FORMAT que não estão incluídas na lista de cadeias de formato predefinidas são tratadas como parte de uma cadeia de formato personalizada ou como uma literal de cadeia de caracteres.

Esta função DAX não tem suporte para uso no modo DirectQuery. Para obter mais informações sobre limitações nos modelos DirectQuery, consulte https://go.microsoft.com/fwlink/?LinkId=219172.

Consulte também

Referência

Formatos numéricos predefinidos para a função FORMAT

Formatos numéricos personalizados para a função FORMAT

Formatos predefinidos de data e hora para a função FORMAT

Personalizar formatos de data e hora para a função FORMAT

Função VALUE