金仓数据库 KingbaseES SQL 语言参考手册 (8. 函数（二））

8.21. ABBREV

用法：

abbrev({inet | cidr})

功能：

缩写显示格式文本

例子：

abbrev(inet '10.1.0.0/16')

abbrev(cidr '10.1.0.0/16')

8.22. ABS

用法：

abs (n)

功能：

ABS返回n的绝对值。

此函数将任何数值数据类型或任何可以隐式转换为数值数据类型的非数值数据类型作为参数。该函数返回与参数的数值数据类型相同的数据类型。

例子：

以下示例返回 -10 的绝对值：

SELECT abs(-10);

8.23. ACOS

用法：

acos（n）

功能：

ACOS返回n的反余弦。参数n必须在 -1 到 1 的范围内，并且函数返回一个在 0 到pi范围内的值，以弧度表示。

此函数将任何数值数据类型或任何可以隐式转换为数值数据类型的非数值数据类型作为参数。如果参数是BINARY_FLOAT，则函数返回BINARY_DOUBLE。否则，函数返回与参数相同的数值数据类型。

例子：

以下示例返回 0.5 的反余弦：

SELECT acos('0.5');

8.24. ACOSH

用法：

acosh（n）

功能：

ACOS返回n的反双曲余弦 。

例子：

以下示例返回 3 的反双曲余弦：

SELECT acosh(float8 '3');

8.25. ADD_MONTHS

用法：

ADD_MONTHS(expr1 日期/时间类型, expr2 INT)

功能：

返回expr1加上expr2个月的日期时间值。

1. expr1数据类型是日期/时间类型(DATE、TIMESTAMP和TIMESTAMPTZ)或可以转换为日期/时间类型的数据类型。输入日期/时间格式串时自动转成TIMESTAMP。

2. expr2数据类型为INT型。

输入TIMESTAMP和TIMESTAMPTZ时返回TIMESTAMP。输入DATE时返回DATE。

例子：

例一：
select add_months(date'2012-1-20',-1) AS RESULT;



例二：
select add_months(timestamp'2012-1-31 10:00:00',-20)  AS RESULT;




例三：
select add_months('20120101',12)  AS RESULT;

8.26. AGE

用法：

age(timestamp, timestamp)

age(timestamp)

功能：

减去参数生成一个年、月不包含日的格式化结果。当只有一个参数时减去 current_date (午夜时间)。

例子：

SELECT age(timestamptz '2013-07-01 12:00:00', timestamptz '2011-03-01 12:00:00');

8.27. APPENDCHILDXML

用法：

appendchildxml(xml_instance xml,  xpath text , value_expr xml)
appendchildxml(xml_instance xml,  xpath text , value_expr xml,namespace _text)

功能：

函数appendchildxml将``value_expr``提供的值作为``xpath``节点的子节点追加到``xml_instance``中。成功则返回追加后的``xml_instance``数据，失败则返回ERROR。 此函数使用前需要创建kdb_utils_function扩展。

例子：

SELECT appendchildxml('<test><value></value><value></value></test>', '/test/value', XMLPARSE(CONTENT '<name>newnode</name>'));

8.28. ARRAY_AGG

用法：

array_agg(expression)

功能：

当参数为非数组类型时， array_agg 将输入值(包括空值)连接到一个数组，返回参数类型的数组。 当参数为数组类型时，array_agg 将输入数组串接到一个更高维度的数组中，并返回一个与参数数据类型相同的数组。输入数组必须具有相同维度，并且不能为空或者NULL。

例子：

SELECT array_agg(array[i, nullif(i, 3), i+1]) from generate_series(1,4) g(i);

8.29. ARRAY_APPEND

用法：

array_append(anyarray, anyelement)

功能：

向数组 anyarray 末端追加元素 anyelement

例子：

SELECT array_append( ARRAY[1,2], 3);

8.30. ARRAY_CAT

用法：

array_append(anyarray1, anyarray2)

功能：

连接两个数组

例子：

SELECT array_cat( ARRAY[1,2], ARRAY[3,4]);

8.31. ARRAY_DIMS

用法：

array_dims(anyarray)

功能：

返回数组维度的文本表示

例子：

SELECT array_dims( ARRAY[[1,2,3], [4,5,6]]);

8.32. ARRAY_FILL

用法：

array_fill(anyelement, int[], int[])

功能：

返回一个用指定值和指定维度初始化后的数组。

例子：

SELECT array_fill( 7, ARRAY[3], ARRAY[2]);

8.33. ARRAY_LENGTH

用法：

array_length(anyarray,int)

功能：

返回数组指定维度的长度。

例子：

SELECT array_length( array[1,2,3,4], 1);

8.34. ARRAY_LOWER

用法：

array_lower(anyarray, int)

功能：

返回数组指定维度下界

例子：

SELECT array_lower( array[1,2,3,4], 1);

8.35. ARRAY_NDIMS

用法：

array_ndims(anyarray)

功能：

返回数组维度数

例子：

SELECT array_ndims( ARRAY[[1,2,3], [4,5,6]]);

8.36. ARRAY_POSITION

用法：

array_position(anyarray, anyelement[, int])

功能：

返回数组中 anyelement 第一次出现的下标，如果函数第三个参数指定，那么从第三个参数指定的下标开始查找。

例子：

SELECT array_position( ARRAY['sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat'], 'mon');

8.37. ARRAY_POSITIONS

用法：

array_positions(anyarray, anyelement)

功能：

返回数组 anyarray 中出现 anyelement 的下标组成的数组。

例子：

SELECT array_positions( ARRAY['A', 'A', 'B', 'A'], 'A');

8.38. ARRAY_PREPEND

用法：

array_prepend(anyelement, anyarray)

功能：

向数组头部插入元素

例子：

SELECT array_prepend( 1, ARRAY[2,3]);

8.39. ARRAY_REMOVE

用法：

array_remove(anyarray, anyelement)

功能：

从数组 anyarray 中移除值为 anyelement 的元素

例子：

SELECT array_remove( ARRAY[1,2,3,2], 2);

8.40. ARRAY_REPLACE

用法：

array_replace(anyarray, anyelement1, anyelement2)

功能：

将数组 anyarray 中值为anyelement1的元素替换为anyelement1。

例子：

SELECT array_replace( ARRAY[1,2,5,4], 5, 3);

8.41. ARRAY_TO_JSON

用法：

array_to_json(anyarray [, pretty_bool])

功能：

把数组 anyarray 作为json数组返回，一个多维数组会成为一个数组的json数组。如果 pretty_bool 设为真，将会在数组维度之间增加换行符。

例子：

SELECT array_to_json('{
    {1,5},{99,100}}'::int[],true);

8.42. ARRAY_TO_STRING

用法：

array_lower(anyarray, int)

功能：

使用指定的分隔符和可选的空字符串连接数组元素

例子：

SELECT array_to_string( ARRAY[1, 2, 3, NULL, 5],',', '*');

8.43. ARRAY_TO_TSVECTOR

用法：

array_to_tsvector(text[])

功能：

文本搜索函数之一，把词位数组转化成tsvector。

例子：

SELECT array_to_tsvector('{fat,cat,rat}'::text[]);

8.44. ARRAY_UPPER

用法：

array_upper(anyarray, int)

功能：

返回数组指定维度上界

例子：

SELECT array_upper( ARRAY[1,8,3,7], 1);

8.45. ASIN

用法：

asin(n)

功能：

ASIN返回 n的反正弦。参数n必须在 -1 到 1 的范围内，函数返回的值在-pi /2 到pi /2 的范围内，以弧度表示。

此函数将任何数值数据类型或任何可以隐式转换为数值数据类型的非数值数据类型作为参数。如果参数是BINARY_FLOAT，则函数返回BINARY_DOUBLE。否则，函数返回与参数相同的数值数据类型。

例子：

以下示例返回 0.5 的反正弦：

SELECT ASIN(0.5);

8.46. ASINH

用法：

asinh(n)

功能：

ASINH返回 n的反双曲正弦。

例子：

以下示例返回 0.5 的反正弦：

SELECT asinh(2);

8.47. ATAN

用法：

atan(n)

功能：

ATAN返回 n的反正切。参数n可以在无界范围内，并返回 - pi /2 到pi /2 范围内的值，以弧度表示。

此函数将任何数值数据类型或任何可以隐式转换为数值数据类型的非数值数据类型作为参数。如果参数是BINARY_FLOAT，则函数返回BINARY_DOUBLE。否则，函数返回与参数相同的数值数据类型。

例子： 以下示例返回 0.5 的反正切：

SELECT ATAN(0.5) ;

8.48. ATAN2

用法：

atan2(n1, n2)

功能：

ATAN2返回n1和n2的反正切。参数n1可以在无界范围内，并返回-pi到pi范围内的值，具体取决于 n1和 n2的符号，以弧度表示。

此函数将任何数值数据类型或任何可以隐式转换为数值数据类型的非数值数据类型作为参数。如果任何参数是BINARY_FLOATor BINARY_DOUBLE，则函数返回BINARY_DOUBLE。否则函数返回NUMBER。

例子：

以下示例返回 1 和 2 的反正切：

SELECT atan2(1,2);

8.49. ATANH

用法：

atanh(n)

功能：

ATANh返回n的反双曲正切。

例子：

以下示例返回 0.2 的反双曲正切：

SELECT atanh(0.2);

8.50. AVG

用法：

avg(expression)

功能：

AVG返回expr的平均值。

此函数将任何数值数据类型或任何可以隐式转换为数值数据类型的非数值数据类型作为参数。该函数返回与参数的数值数据类型相同的数据类型。

例子：

以下示例计算students表中所有学生的平均成绩（score）：

SELECT avg(score) from students;