Skip to content

asin-transact-sql.md

Latest commit

 

History

History
114 lines (90 loc) · 3.54 KB

asin-transact-sql.md

File metadata and controls

114 lines (90 loc) · 3.54 KB

title: "ASIN (Transact-SQL) | Microsoft Docs" ms.custom: "" ms.date: "07/24/2017" ms.prod: "sql" ms.prod_service: "database-engine, sql-database, sql-data-warehouse, pdw" ms.service: "" ms.component: "t-sql|functions" ms.reviewer: "" ms.suite: "sql" ms.technology:

  • "database-engine" ms.tgt_pltfrm: "" ms.topic: "language-reference" f1_keywords:
  • "ASIN_TSQL"
  • "ASIN" dev_langs:
  • "TSQL" helpviewer_keywords:
  • "ASIN function"
  • "sine"
  • "arcsine" ms.assetid: 6256dd7d-83d5-486e-a933-1d59afc7e417 caps.latest.revision: 35 author: "edmacauley" ms.author: "edmaca" manager: "craigg" ms.workload: "Inactive" monikerRange: ">= aps-pdw-2016 || = azuresqldb-current || = azure-sqldw-latest || >= sql-server-2016 || = sqlallproducts-allversions"

ASIN (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-all-md]

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

Topic link icon 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. Values outside this range return NULL, 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

[!INCLUDEssResult]

-------------------------  
.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: [!INCLUDEssSDWfull] and [!INCLUDEssPDW]

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)