Função FORMATEX

Retorna o resultado da expressão avaliada no srcUnit como uma cadeia de caracteres formatada de acordo com o formato expresso no dstUnit.

Sintaxe

FORMATEX(expression", format "[ srcUnit ],[ dstUnit ],[ langID ][, calID ])

Parâmetros

Name	Obrigatório/opcional	Tipo de dados	Descrição
expression	Obrigatório	String	Uma combinação de constantes, operadores, funções e referências a células ShapeSheet que resulta em um valor.
format	Obrigatório	String	A imagem de formato usada para formatar a cadeia de caracteres. Para obter mais informações sobre imagens de formato, consulte Sobre Formatar Imagens.
srcUnit	Opcional	String	Unidades usadas para avaliar a expression (pol, cm, etc.).
dstUnit	Opcional	String	Unidades usadas para o resultado de expression (pol, cm, etc.).
Langid	Opcional	Número	O idioma usado ao formatar as imagens de data/hora do Microsoft Office System.
calID	Opcional	Número	O calendário usado ao formatar as imagens de data/hora do Microsoft Office System.

Valor de retorno

Cadeia de caracteres

Comentários

O tipo da expressão e o tipo especificado na figura de formatação determinam o comportamento da cadeia de caracteres retornada. O format deve ser adequado para o texto da expressão.

O argumento srcUnit é usado para dimensionar resultados de expressão não digitada, como 3 + 4. Se o resultado de expression possuir um texto explícito, como 3 pés + 8 pés, então srcUnit será ignorada.

O argumento dstUnit é usado para especificar as unidades usadas para o resultado formatado. Se dstUnit não for especificado, as unidades para o resultado da expressão serão usadas.

Retorna um erro se o resultado de expression e o texto esperado em format forem de um tipo diferente, se houver erros de sintaxe em format ou se as unidades srcUnit ou dstUnit não forem reconhecidas.

Exemplo

FORMATEX(5,5, "0,00 u", "cm", "pés")

Retorna 0,18 pés.