ASIN (Transact-SQL)

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Point de terminaison analytique SQL dans Microsoft FabricEntrepôt dans Microsoft Fabric

Fonction qui retourne l’angle en radians dont le sinus correspond à l’expression float spécifiée. Cette fonction est également appelée arc sinus.

Conventions de la syntaxe Transact-SQL

Syntaxe

ASIN ( float_expression )  

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez Versions antérieures de la documentation.

Arguments

float_expression
Expression de type float ou dont le type peut être implicitement converti en float. Seule une valeur comprise entre -1,00 et 1,00 est valide. Pour les valeurs situées en dehors de cette plage, aucune valeur n'est renvoyée et ASIN signale une erreur de domaine.

Types de retour

float

Exemples

Cet exemple accepte une expression float et retourne l’arc sinus (ASIN) de l’angle spécifié.

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

Voici le jeu de résultats obtenu.

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

Exemples : Azure Synapse Analytics et Analytics Platform System (PDW)

Cet exemple retourne l’arc sinus de 1,00.

SELECT ASIN(1.00) AS asinCalc;  

Cet exemple retourne une erreur, car il demande l’arc sinus d’une valeur située hors de la plage autorisée.

SELECT ASIN(1.1472738) AS asinCalc;  

Voir aussi

CEILING (Transact-SQL)
Fonctions mathématiques (Transact-SQL)
SET ARITHIGNORE (Transact-SQL)
SET ARITHABORT (Transact-SQL)