ASIN (Transact-SQL)

適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) Microsoft Fabric のSQL 分析エンドポイント Microsoft Fabric のウェアハウス

角度 (ラジアン) を返す関数。サインは、指定された float 式です。 これは、アークサイン (逆正弦) とも呼ばれます。

Transact-SQL 構文表記規則

構文

ASIN ( float_expression )  

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

float_expression
float 型、または暗黙的に float 型に変換できる式を指定します。 -1.00 ～ 1.00 の範囲の値のみが有効です。 この範囲外の値については、値は返されず、ASIN からはドメイン エラーが報告されます。

戻り値の型

float

例

次の例は、float 式と、指定された角度の ASIN 値を返します。

/* The first value will be -1.01. This fails because the value is   
outside the range.*/  
DECLARE @angle FLOAT  
SET @angle = -1.01  
SELECT 'The ASIN of the angle is: ' + CONVERT(VARCHAR, ASIN(@angle))  
GO  
  
-- The next value is -1.00.  
DECLARE @angle FLOAT  
SET @angle = -1.00  
SELECT 'The ASIN of the angle is: ' + CONVERT(VARCHAR, ASIN(@angle))  
GO  
  
-- The next value is 0.1472738.  
DECLARE @angle FLOAT  
SET @angle = 0.1472738  
SELECT 'The ASIN of the angle is: ' + CONVERT(VARCHAR, ASIN(@angle))  
GO  

結果セットは次のようになります。

-------------------------  
.Net SqlClient Data Provider: Msg 3622, Level 16, State 1, Line 3  
A domain error occurred.  
  
---------------------------------   
The ASIN of the angle is: -1.5708                          
  
(1 row(s) affected)  
  
----------------------------------   
The ASIN of the angle is: 0.147811                         
  
(1 row(s) affected)  

例: Azure Synapse Analytics、Analytics Platform System (PDW)

この例では、1.00 のアークサインが返されます。

SELECT ASIN(1.00) AS asinCalc;  

次の例では、許容範囲外の値のアークサインを要求しているため、エラーが返ります。

SELECT ASIN(1.1472738) AS asinCalc;  

関連項目

CEILING (Transact-SQL)
数学関数 (Transact-SQL)
SET ARITHIGNORE (Transact-SQL)
SET ARITHABORT (Transact-SQL)