IFERROR
Aplica-se a: Coluna calculada Tabela calculada Medida Cálculo visual
Avalia uma expressão e retorna um valor especificado se a expressão retornar um erro; caso contrário, retorna o valor da própria expressão.
Sintaxe
IFERROR(value, value_if_error)
Parâmetros
Termo | Definição |
---|---|
valor | Qualquer valor ou expressão. |
value_if_error | Qualquer valor ou expressão. |
Valor devolvido
Um escalar do mesmo tipo que o valor
Observações
Você pode usar a função IFERROR para intercetar e manipular erros em uma expressão.
Se value ou value_if_error for uma célula vazia, IFERROR a tratará como um valor de cadeia de caracteres vazia ("").
A função IFERROR é baseada na função IF e usa as mesmas mensagens de erro, mas tem menos argumentos. A relação entre a função IFERROR e a função SE da seguinte forma:
IFERROR(A,B) := IF(ISERROR(A), B, A)
Os valores retornados para A e B devem ser do mesmo tipo de dados; Portanto, a coluna ou expressão usada para Value e o valor retornado para value_if_error devem ser do mesmo tipo de dados.
Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).
Para obter as práticas recomendadas ao usar IFERROR, consulte Uso apropriado de funções de erro.
Exemplo
O exemplo a seguir retorna 9999 se a expressão 25/0 for avaliada como um erro. Se a expressão retornar um valor diferente de error, esse valor será passado para a expressão que invoca.
= IFERROR(25/0,9999)