Compartilhar via


IFERROR

aplica-se a:coluna calculadatabela calculadamedidacá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 ou value_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 para value_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)

Funções lógicas