ASIN (Transact-SQL)

  • [アーティクル]

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics 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)