类型转换函数

类型转换函数

• cash_words(money)

  描述：类型转换函数，将money转换成text。

  示例：

  1 2 3 4 5

  openGauss=# SELECT cash_words('1.23'); cash_words ----------------------------------- One dollar and twenty three cents (1 row)

• cast(x as y)

  描述：类型转换函数，将x转换成y指定的类型。

  示例：

  1 2 3 4 5

  openGauss=# SELECT cast('22-oct-1997' as timestamp); timestamp --------------------- 1997-10-22 00:00:00 (1 row)

• hextoraw(raw)

  描述：将一个十六进制构成的字符串转换为二进制。

  返回值类型：raw

  示例：

  1 2 3 4 5

  openGauss=# SELECT hextoraw('7D'); hextoraw ---------- 7D (1 row)

• numtoday(numeric)

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

  返回值类型：timestamp

  示例：

  1 2 3 4 5

  openGauss=# SELECT numtoday(2); numtoday ---------- 2 days (1 row)

• pg_systimestamp()

  描述：获取系统时间戳。

  返回值类型：timestamp with time zone

  示例：

  1 2 3 4 5

  openGauss=# SELECT pg_systimestamp(); pg_systimestamp ------------------------------- 2015-10-14 11:21:28.317367+08 (1 row)

• rawtohex(string)

  描述：将一个二进制构成的字符串转换为十六进制的字符串。

  结果为输入字符的ACSII码，以十六进制表示。

  返回值类型：varchar

  示例：

  1 2 3 4 5

  openGauss=# SELECT rawtohex('1234567'); rawtohex ---------------- 31323334353637 (1 row)

• to_bigint(varchar)

  描述：将字符类型转换为bigint类型。

  返回值类型：bigint

  示例：

  1 2 3 4 5

  openGauss=# SELECT to_bigint('123364545554455'); to_bigint ---------------- 123364545554455 (1 row)

• to_char (datetime/interval [, fmt])

  描述：将一个DATE、TIMESTAMP、TIMESTAMP WITH TIME ZONE或者TIMESTAMP WITH LOCAL TIME ZONE类型的DATETIME或者INTERVAL值按照fmt指定的格式转换为VARCHAR类型。

  • 可选参数fmt可以为以下几类：日期、时间、星期、季度和世纪。每类都可以有不同的模板，模板之间可以合理组合，常见的模板有：HH、MM、SS、YYYY、MM、DD。
  • 模板可以有修饰词，常用的修饰词是FM，可以用来抑制前导的零或尾随的空白。

  返回值类型：varchar

  示例：

  1 2 3 4 5

  openGauss=# SELECT to_char(current_timestamp,'HH12:MI:SS'); to_char ---------- 10:19:26 (1 row)

  1 2 3 4 5

  openGauss=# SELECT to_char(current_timestamp,'FMHH12:FMMI:FMSS'); to_char ---------- 10:19:46 (1 row)

• to_char(double precision/real, text)

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

  返回值类型：text

  示例：

  1 2 3 4 5

  openGauss=# SELECT to_char(125.8::real, '999D99'); to_char --------- 125.80 (1 row)

• to_char (numeric/smallint/integer/bigint/double precision/real[, fmt])

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

  • 可选参数fmt可以为以下几类：十进制字符、“分组”符、正负号和货币符号，每类都可以有不同的模板，模板之间可以合理组合，常见的模板有：9、0、,（千分隔符）、.（小数点）。
  • 模板可以有类似FM的修饰词，但FM不抑制由模板0指定而输出的0。
  • 要将整型类型的值转换成对应16进制值的字符串，使用模板X或x。

  返回值类型：varchar

  示例：

  1 2 3 4 5

  openGauss=# SELECT to_char(1485,'9,999'); to_char --------- 1,485 (1 row)

  1 2 3 4 5

  openGauss=# SELECT to_char( 1148.5,'9,999.999'); to_char ------------ 1,148.500 (1 row)

  1 2 3 4 5

  openGauss=# SELECT to_char(148.5,'990999.909'); to_char ------------- 0148.500 (1 row)

  1 2 3 4 5

  openGauss=# SELECT to_char(123,'XXX'); to_char --------- 7B (1 row)

• to_char(interval, text)

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

  返回值类型：text

  示例：

  1 2 3 4 5

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

• to_char(integer, text)

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

  返回值类型：text

  示例：

  1 2 3 4 5

  openGauss=# SELECT to_char(125, '999'); to_char --------- 125 (1 row)

• to_char(numeric, text)

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

  返回值类型：text

  示例：

  1 2 3 4 5

  openGauss=# SELECT to_char(-125.8, '999D99S'); to_char --------- 125.80- (1 row)

• to_char (string)

  描述：将CHAR、VARCHAR、VARCHAR2、CLOB类型转换为VARCHAR类型。

  如使用该函数对CLOB类型进行转换，且待转换CLOB类型的值超出目标类型的范围，则返回错误。

  返回值类型：varchar

  示例：

  1 2 3 4 5

  openGauss=# SELECT to_char('01110'); to_char --------- 01110 (1 row)

• to_nvarchar2

  描述：转换为nvarchar2类型。

  参数：numeric

  返回值类型：nvarchar2

• to_char(timestamp, text)

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

  返回值类型：text

  示例：

  1 2 3 4 5

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

• to_clob(char/nchar/varchar/nvarchar/varchar2/nvarchar2/text/raw)

  描述：将RAW类型或者文本字符集类型CHAR、NCHAR、VARCHAR、VARCHAR2、NVARCHAR2、TEXT转成CLOB类型。

  返回值类型：clob

  示例：

  1 2 3 4 5

  openGauss=# SELECT to_clob('ABCDEF'::RAW(10)); to_clob --------- ABCDEF (1 row)

  1 2 3 4 5

  openGauss=# SELECT to_clob('hello111'::CHAR(15)); to_clob ---------- hello111 (1 row)

  1 2 3 4 5

  openGauss=# SELECT to_clob('gauss123'::NCHAR(10)); to_clob ---------- gauss123 (1 row)

  1 2 3 4 5

  openGauss=# SELECT to_clob('gauss234'::VARCHAR(10)); to_clob ---------- gauss234 (1 row)

  1 2 3 4 5

  openGauss=# SELECT to_clob('gauss345'::VARCHAR2(10)); to_clob ---------- gauss345 (1 row)

  1 2 3 4 5

  openGauss=# SELECT to_clob('gauss456'::NVARCHAR2(10)); to_clob ---------- gauss456 (1 row)

  1 2 3 4 5

  openGauss=# SELECT to_clob('World222!'::TEXT); to_clob ----------- World222! (1 row)

• to_date(text)

  描述：将文本类型的值转换为指定格式的时间戳。

  返回值类型：timestamp without time zone

  示例：

  1 2 3 4 5

  openGauss=# SELECT to_date('2015-08-14'); to_date --------------------- 2015-08-14 00:00:00 (1 row)

• to_date(text, text)

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

  返回值类型：timestamp without time zone

  示例：

  1 2 3 4 5

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

• to_number ( expr [, fmt])

  描述：将expr按指定格式转换为一个NUMBER类型的值。

  类型转换格式请参考表1。

  转换十六进制字符串为十进制数字时，最多支持16个字节的十六进制字符串转换为无符号数。

  转换十六进制字符串为十进制数字时，格式字符串中不允许出现除'x'或'X'以外的其他字符，否则报错。

  返回值类型：number

  示例：

  1 2 3 4 5

  openGauss=# SELECT to_number('12,454.8-', '99G999D9S'); to_number ----------- -12454.8 (1 row)

• to_number(text, text)

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

  返回值类型：numeric

  示例：

  1 2 3 4 5

  openGauss=# SELECT to_number('12,454.8-', '99G999D9S'); to_number ----------- -12454.8 (1 row)

• to_timestamp(double precision)

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

  返回值类型：timestamp with time zone

  示例：

  1 2 3 4 5

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

• to_timestamp(string [,fmt])

  描述：将字符串string按fmt指定的格式转换成时间戳类型的值。不指定fmt时，按参数nls_timestamp_format所指定的格式转换。

  GaussDB的to_timestamp中，

  • 如果输入的年份YYYY=0，系统报错。
  • 如果输入的年份YYYY<0，在fmt中指定SYYYY，则正确输出公元前绝对值n的年份。

  fmt中出现的字符必须与日期/时间格式化的模式相匹配，否则报错。

  返回值类型：timestamp without time zone

  示例：

  1 2 3 4 5 6 7 8 9 10 11

  openGauss=# SHOW nls_timestamp_format; nls_timestamp_format ---------------------------- DD-Mon-YYYY HH:MI:SS.FF AM (1 row) openGauss=# SELECT to_timestamp('12-sep-2014'); to_timestamp --------------------- 2014-09-12 00:00:00 (1 row)

  1 2 3 4 5

  openGauss=# SELECT to_timestamp('12-Sep-10 14:10:10.123000','DD-Mon-YY HH24:MI:SS.FF'); to_timestamp ------------------------- 2010-09-12 14:10:10.123 (1 row)

  1 2 3 4 5

  openGauss=# SELECT to_timestamp('-1','SYYYY'); to_timestamp ------------------------ 0001-01-01 00:00:00 BC (1 row)

  1 2 3 4 5

  openGauss=# SELECT to_timestamp('98','RR'); to_timestamp --------------------- 1998-01-01 00:00:00 (1 row)

  1 2 3 4 5

  openGauss=# SELECT to_timestamp('01','RR'); to_timestamp --------------------- 2001-01-01 00:00:00 (1 row)

• to_timestamp(text, text)

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

  返回值类型：timestamp

  示例：

  1 2 3 4 5

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

编码类型转换

convert_to_nocase(text, text)

描述：将字符串转换为指定的编码类型。

返回值类型：bytea

示例：

1
2
3
4
5

openGauss=# SELECT convert_to_nocase('12345', 'GBK');
 convert_to_nocase 
-------------------
 \x3132333435
(1 row)