Excel Add-In for API

Build 24.0.9062

算術関数

ABS ( numeric_expression )

指定された数値の絶対値（正の値）を返します。

  • numeric_expression：真数（exact numeric）または概数（approximate numeric）データ型カテゴリの式（bit データ型を除く）。 

                      SELECT ABS(15);
                      -- Result: 15

                      SELECT ABS(-15);
                      -- Result: 15

ACOS ( float_expression )

指定された浮動小数点式がコサインの値となる角度をラジアン単位で返します。これは、アークコサインとも呼ばれます。

  • float_expression：-1～1の値を使用する浮動小数点数。この範囲外の値を使用すると、null が返されます。 

                      SELECT ACOS(0.5);
                      -- Result: 1.0471975511966

ASIN ( float_expression )

指定された浮動小数点式がサインの値となる角度をラジアン単位で返します。これは、アークサインとも呼ばれます。

  • float_expression：-1～1の値を使用する浮動小数点数の式。この範囲外の値を使用すると、null が返されます。 

                      SELECT ASIN(0.5);
                      -- Result: 0.523598775598299

ATAN ( float_expression )

指定された浮動小数点式がタンジェントの値となる角度をラジアン単位で返します。これは、アークタンジェントとも呼ばれます。

  • float_expression：浮動小数点型の式。 

                      SELECT ATAN(10);
                      -- Result: 1.47112767430373

ATN2 ( float_expression1 , float_expression2 )

正のx 軸と原点から点(y, x) までの線との間の角度をラジアン単位で返します。x とy は、指定された2つの浮動小数点式です。

  • float_expression1：浮動小数点型の式。
  • float_expression2：浮動小数点型の式。 

                      SELECT ATN2(1, 1);
                      -- Result: 0.785398163397448

CEILING ( numeric_expression ) or CEIL( numeric_expression )

指定された数値式以上で最小の整数を返します。

  • numeric_expression：真数（exact numeric）または概数（approximate numeric）データ型カテゴリの式（bit データ型を除く）。 

                      SELECT CEILING(1.3);
                      -- Result: 2

                      SELECT CEILING(1.5);
                      -- Result: 2

                      SELECT CEILING(1.7);
                      -- Result: 2

COS ( float_expression )

指定された式で示されるラジアン単位の角度の三角関数コサインを返します。

  • float_expression：浮動小数点型の式。 

                      SELECT COS(1);
                      -- Result: 0.54030230586814

COT ( float_expression )

指定された浮動小数点式で示されるラジアン単位の角度の三角関数コタンジェントを返します。

  • float_expression：浮動小数点型の式。 

                      SELECT COT(1);
                      -- Result: 0.642092615934331

DEGREES ( numeric_expression )

ラジアン単位で指定された角度に相当する度単位の角度を返します。

  • numeric_expression：真数（exact numeric）または概数（approximate numeric）データ型カテゴリの式（bit データ型を除く）。 

                      SELECT DEGREES(3.1415926);
                      -- Result: 179.999996929531

EXP ( float_expression )

指定された浮動小数点値の指数値を返します。例えば、EXP(LOG(20)) は20です。

  • float_expression：浮動小数点型の式。 

                      SELECT EXP(2);
                      -- Result: 7.38905609893065

EXPR ( expression )

式を評価します。

  • expression：数値データ型の式。使用できる演算子は、+, -, *, /, ==, !=, >, <, >=, および <= です。 

                      SELECT EXPR('1 + 2 * 3');
                      -- Result: 7

                      SELECT EXPR('1 + 2 * 3 == 7');
                      -- Result: true

FLOOR ( numeric_expression )

指定された数値式以下で最大の整数を返します。

  • numeric_expression：真数（exact numeric）または概数（approximate numeric）データ型カテゴリの式（bit データ型を除く）。 

                      SELECT FLOOR(1.3);
                      -- Result: 1

                      SELECT FLOOR(1.5);
                      -- Result: 1

                      SELECT FLOOR(1.7);
                      -- Result: 1

GREATEST(int1,int2,....)

指定された整数の最大値を返します。 

				SELECT GREATEST(3,5,8,10,1)
				-- Result: 10

HEX(value)

入力値に相当する16進数を返します。

  • value：16進数に変換される文字列または数値。 

				SELECT HEX(866849198);
				-- Result: 33AB11AE
				
				SELECT HEX('Sample Text');
				-- Result: 53616D706C652054657874

JSON_AVG(json, jsonpath)

JSON オブジェクト内のJSON 配列の平均値を計算します。配列へのパスはjsonpath 引数で指定します。戻り値は数値またはnull です。

  • json：抽出するJSON ドキュメント。
  • jsonpath：ノードを選択します。[x], [2..], [.8] または[1...12] のように使います。[x] はすべてのノードを選択します。 

                      SELECT JSON_AVG('[1,2,3,4,5]', '$[x]');
                      -- Result: 3

                      SELECT JSON_AVG('{"test": {"data": [1,2,3,4,5]}}', '$.test.data[x]');
                      -- Result: 3

                      SELECT JSON_AVG('{"test": {"data": [1,2,3,4,5]}}', '$.test.data[3..]');
                      -- Result: 4.5

JSON_COUNT(json, jsonpath)

JSON オブジェクト内のJSON 配列のエレメント数を返します。配列へのパスはjsonpath 引数で指定します。戻り値は数値またはnull です。

  • json：抽出するJSON ドキュメント。
  • jsonpath：ノードを選択します。[x], [2..], [.8] または[1...12] のように使います。[x] はすべてのノードを選択します。 

                      SELECT JSON_COUNT('[1,2,3,4,5]', '$[x]');
                      -- Result: 5

                      SELECT JSON_COUNT('{"test": {"data": [1,2,3,4,5]}}', '$.test.data[x]');
                      -- Result: 5

                      SELECT JSON_COUNT('{"test": {"data": [1,2,3,4,5]}}', '$.test.data[3..]');
                      -- Result: 2

JSON_MAX(json, jsonpath)

JSON オブジェクト内のJSON 配列の最大値を取得します。配列へのパスはjsonpath 引数で指定します。戻り値は数値またはnull です。

  • json：抽出するJSON ドキュメント。
  • jsonpath：ノードを選択します。[x], [2..], [.8] または[1...12] のように使います。[x] はすべてのノードを選択します。 

                      SELECT JSON_MAX('[1,2,3,4,5]', '$[x]');
                      -- Result: 5

                      SELECT JSON_MAX('{"test": {"data": [1,2,3,4,5]}}', '$.test.data[x]');
                      -- Result: 5

                      SELECT JSON_MAX('{"test": {"data": [1,2,3,4,5]}}', '$.test.data[..3]');
                      -- Result: 4

JSON_MIN(json, jsonpath)

JSON オブジェクト内のJSON 配列の最小値を取得します。配列へのパスはjsonpath 引数で指定します。戻り値は数値またはnull です。

  • json：抽出するJSON ドキュメント。
  • jsonpath：ノードを選択します。[x], [2..], [.8] または[1...12] のように使います。[x] はすべてのノードを選択します。 

                      SELECT JSON_MIN('[1,2,3,4,5]', '$[x]');
                      -- Result: 1

                      SELECT JSON_MIN('{"test": {"data": [1,2,3,4,5]}}', '$.test.data[x]');
                      -- Result: 1

                      SELECT JSON_MIN('{"test": {"data": [1,2,3,4,5]}}', '$.test.data[3..]');
                      -- Result: 4

JSON_SUM(json, jsonpath)

JSONPath 式に応じたJSON のサマリー値を計算します。戻り値は数値またはnull です。

  • json：抽出するJSON ドキュメント。
  • jsonpath：ノードを選択します。[x], [2..], [.8] または[1...12] のように使います。[x] はすべてのノードを選択します。 

                      SELECT JSON_SUM('[1,2,3,4,5]', '$[x]');
                      -- Result: 15

                      SELECT JSON_SUM('{"test": {"data": [1,2,3,4,5]}}', '$.test.data[x]');
                      -- Result: 15

                      SELECT JSON_SUM('{"test": {"data": [1,2,3,4,5]}}', '$.test.data[3..]');
                      -- Result: 9

LEAST(int1,int2,....)

指定された整数の最小値を返します。 

				SELECT LEAST(3,5,8,10,1)
				-- Result: 1

LOG ( float_expression [, base ] )

指定された浮動小数点式の自然対数を返します。

  • float_expression：浮動小数点の式。
  • base：対数の底を設定する整数引数（オプション）。 

                      SELECT LOG(7.3890560);
                      -- Result: 1.99999998661119

LOG10 ( float_expression )

指定された浮動小数点式の10を底とする対数を返します。

  • float_expression：浮動小数点型の式。 

                      SELECT LOG10(10000);
                      -- Result: 4

MOD(dividend,divisor)

被除数を除数で除算したときの余剰に関連付けられた整数値を返します。

  • dividend：係数をとる数。
  • divisor：係数を決定するときに被除数を除算する数。 

				SELECT MOD(10,3);
				-- Result: 1

NEGATE(real_number)

実数入力のopposite を返します。

  • real_number：opposite を見つけるための実数。 

				SELECT NEGATE(10);
				-- Result: -10
				
				SELECT NEGATE(-12.4)
				--Result: 12.4

PI ( )

PI の定数値を返します。 

                  SELECT PI()
                  -- Result: 3.14159265358979

POWER ( float_expression , y )

指定された式の指定されたべき乗値を返します。

  • float_expression：浮動小数点型の式。
  • y：float_expression のべき乗。 

                      SELECT POWER(2, 10);
                      -- Result: 1024

                      SELECT POWER(2, -2);
                      -- Result: 0.25

RADIANS ( float_expression )

数値式が度単位で入力されたときのラジアン値を返します。

  • float_expression：真数（exact numeric）または概数（approximate numeric）データ型カテゴリの式（bit データ型を除く）。 

                      SELECT RADIANS(180);
                      -- Result: 3.14159265358979

RAND ( [ integer_seed ] )

0と1の間の（0と1は除く）の疑似乱数（浮動小数点値）を返します。

  • seed：seed 値を提供する整数式（オプション）。seed を指定しない場合は、ランダムなseed 値が割り当てられます。 

                      SELECT RAND();
                      -- This result may be different, since the seed is randomized
                      -- Result: 0.873159630165044

                      SELECT RAND(1);
                      -- This result will always be the same, since the seed is constant
                      -- Result: 0.248668584157093

ROUND ( numeric_expression [ ,integer_length] [ ,function ] )

指定された長さまたは有効桁数に丸められた数値を返します。

  • numeric_expression：数値の式。
  • length：numeric_expression を丸める有効桁数（オプション）。これを省略した場合、デフォルトの動作では最も近い整数に丸められます。
  • function：実行する操作の種類（オプション）。function パラメータを省略した場合、または0（デフォルト）の値を指定した場合、numeric_expression は丸められます。0以外の値を指定した場合、numeric_expression は切り捨てられます。 

                      SELECT ROUND(1.3, 0);
                      -- Result: 1

                      SELECT ROUND(1.55, 1);
                      -- Result: 1.6

                      SELECT ROUND(1.7, 0, 0);
                      -- Result: 2

                      SELECT ROUND(1.7, 0, 1);
                      -- Result: 1
                      
                      SELECT ROUND (1.24);
                      -- Result: 1.0

SIGN ( numeric_expression )

指定された式の符号を、正（+1）、ゼロ（0）、または負（-1）で返します。

  • numeric_expression：真数（exact numeric）または概数（approximate numeric）データ型カテゴリの式（bit データ型を除く）。 

                      SELECT SIGN(0);
                      -- Result: 0

                      SELECT SIGN(10);
                      -- Result: 1

                      SELECT SIGN(-10);
                      -- Result: -1

SIN ( float_expression )

指定された角度の三角関数のサイン値をラジアン単位で返します。

  • float_expression：浮動小数点型の式。 

                     SELECT SIN(1);
                     -- Result: 0.841470984807897

SQRT ( float_expression )

指定された浮動小数点値の平方根を返します。

  • float_expression：浮動小数点型の式。 

                      SELECT SQRT(100);
                      -- Result: 10

SQUARE ( float_expression )

指定された浮動小数点値の2乗を返します。

  • float_expression：浮動小数点型の式。 

                      SELECT SQUARE(10);
                      -- Result: 100

                      SELECT SQUARE(-10);
                      -- Result: 100

TAN ( float_expression )

入力式のタンジェントを返します。

  • float_expression：浮動小数点型の式。 

                      SELECT TAN(1);
                      -- Result: 1.5574077246549

TRUNC(decimal_number,precision)

指定された小数精度に切り捨てられた、指定された10進数を返します。

  • decimal_number：切り捨てる10進数値。
  • precision：10進数を切り捨てる小数点以下の桁数。 

				SELECT TRUNC(10.3423,2);
				-- Result: 10.34

_ROW_NUMBER_()

行インデックスを追加カラムとして返します。 

				SELECT ColumnName, _ROW_NUMBER_() FROM TableName
				-- Result: ColumnData, 0
				ColumnData2, 1
				ColumnData3, 2

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 24.0.9062