ASIN (Transact-SQL)

Applies to: 👁 Image
SQL Server 👁 Image
Azure SQL Database 👁 Image
Azure SQL Managed Instance 👁 Image
Azure Synapse Analytics 👁 Image
Analytics Platform System (PDW) 👁 Image
SQL analytics endpoint in Microsoft Fabric 👁 Image
Warehouse in Microsoft Fabric 👁 Image
SQL database in Microsoft Fabric

A function that returns the angle, in radians, whose sine is the specified float expression. This is also called arcsine.

👁 Image
Transact-SQL syntax conventions

Syntax

ASIN ( float_expression ) 

Arguments

float_expression
An expression of either type float or of a type that can implicitly convert to float. Only a value ranging from -1.00 to 1.00 is valid. For values outside this range, no value is returned, and ASIN will report a domain error.

Return types

float

Examples

This example takes a float expression and returns the ASIN value of the specified angle.

/* 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 

Here's the result set.

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

Examples: Azure Synapse Analytics and Analytics Platform System (PDW)

This example returns the arcsine of 1.00.

SELECT ASIN(1.00) AS asinCalc; 

This example returns an error, because it requests the arcsine for a value outside the allowed range.

SELECT ASIN(1.1472738) AS asinCalc; 

See also

CEILING (Transact-SQL)
Mathematical Functions (Transact-SQL)
SET ARITHIGNORE (Transact-SQL)
SET ARITHABORT (Transact-SQL)