ABS (Transact-SQL)

Aplica-se a:yesSQL Server (todas as versões compatíveis) YesBanco de Dados SQL do Azure YesInstância Gerenciada de SQL do Azure yesAzure Synapse Analytics yesAnalytics Platform System (PDW)

Uma função matemática que retorna o valor absoluto (positivo) da expressão numérica especificada. (ABS altera valores negativos para valores positivos. ABS não tem efeito em valores zero ou positivos.)

Topic link iconConvenções de sintaxe do Transact-SQL

Sintaxe

ABS ( numeric_expression )  

Observação

Para ver a sintaxe do Transact-SQL para o SQL Server 2014 e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

numeric_expression
Uma expressão da categoria de tipo de dados numéricos exatos ou aproximados.

Tipos de retorno

Retorna o mesmo tipo que numeric_expression.

Exemplos

Este exemplo 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);  

Este é 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 excede o maior número que o tipo de dados especificado pode representar. Por exemplo, o tipo de dados int tem um intervalo de valor entre -2,147,483,648 e 2,147,483,647. O cálculo do valor absoluto para o inteiro com sinal -2,147,483,648 causará um erro de estouro porque seu valor absoluto excede o limite positivo do intervalo do tipo de dados int.

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

Retorna essa 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".

Confira também

CAST e CONVERT (Transact-SQL)
Tipos de dados (Transact-SQL)
Funções matemáticas (Transact-SQL)
Funções internas (Transact-SQL)