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 retorna um erro; caso contrário, retorna o valor da própria expressão.
Sintaxe
IFERROR(value, value_if_error)
Parâmetros
Prazo | Definição |
---|---|
value |
Qualquer valor ou expressão. |
value_if_error |
Qualquer valor ou expressão. |
Valor de retorno
Um escalar do mesmo tipo que value
Observações
Você pode usar a função IFERROR para interceptar e manipular erros em uma expressão.
Se
value
ouvalue_if_error
for uma célula vazia, IFERROR a tratará como um valor de cadeia de caracteres vazio ("").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 IF da seguinte maneira:
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 paravalue_if_error
devem ser do mesmo tipo de dados.Essa função não tem suporte para uso no modo DirectQuery quando usada em colunas calculadas ou regras de RLS (segurança em nível de linha).
Para obter práticas recomendadas ao usar IFERROR, consulte Uso apropriado de funções de erro.
Exemplo
O exemplo a seguir retornará 9999 se a expressão 25/0 for avaliada como um erro. Se a expressão retornar um valor diferente de erro, esse valor será passado para a expressão de invocação.
= IFERROR(25/0,9999)