Partilhar 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ópico Convenções da sintaxe Transact-SQL

Sintaxe

ABS ( numeric_expression )

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

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

Consulte também

Referência

CAST e CONVERT (Transact-SQL)

Tipos de dados (Transact-SQL)

Funções matemáticas (Transact-SQL)

Funções internas (Transact-SQL)