Share via


ABS (Transact-SQL)

Uma função matemática que retorna o valor absoluto (positivo) da expressão numérica especificada.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

ABS ( numeric_expression )

Argumentos

  • numeric_expression
    É uma expressão da categoria de tipo de dados numéricos exatos ou aproximados, com exceção do tipo de dados bit.

Tipos de retorno

Retorna o mesmo tipo que numeric_expression.

Exemplos

O exemplo a seguir mostra os resultados do uso da função ABS em três números diferentes.

SELECT ABS(-1.0), ABS(0.0), ABS(1.0)

Aqui está o conjunto de resultados.

---- ---- ----
1.0  .0   1.0

A função ABS pode produzir um erro de estouro quando o valor absoluto de um número é maior que o maior número que pode ser representado pelo tipo de dados especificado. Por exemplo, o tipo de dados int só pode conter valores que variam de 2,147,483,648 a 2,147,483,647. Computar o valor absoluto para o inteiro assinado 2,147,483,648 causa um erro de estouro porque seu valor absoluto é maior do que o intervalo positive para o tipo de dados int.

DECLARE @i int;
SET @i = -2147483648;
SELECT ABS(@i);
GO

Esta é a mensagem de erro:

“Mensagem 8115, Nível 16, Estado 2, Linha 3"

"Erro de estouro aritmético ao converter a expressão em dados tipo int".