POWER (Transact-SQL)

Artigo
05/19/2015

Retorna o valor da expressão especificada elevada à potência especificada.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

POWER ( float_expression , y )

Argumentos

float_expression
É uma expressão do tipo float ou de um tipo que pode ser convertido implicitamente em float.
y
É a potência à qual float_expression deve ser elevada. y pode ser uma expressão da categoria de tipo de dados numérica exata ou aproximada, com exceção do tipo de dados bit.

Tipos de retorno

Retorna o mesmo tipo enviado em float_expression. Por exemplo, se decimal(2,0) for enviado como float_expression, o resultado retornado será decimal(2,0).

Exemplos

A.Usando POWER para retornar o cubo de um número

O exemplo a seguir demonstra a elevação de um número à potência 3 (o cubo do número).

DECLARE @input1 float;
DECLARE @input2 float;
SET @input1= 2;
SET @input2 = 2.5;
SELECT POWER(@input1, 3) AS Result1, POWER(@input2, 3) AS Result2;

Aqui está o conjunto de resultados.

Result1                Result2
---------------------- ----------------------
8                      15.625

(1 row(s) affected)

B.Usando POWER para mostrar os resultados da conversão de tipo de dados

O exemplo a seguir mostra como float_expression preserva o tipo de dados que pode retornar resultados inesperados.

SELECT 
POWER(CAST(2.0 AS float), -100.0) AS FloatResult,
POWER(2, -100.0) AS IntegerResult,
POWER(CAST(2.0 AS int), -100.0) AS IntegerResult,
POWER(2.0, -100.0) AS Decimal1Result,
POWER(2.00, -100.0) AS Decimal2Result,
POWER(CAST(2.0 AS decimal(5,2)), -100.0) AS Decimal2Result;
GO

Aqui está o conjunto de resultados.

FloatResult            IntegerResult IntegerResult Decimal1Result Decimal2Result Decimal2Result
---------------------- ------------- ------------- -------------- -------------- --------------
7.88860905221012E-31   0             0             0.0            0.00           0.00

C.Usando POWER

O exemplo a seguir retorna os resultados de POWER para 2.

DECLARE @value int, @counter int;
SET @value = 2;
SET @counter = 1;

WHILE @counter < 5
   BEGIN
      SELECT POWER(@value, @counter)
      SET NOCOUNT ON
      SET @counter = @counter + 1
      SET NOCOUNT OFF
   END;
GO

Aqui está o conjunto de resultados.

----------- 
2           

(1 row(s) affected)

----------- 
4           

(1 row(s) affected)

----------- 
8           

(1 row(s) affected)

----------- 
16          

(1 row(s) affected)