函数

openGauss常用的函数如下：

数学函数

  • abs(x)

    描述：绝对值。

    返回值类型：和输入相同。

    示例：

    1. openGauss=# SELECT abs(-17.4);
    2.  abs
    3. ------
    4.  17.4
    5. (1 row)

  • cbrt(dp)

    描述：立方根。

    返回值类型：double precision

    示例：

    1. openGauss=# SELECT cbrt(27.0);
    2.  cbrt
    3. ------
    4.     3
    5. (1 row)

  • ceil(x)

    描述：不小于参数的最小的整数。

    返回值类型：整数。

    示例：

    1. openGauss=# SELECT ceil(-42.8);
    2.  ceil 
    3. ------
    4.   -42
    5. (1 row)

  • degrees(dp)

    描述：把弧度转为角度。

    返回值类型：double precision

    示例：

    1. openGauss=# SELECT degrees(0.5);
    2.      degrees
    3. ------------------
    4.  28.6478897565412
    5. (1 row)

  • exp(x)

    描述：自然指数。

    返回值类型：dp or numeric，不考虑隐式类型转换的情况下与输入相同。

    示例：

    1. openGauss=# SELECT exp(1.0);
    2.         exp         
    3. --------------------
    4.  2.7182818284590452
    5. (1 row)

  • floor(x)

    描述：不大于参数的最大整数。

    返回值类型：与输入相同。

    示例：

    1. openGauss=# SELECT floor(-42.8);
    2.  floor 
    3. -------
    4.    -43
    5. (1 row)

  • ln(x)

    描述：自然对数。

    返回值类型：dp or numeric，不考虑隐式类型转换的情况下与输入相同。

    示例：

    1. openGauss=# SELECT ln(2.0);
    2.         ln         
    3. -------------------
    4.  .6931471805599453
    5. (1 row)

  • log(x)

    描述：以10为底的对数。

    返回值类型：与输入相同。

    示例：

    1. openGauss=# SELECT log(100.0);
    2.         log         
    3. --------------------
    4.  2.0000000000000000
    5. (1 row)

  • log(b numeric, x numeric)

    描述：以b为底的对数。

    返回值类型：numeric

    示例：

    1. openGauss=# SELECT log(2.0, 64.0);
    2.         log         
    3. --------------------
    4.  6.0000000000000000
    5. (1 row)

  • mod(x,y)

    描述：x/y的余数（模）。如果x是0，则返回0。

    返回值类型：与参数类型相同。

    示例：

    1. openGauss=# SELECT mod(9,4);
    2.  mod 
    3. -----
    4.    1
    5. (1 row)
    1. openGauss=# SELECT mod(9,0);
    2.  mod 
    3. -----
    4.    9
    5. (1 row)

  • pi()

    描述：“π”常量。

    返回值类型：double precision

    示例：

    1. openGauss=# SELECT pi();
    2.         pi
    3. ------------------
    4.  3.14159265358979
    5. (1 row)

  • power(a double precision, b double precision)

    描述：a的b次幂。

    返回值类型：double precision

    示例：

    1. openGauss=# SELECT power(9.0, 3.0);
    2.         power         
    3. ----------------------
    4.  729.0000000000000000
    5. (1 row)

  • radians(dp)

    描述：把角度转为弧度。

    返回值类型：double precision

    示例：

    1. openGauss=# SELECT radians(45.0);
    2.      radians
    3. ------------------
    4.  .785398163397448
    5. (1 row)

  • random()

    描述：0.0到1.0之间的随机数。

    返回值类型：double precision

    示例：

    1. openGauss=# SELECT random();
    2.       random
    3. ------------------
    4.  .824823560658842
    5. (1 row)

  • round(x)

    描述：离输入参数最近的整数。

    返回值类型：与输入相同。

    示例：

    1. openGauss=# SELECT round(42.4);
    2.  round 
    3. -------
    4.     42
    5. (1 row)
    7. openGauss=# SELECT round(42.6);
    8.  round 
    9. -------
    10.     43
    11. (1 row)

  • round(v numeric, s int)

    描述：保留小数点后s位，s后一位进行四舍五入。

    返回值类型：numeric

    示例：

    1. openGauss=# SELECT round(42.4382, 2);
    2.  round
    3. -------
    4.  42.44
    5. (1 row)

  • sign(x)

    描述：输出此参数的符号。

    返回值类型：-1表示负数，0表示0，1表示正数。

    示例：

    1. openGauss=# SELECT sign(-8.4);
    2.  sign 
    3. ------
    4.    -1
    5. (1 row)

  • sqrt(x)

    描述：平方根。

    返回值类型：dp or numeric，不考虑隐式类型转换的情况下与输入相同。

    示例：

    1. openGauss=# SELECT sqrt(2.0);
    2.        sqrt        
    3. -------------------
    4.  1.414213562373095
    5. (1 row)

  • trunc(x)

    描述：截断（取整数部分）。

    返回值类型：与输入相同。

    示例：

    1. openGauss=# SELECT trunc(42.8);
    2.  trunc 
    3. -------
    4.     42
    5. (1 row)

  • trunc(v numeric, s int)

    描述：截断为s位小数。

    返回值类型：numeric

    示例：

    1. openGauss=# SELECT trunc(42.4382, 2);
    2.  trunc
    3. -------
    4.  42.43
    5. (1 row)

三角函数列表

  • acos(x)

    描述：反余弦。

    返回值类型：double precision

    示例：

    1. openGauss=# SELECT acos(-1);
    2.        acos       
    3. ------------------
    4.  3.14159265358979
    5. (1 row)

  • asin(x)

    描述：反正弦。

    返回值类型：double precision

    示例：

    1. openGauss=# SELECT asin(0.5);
    2.        asin       
    3. ------------------
    4.  .523598775598299
    5. (1 row)

  • atan(x)

    描述：反正切。

    返回值类型：double precision

    示例：

    1. openGauss=# SELECT atan(1);
    2.        atan       
    3. ------------------
    4.  .785398163397448
    5. (1 row)

  • atan2(y, x)

    描述：y/x的反正切。

    返回值类型：double precision

    示例：

    1. openGauss=# SELECT atan2(2, 1);
    2.       atan2
    3. ------------------
    4.  1.10714871779409
    5. (1 row)

  • cos(x)

    描述：余弦。

    返回值类型：double precision

    示例：

    1. openGauss=# SELECT cos(-3.1415927);
    2.         cos        
    3. -------------------
    4.  -.999999999999999
    5. (1 row)

  • cot(x)

    描述：余切。

    返回值类型：double precision

    示例：

    1. openGauss=# SELECT cot(1);
    2.        cot
    3. ------------------
    4.  .642092615934331
    5. (1 row)

  • sin(x)

    描述：正弦。

    返回值类型：double precision

    示例：

    1. openGauss=# SELECT sin(1.57079);
    2.        sin        
    3. ------------------
    4.  .999999999979986
    5. (1 row)

  • tan(x)

    描述：正切。

    返回值类型：double precision

    示例：

    1. openGauss=# SELECT tan(20);
    2.        tan        
    3. ------------------
    4.  2.23716094422474
    5. (1 row)

字符串函数和操作符

  • string || string

    描述：连接字符串。

    返回值类型：text

    示例：

    1. openGauss=# SELECT 'MPP'||'DB' AS RESULT;
    2.  result 
    3. --------
    4.  MPPDB
    5. (1 row)

  • bit_length(string)

    描述：字符串的位数。

    返回值类型：int

    示例：

    1. openGauss=# SELECT bit_length('world');
    2.  bit_length
    3. ------------
    4.          40
    5. (1 row)

  • convert(string bytea, src_encoding name, dest_encoding name)

    描述：以dest_encoding指定的目标编码方式转化字符串bytea。src_encoding指定源编码方式，在该编码下，string必须是合法的。

    返回值类型：bytea

    示例：

    1. openGauss=# SELECT convert('text_in_utf8', 'UTF8', 'GBK');
    2.           convert        
    3. ----------------------------
    4.  \x746578745f696e5f75746638
    5. (1 row)

  • lower(string)

    描述：把字符串转化为小写。

    返回值类型：varchar

    示例：

    1. openGauss=# SELECT lower('TOM');
    2.  lower
    3. -------
    4.  tom
    5. (1 row)

  • octet_length(string)

    描述：字符串中的字节数。

    返回值类型：int

    示例：

    1. openGauss=# SELECT octet_length('jose');
    2.  octet_length
    3. --------------
    4.             4
    5. (1 row)

  • overlay(string placing string FROM int [for int])

    描述：替换子字符串。FROM int表示从第一个string的第几个字符开始替换，for int表示替换第一个string的字符数目。

    返回值类型：text

    示例：

    1. openGauss=# SELECT overlay('hello' placing 'world' from 2 for 3 );
    2.  overlay 
    3. ---------
    4.  hworldo
    5. (1 row)

  • position(substring in string)

    描述：指定子字符串的位置。字符串区分大小写。

    返回值类型：int，字符串不存在时返回0。

    示例：

    1. openGauss=# SELECT position('ing' in 'string');
    2.  position
    3. ----------
    4.         4
    5. (1 row)

  • substring(string [from int] [for int])

    描述：截取子字符串，from int表示从第几个字符开始截取，for int表示截取几个字节。

    返回值类型：text

    示例：

    1. openGauss=# SELECT substring('Thomas' from 2 for 3);
    2.  substring
    3. -----------
    4.  hom
    5. (1 row)

  • substring(string from pattern)

    描述：截取匹配POSIX正则表达式的子字符串。如果没有匹配它返回空值，否则返回文本中匹配模式的那部分。

    返回值类型：text

    示例：

    1. openGauss=# SELECT substring('Thomas' from '...$');
    2.  substring
    3. -----------
    4.  mas
    5. (1 row)
    6. openGauss=# SELECT substring('foobar' from 'o(.)b');
    7.  result 
    8. --------
    9.  o
    10. (1 row)
    11. openGauss=# SELECT substring('foobar' from '(o(.)b)');
    12.  result 
    13. --------
    14.  oob
    15. (1 row)

  • trim([leading |trailing |both] [characters] from string)

    描述：从字符串string的开头、结尾或两边删除只包含characters中字符（缺省是一个空白）的最长的字符串。

    返回值类型：varchar

    示例：

    1. openGauss=# SELECT trim(BOTH 'x' FROM 'xTomxx');
    2.  btrim
    3. -------
    4.  Tom
    5. (1 row)
    1. openGauss=# SELECT trim(LEADING 'x' FROM 'xTomxx');
    2.  ltrim
    3. -------
    4.  Tomxx
    5. (1 row)
    1. openGauss=# SELECT trim(TRAILING 'x' FROM 'xTomxx');
    2.  rtrim
    3. -------
    4.  xTom
    5. (1 row)

  • upper(string)

    描述：把字符串转化为大写。

    返回值类型：varchar

    示例：

    1. openGauss=# SELECT upper('tom');
    2.  upper
    3. -------
    4.  TOM
    5. (1 row)

  • ascii(string)

    描述：参数string的第一个字符的ASCII码。

    返回值类型：integer

    示例：

    1. openGauss=# SELECT ascii('xyz');
    2.  ascii 
    3. -------
    4.    120
    5. (1 row)

  • btrim(string text [, characters text])

    描述：从string开头和结尾删除只包含characters中字符（缺省是空白）的最长字符串。

    返回值类型：text

    示例：

    1. openGauss=# SELECT btrim('sring' , 'ing');
    2.  btrim
    3. -------
    4.  sr
    5. (1 row)

  • chr(integer)

    描述：给出ASCII码的字符。

    返回值类型：varchar

    示例：

    1. openGauss=# SELECT chr(65);
    2.  chr
    3. -----
    4.  A
    5. (1 row)

  • convert(string bytea, src_encoding name, dest_encoding name)

    描述：以dest_encoding指定的目标编码方式转化字符串bytea。src_encoding指定源编码方式，在该编码下，string必须是合法的。

    返回值类型：bytea

    示例：

    1. openGauss=# SELECT convert('text_in_utf8', 'UTF8', 'GBK');
    2.           convert        
    3. ----------------------------
    4.  \x746578745f696e5f75746638
    5. (1 row)

  • initcap(string)

    描述：将字符串中的每个单词的首字母转化为大写，其他字母转化为小写。

    返回值类型：text

    示例：

    1. openGauss=# SELECT initcap('hi THOMAS');
    2.   initcap
    3. -----------
    4.  Hi Thomas
    5. (1 row)

  • length(string)

    描述：获取参数string中字符的数目。

    返回值类型：integer

    示例：

    1. openGauss=# SELECT length('abcd');
    2.  length 
    3. --------
    4.       4
    5. (1 row)

  • lpad(string text, length int [, fill text])

    描述：通过填充字符fill（缺省时为空白），把string填充为length长度。如果string已经比length长则将其尾部截断。

    返回值类型：text

    示例：

    1. openGauss=# SELECT lpad('hi', 5, 'xyza');
    2.  lpad  
    3. -------
    4.  xyzhi
    5. (1 row)

  • ltrim(string [, characters])

    描述：从字符串string的开头删除只包含characters中字符（缺省是一个空白）的最长的字符串。

    返回值类型：varchar

    示例：

    1. openGauss=# SELECT ltrim('xxxxTRIM','x');
    2.  ltrim
    3. -------
    4.  TRIM
    5. (1 row)

  • md5(string)

    描述：将string使用MD5加密，并以16进制数作为返回值。

    函数 - 图1 说明： MD5加密算法安全性低，存在安全风险，不建议使用。

    返回值类型：text

    示例：

    1. openGauss=# SELECT md5('ABC');
    2.                md5                
    3. ----------------------------------
    4.  902fbdd2b1df0c4f70b4a5d23525e932
    5. (1 row)

  • repeat(string text, number int )

    描述：将string重复number次。

    返回值类型：text。

    示例：

    1. openGauss=# SELECT repeat('Pg', 4);
    2.   repeat
    3. ----------
    4.  PgPgPgPg
    5. (1 row)

  • replace(string text, from text, to text)

    描述：把字符串string里出现地所有子字符串from的内容替换成子字符串to的内容。

    返回值类型：text

    示例：

    1. openGauss=# SELECT replace('abcdefabcdef', 'cd', 'XXX');
    2.     replace     
    3. ----------------
    4.  abXXXefabXXXef
    5. (1 row)

  • rpad(string text, length int [, fill text])

    描述：使用填充字符fill（缺省时为空白），把string填充到length长度。如果string已经比length长则将其从尾部截断。

    返回值类型：text

    示例：

    1. openGauss=# SELECT rpad('hi', 5, 'xy');
    2.  rpad
    3. -------
    4.  hixyx
    5. (1 row)

  • rtrim(string text [, characters text])

    描述：从字符串string的结尾删除只包含characters中字符（缺省是个空白）的最长的字符串。

    返回值类型：text

    示例：

    1. openGauss=# SELECT rtrim('trimxxxx', 'x');
    2.  rtrim
    3. -------
    4.  trim
    5. (1 row)

  • split_part(string text, delimiter text, field int)

    描述：根据delimiter分隔string返回生成的第field个子字符串（从出现第一个delimiter的text为基础）。

    返回值类型：text

    示例：

    1. openGauss=# SELECT split_part('abc~@~def~@~ghi', '~@~', 2);
    2.  split_part
    3. ------------
    4.  def
    5. (1 row)

  • strpos(string, substring)

    描述：指定的子字符串的位置。和position(substring in string)一样，不过参数顺序相反。

    返回值类型：int

    示例：

    1. openGauss=# SELECT strpos('source', 'rc');
    2.  strpos
    3. --------
    4.       4
    5. (1 row)

  • to_hex(number int or bigint)

    描述：把number转换成十六进制表现形式。

    返回值类型：text

    示例：

    1. openGauss=# SELECT to_hex(2147483647);
    2.   to_hex
    3. ----------
    4.  7fffffff
    5. (1 row)

  • translate(string text, from text, to text)

    描述：把在string中包含的任何匹配from中字符的字符转化为对应的在to中的字符。如果from比to长，删掉在from中出现的额外的字符。

    返回值类型：text

    示例：

    1. openGauss=# SELECT translate('12345', '143', 'ax');
    2.  translate
    3. -----------
    4.  a2x5
    5. (1 row)

类型转换相关函数

  • to_char(timestamp, text)

    描述：将时间戳类型的值转换为指定格式的字符串。

    返回值类型：text

    示例：

    1. openGauss=# SELECT to_char(current_timestamp, 'HH12:MI:SS');
    2.  to_char
    3. ----------
    4.  10:55:59
    5. (1 row)

  • to_char(interval, text)

    描述：将时间间隔类型的值转换为指定格式的字符串。

    返回值类型：text

    示例：

    1. openGauss=# SELECT to_char(interval '15h 2m 12s', 'HH24:MI:SS');
    2.  to_char
    3. ----------
    4.  15:02:12
    5. (1 row)

  • to_char(int, text)

    描述：将整数类型的值转换为指定格式的字符串。

    返回值类型：text

    示例：

    1. openGauss=# SELECT to_char(125, '999');
    2.  to_char
    3. ---------
    4.   125
    5. (1 row)

  • to_char(double precision/real, text)

    描述：将浮点类型的值转换为指定格式的字符串。

    返回值类型：text

    示例：

    1. openGauss=# SELECT to_char(125.8::real, '999D99');
    2.  to_char 
    3. ---------
    4.   125.80
    5. (1 row)

  • to_char(numeric, text)

    描述：将数字类型的值转换为指定格式的字符串。

    返回值类型：text

    示例：

    1. openGauss=# SELECT to_char(-125.8, '999D99S');
    2.  to_char
    3. ---------
    4.  125.80-
    5. (1 row)

  • to_date(text, text)

    描述：将字符串类型的值转换为指定格式的日期。

    返回值类型：timestamp without time zone

    示例：

    1. openGauss=# SELECT to_date('05 Dec 2000', 'DD Mon YYYY');
    2.        to_date
    3. ---------------------
    4.  2000-12-05 00:00:00
    5. (1 row)

  • to_number(text, text)

    描述：将字符串类型的值转换为指定格式的数字。

    返回值类型：numeric

    示例：

    1. openGauss=# SELECT to_number('12,454.8-', '99G999D9S');
    2.  to_number
    3. -----------
    4.   -12454.8
    5. (1 row)

  • to_timestamp(text, text)

    描述：将字符串类型的值转换为指定格式的时间戳。

    返回值类型：timestamp

    示例：

    1. openGauss=# SELECT to_timestamp('05 Dec 2000', 'DD Mon YYYY');
    2.     to_timestamp
    3. ---------------------
    4.  2000-12-05 00:00:00
    5. (1 row)

  • to_timestamp(double precision)

    描述：把UNIX纪元转换成时间戳。

    返回值类型：timestamp with time zone

    示例：

    1. openGauss=# SELECT to_timestamp(1284352323);
    2.       to_timestamp      
    3. ------------------------
    4.  2010-09-13 12:32:03+08
    5. (1 row)