ASIN (SQL)
与えられた角度の正弦のアークサインを、ラジアン表示で返すスカラ数値関数です。
構文
{fn ASIN(numeric-expression)}
概要
ASIN は、角度のサインの逆関数値を浮動小数点値で返します。numeric-expression には、-1 以上 1 以下の符号付き 10 進数値を指定します。この範囲外の数値を指定すると、実行時エラーが発生して、SQLCODE -400 (致命的なエラーが発生しました) が生成されます。NULL 値を渡すと、ASIN は NULL を返します。ASIN は、空文字列 (") のように数値でない文字列を数値 0 (ゼロ) として扱います。
ASIN は、有効桁数が 19 で小数桁数が 18 の値を返します。
ASIN は、{ } 括弧構文による ODBC スカラ関数としてのみ使用できます。
DEGREES 関数を使用してラジアンを度数に変換できます。RADIANS 関数を使用して度数をラジアンに変換できます。
引数
numeric-expression
値が -1 から 1 の間である数値式。角度のサインです。
ASIN は、NUMERIC または DOUBLE データ型のいずれかを返します。ASIN は、numeric-expression がデータ型 DOUBLE の場合には DOUBLE を返し、それ以外の場合には NUMERIC を返します。
例
以下の例は、2 つのサイン値に対する ASIN の実行結果です。
SELECT {fn ASIN(0.52)} AS ArcSine
これは、0.5468509506... を返します。
SELECT {fn ASIN(-1.00)} AS ArcSine
これは、-1.5707963267... を返します。