TO_CHAR

聚焦模式

TO_CHAR - Amazon Redshift

TO_CHAR 将时间戳或数值表达式转换为字符串数据格式。

语法


TO_CHAR (timestamp_expression | numeric_expression , 'format')

参数

timestamp_expression: 一个表达式，用于生成 TIMESTAMP 或 TIMESTAMPTZ 类型值或可隐式强制转换为时间戳的值。
numeric_expression: 一个表达式，用于生成数字数据类型值或可隐式强制转换为数字类型的值。有关更多信息，请参阅数字类型。TO_CHAR 在数字串左侧插入空格。

注意
TO_CHAR 不支持 128 位 DECIMAL 值。
format: 新值的格式。有关有效格式，请参阅日期时间格式字符串和数字格式字符串。

返回类型

VARCHAR

示例

以下示例将时间戳转换为一个具有日期和时间的值，格式为月份名称填充为九个字符、星期几的名称和当月的日期编号。


select to_char(timestamp '2009-12-31 23:15:59', 'MONTH-DY-DD-YYYY HH12:MIPM');

to_char
-------------------------
DECEMBER -THU-31-2009 11:15PM

以下示例将时间戳转换为具有这一年中日期编号的值。


select to_char(timestamp '2009-12-31 23:15:59', 'DDD');

to_char
-------------------------
365

以下示例将时间戳转换为这一周的 ISO 日期编号。


select to_char(timestamp '2022-05-16 23:15:59', 'ID');

to_char
-------------------------
1

以下示例从日期中提取月份名称。


select to_char(date '2009-12-31', 'MONTH');

to_char
-------------------------
DECEMBER

以下示例将 EVENT 表中的每个 STARTTIME 值转换为由小时、分钟和秒组成的字符串。


select to_char(starttime, 'HH12:MI:SS')
from event where eventid between 1 and 5
order by eventid;

to_char
----------
02:30:00
08:00:00
02:30:00
02:30:00
07:00:00

以下示例将整个时间戳值转换为不同的格式。


select starttime, to_char(starttime, 'MON-DD-YYYY HH12:MIPM')
from event where eventid=1;

      starttime      |       to_char
---------------------+---------------------
 2008-01-25 14:30:00 | JAN-25-2008 02:30PM

以下示例将时间戳文本转换为字符串。


select to_char(timestamp '2009-12-31 23:15:59','HH24:MI:SS');

to_char
----------
23:15:59

以下示例将十进制数转换为字符串。


select to_char(125.8, '999.99');

to_char
---------
125.80

以下示例将十进制数转换为字符串。


select to_char(125.8, '999D99');

to_char
---------
125.80

以下示例将数字转换为具有一个前导零的字符串。


select to_char(125.8, '0999D99');

to_char
---------
0125.80

以下示例将一个数字转换为末尾带负号的字符串。


select to_char(-125.8, '999D99S');

to_char
---------
125.80-

以下示例将数字转换为在指定位置带有正号或负号的字符串。


select to_char(125.8, '999D99SG');

to_char
---------
125.80+

以下示例将数字转换为在指定位置带有正号的字符串。


select to_char(125.8, 'PL999D99');

to_char
---------
+ 125.80

以下示例将一个数字转换为带货币符号的字符串。


select to_char(-125.88, '$S999D99');

to_char
---------
$-125.88

以下示例将数字转换为在指定位置带货币符号的字符串。


select to_char(-125.88, 'S999D99L');

to_char
---------
-125.88$

以下示例使用千位（逗号）分隔符将数字转换为字符串。


select to_char(1125.8, '9,999.99');

to_char
---------
1,125.80

以下示例将一个数字转换为用尖括号将负数括起来的字符串。


select to_char(-125.88, '$999D99PR');

to_char
---------
$<125.88>

以下示例将一个数字转换为罗马数字字符串。


select to_char(125, 'RN');

to_char
---------
   CXXV

以下示例将日期转换为世纪代码。


select to_char(date '2020-12-31', 'CC');

to_char
---------
21

以下示例显示一周中的某天。


SELECT to_char(current_timestamp, 'FMDay, FMDD HH12:MI:SS');

to_char
-----------------------
Wednesday, 31 09:34:26

以下示例显示数字的序数后缀。


SELECT to_char(482, '999th');

to_char
-----------------------
 482nd

以下示例将销售表中支付的价格减去佣金。差随后将向上舍入并转换为罗马数字，如 to_char 列中所示：


select salesid, pricepaid, commission, (pricepaid - commission)
as difference, to_char(pricepaid - commission, 'rn') from sales
group by sales.pricepaid, sales.commission, salesid
order by salesid limit 10;

 salesid | pricepaid | commission | difference |     to_char
---------+-----------+------------+------------+-----------------
       1 |    728.00 |     109.20 |     618.80 |           dcxix
       2 |     76.00 |      11.40 |      64.60 |             lxv
       3 |    350.00 |      52.50 |     297.50 |        ccxcviii
       4 |    175.00 |      26.25 |     148.75 |           cxlix
       5 |    154.00 |      23.10 |     130.90 |           cxxxi
       6 |    394.00 |      59.10 |     334.90 |         cccxxxv
       7 |    788.00 |     118.20 |     669.80 |           dclxx
       8 |    197.00 |      29.55 |     167.45 |          clxvii
       9 |    591.00 |      88.65 |     502.35 |             dii
      10 |     65.00 |       9.75 |      55.25 |              lv

以下示例向 to_char 列中显示的差值添加货币符号：


select salesid, pricepaid, commission, (pricepaid - commission)
as difference, to_char(pricepaid - commission, 'l99999D99') from sales
group by sales.pricepaid, sales.commission, salesid
order by salesid limit 10;

salesid | pricepaid | commission | difference |  to_char
--------+-----------+------------+------------+------------
      1 |    728.00 |     109.20 |     618.80 | $   618.80
      2 |     76.00 |      11.40 |      64.60 | $    64.60
      3 |    350.00 |      52.50 |     297.50 | $   297.50
      4 |    175.00 |      26.25 |     148.75 | $   148.75
      5 |    154.00 |      23.10 |     130.90 | $   130.90
      6 |    394.00 |      59.10 |     334.90 | $   334.90
      7 |    788.00 |     118.20 |     669.80 | $   669.80
      8 |    197.00 |      29.55 |     167.45 | $   167.45
      9 |    591.00 |      88.65 |     502.35 | $   502.35
     10 |     65.00 |       9.75 |      55.25 | $    55.25

以下示例列出了完成每次销售的世纪。


select salesid, saletime, to_char(saletime, 'cc') from sales
order by salesid limit 10;

 salesid |      saletime       | to_char
---------+---------------------+---------
       1 | 2008-02-18 02:36:48 | 21
       2 | 2008-06-06 05:00:16 | 21
       3 | 2008-06-06 08:26:17 | 21
       4 | 2008-06-09 08:38:52 | 21
       5 | 2008-08-31 09:17:02 | 21
       6 | 2008-07-16 11:59:24 | 21
       7 | 2008-06-26 12:56:06 | 21
       8 | 2008-07-10 02:12:36 | 21
       9 | 2008-07-22 02:23:17 | 21
      10 | 2008-08-06 02:51:55 | 21

以下示例将 EVENT 表中的每个 STARTTIME 值转换为由小时、分钟、秒和时区组成的字符串：


select to_char(starttime, 'HH12:MI:SS TZ')
from event where eventid between 1 and 5
order by eventid;

to_char
----------
02:30:00 UTC
08:00:00 UTC
02:30:00 UTC
02:30:00 UTC
07:00:00 UTC

以下示例显示了秒、毫秒和微秒的格式设置。


select sysdate,
to_char(sysdate, 'HH24:MI:SS') as seconds,
to_char(sysdate, 'HH24:MI:SS.MS') as milliseconds,
to_char(sysdate, 'HH24:MI:SS:US') as microseconds;

timestamp           | seconds  | milliseconds | microseconds   
--------------------+----------+--------------+----------------
2015-04-10 18:45:09 | 18:45:09 | 18:45:09.325 | 18:45:09:325143