TO_CHAR 数字或日期转换为字符串

语法

TO_CHAR(x[[,c2],C3])

功能

将日期或数据转换为 char 数据类型。

如果 x 为日期 nlsparm=NLS_DATE_LANGUAGE 控制返回的月份和日份所使用的语言。

如果 x 为数字 nlsparm=NLS_NUMERIC_CHARACTERS 用来指定小数位和千分位的分隔符,以及货币符号。

NLS_NUMERIC_CHARACTERS ="dg", NLS_CURRENCY="string"

如果 x 为数据型时,c1格式表参考:

序号格式简例说明
1,(逗号)'9999,999'逗号,一般以千分位出现,作为分组符号使用.如果需要您也可以当作是十分位,百分位出现,可以出现N次,视乎数字的大小而定.
变态的例子是 to_char(1234,'9,9,9,9').
注意事项:只能出现在整数部分.
2.(点号)'99.99'点号,不要念为"句号",句号是个圆圈,点好只能出现在小数点对应的地方.只能出现一次.
to_char(1234.34,'9,9,9,9.99')
注意事项:只能出现在一个地方,就是原来数据小数点位置
3$(美元符号)'$999.99'美元.其实你可以放在任意地方(在10G下)
to_char(1234.34,'9,9,9,9.$99')
注意事项:只能出现一次.
40(零)'0999.99'零.在对应位置返回对应的字符,如果没有则以'0'填充.
to_char(0.34,'9,9,9,0.$99')='$0.34';to_char(1234,'9999.00')='1234.00';
注意事项:这是一个强制的符号,对应位没有,则以'o'填充,这是9很大不同地方
59'999.99'9.在小数位,则表示转换为对应字符,如果没有则以0表示;在整数位,没有对应则不填充字符.
to_char(123,'999.99')=123.00; TO_CHAR(123,'99999.9')=123.0;
注意事项:对于0和9而言,如果格式的位数不如数字的位数多,会返回'#'.
譬如to_char(12345,'9999')='#####'
6B(空格符)'B999'没有其它特别作用,在整数部分最前面加一个空格,可以出现在任意位置.
'S'||TO_CHAR(1234,'99B99')='S 1234';
注意事项:只能出现在整数部位.
7C(国际货币符号)'C9999'在特定的位置返回一个ISO货币符号(就是NLS_ISO_CURRENCY参数所代表的值)
TO_CHAR(1233,'C9999')='CNY1234' ,这是新的国际标准RMB,关于这个可查询"国际货币符号"
注意事项:只能出现在整数部位第一位.
可以通过alter session set NLS_ISO_CURRENCY='JAPAN';来修改当前会话的设置.
8D(ISO 小数位符号)'999D99'这是"点号"的国际版本(ISO),作用等同于点号,也是只能出现一次.所不同的是,数据库会根据NLS_NUMERIC_CHARACTER的参数值来设置内容.默认的这个值是点号.
注意事项:没有特别需要一般不要用这个格式符号.也不要轻易修改参数值.
也可用alter sesssion set 来修改.
alter session set nls_numeric_characters='!,';   to_char(1234.34,'9999d99')=1234!34
9EEEE(科学计算符)9.9EEEE科学计算符号
TO_CHAR(2008032001,'9.9EEEE')='2.01E+09',由于是科学计算方法,所以小数位前面加一个9或者0即可,多个是没有意义的.
10G(分组符号)999G999是逗号(,)的的ISO标准,作为分组符号使用,可以放在多个地方使用.
TO_CHAR(123456,'999G9G99')=123,4,56
注意事项:同第八项 -D, 此外如果要转换出小数点,则要和D配合使用,不能和点号配合.
11L(本地货币符号)'L999'是C的本地版本.可以放在整个格式的最前面和最后面.
TO_CHAR(123456,'999G9G99D00L')=123,4,56.00¥
注意事项:同第七项 C
12MI(负号)'9999MI'如果是负数,在尾部加上负号(-),如果是正数,则尾巴加上空格
to_char(1234,'9999mi')||'S'||TO_CHAR(-5678,'9999MI') =1234 S5678-
注意事项:只能放在格式尾巴
13PR(符号)9999PR是表达负数的另外一种方式.如果是正数,则头部加上空格;如果是负数,则用小简括号<>把数字包起来.
TO_CHAR(-1234.89,'9G999D00PR')=<1,234.89>
注意事项:同12
14RN(rn)RN(rn)把整数(1-3999)转换为罗马字符.RN表示转为大写,rn表示小写的.
declare
i int;
begin
   for i in 1..20 loop
     dbms_output.put_line(to_char(i,'RN'));
   end loop;
end;
注意事项:只能自己使用,不能和其它符号组合使用.
15S'9999S'是12,13的综合改进版本.为整数加一个正号+,为负数加一个符号-.S在前则加在前,在后则在后.
TO_CHAR(-1234,'S9999')=-1234;TO_CHAR(1234,'S9999')=+1234
16TMTM9/TMe使用这个参数等于没有用参数to_char(number)一样,应为'tm9'是默认的格式参数.
to_char(1234,'tme')=1234
注意事项:格式要么是TM9,要么是TME.
当数字长度超过64位时候,TM9的输出等同于TME的输出.
17UU999双币符号,例如欧元.作用同11的L
TO_CHAR(999,'U999')=¥999
注意事项:通过NLS_DUAL_CURRENCY 控制
18V999V9这是个比较古怪,又不是很常使用的符号。它的作用在于做一个计算。
例如TO_CHAR(N,'999V9'),以p表示V的位置,则该表达式=to_char(N×(10的P-1次方)).但是9个数又必须保证大于等于乘积之后表示的位数.
TO_CHAR(5,'9V')=5*1=5;
TO_CHAR(5,'9V9')=5*10=50
TO_CHAR(5,'9V99')=500
TO_CHAR(50,'9V99')='######' 9的个数不够
注意事项:格式中不能和小数表达写在一起,但是可以混合货币等。
19Xxxxx转换为16进制。
TO_CHAR(100,'XX')= 64
注意事项:数值必须是大于等于0的整数。前面只能和0或者FM组合使用.
20

通过以上的例子,我们了解了各种数字的格式。可以说格式太多样,难于记在脑子,最好是作为一个参考存在着.
归类:
数值类: 0,9,
分组类: (.),(,),D,G ,其中点好和逗号因为表示不明显,所以用小括号凸显。
货币类: $,C,L,U
计算转换类:EEEE,RN,V,X
正负符号:MI,PR,S
其它类:B
正统类:TM

如果 x 为日期型,c2 可用参数如下表:

序号格式简例说明
1- / , . ; :时间分隔符号,除了标准的几个,还允许用文字作为分割符号。
"text"例如 to_char(sysdate,'YYYY"年"mm"月"dd"日"')=2008年04月24日
2AD
即拉丁文Anno Domini的简写,表示公元.会根据nls的不同转换为公元或者ad等
A.D.无特殊注意事项
3AM
上午的简写 ,同pm, p.m. (下午) , 中文环境输出为上午(如果是上午)
A.M.
4BC
虽然标准的写法是B.c. (c小写) 或者BC,好在Oracle不讲究这个。表示公元前
B.C.
5CC
返回世纪,以阿拉伯数字表示
SCC如果年的后两位介于01-99那么,返回前两位+1,否则返回前两位
6D
一周之中的某天,返回的是序号1-7
7DAY
一周之中的某天,不过返回的是星期几而已,这和语言设置有关系,在中国环境 NLS_DATE_LANGUAGE=SIMPLIFIED CHINESE ,用星期一到星期天表示
8DD
月份中的某天(1-31)
9DDD
年份中的某天(1-366)
10DL'DL'返回长的日期格式。受到NLS_TERRITORY,NLS_LANGUAGE参数控制。例 2008年4月28日 星期一
限制:除了DL,其它什么的都不能设置。
11DS
返回短的日期格式。受到NLS_TERRITORY,NLS_LANGUAGE参数控制。 例如 2008-04-28
限制:除了DL,其它什么的都不能设置。
12DY
日期的简称,就是星期几(当然这指的是中国环境下)
13E
纪元简称,但是只适合以下集中日历:日本皇室,中华民国,太过佛历
14EE
纪元全程,适合情况同E
15FF [1..9]
就是毫秒,如果不更上数字就是用默认的精度。
只能用于timestamp类型的。
16FM
值得注意的一个函数:不返回任何内容。
有点不明白oracle为什么设置这个东西.
17FX
同上
18HH
表示小时,为12小时制,同hh12(1-12)
19HH12
表示小时,为12小时制(1-12)
20HH24
表示小时,为24小时制(0-23)
21IW
ISO标准的星期序号(1-52,或者1-53)
22IYYY
IYY,IY,I, ISO年(4位)的4,3,2,1位数字(倒数)
IYYto_char(to_date(21120401,'yyyymmdd'),'iyyy, iyy,iy,i')=2112, 112,12,2
IY
I
23J
儒略日(多用于天文的一种日历),从公元前4712年一月一日算起,得出的结果是个整数,算法大体为 (公元日期+4712)*儒略日历年平均天数
24MI
秒(0-59)
25MM
2位月(1-12)
26MON
月的简称,和国家有关系NLS_DATE_LANGUAGE,例如04在中文环境下用4月表示.
27MONTH
月的名称,国家有关系NLS_DATE_LANGUAGE,目前在中文下04表示为4月。
28PM
同am,a.m.表示下午
P.M.
29Q
季度(1-4)
30RM
用罗马数字表示的月份,I   ,II ,III ,IV ,V   ,VI ,VII ,VIII,IX ,X   ,XI ,XII
31RR
有点四舍五入表示年的意思,具体的用法有那么一点点复杂。
以s表示输入的年份最后两位,c表示当前的年份最后两位,其输出结果(新的年份前两位)可以用函数r=f(s,c)来表示,s2,c2分别表示s,c的前两位。
1)s=[0,49],c=[0,49],则r=c2
2) s=[0,49],c=[50,99],则 r=c2+1
3) s=[50,99],c=[0,49],则r=c2-1
4) s=[50,99],c=[50,99],则 r=c2
简而言之就是靠近当前年份原则,如果和当前年份同区域那么就一样,如果比当前区域大,那么就是当作是当前世纪前一世纪,否则就是下一个世纪。
举例来说,以to_date为例子
SQL> select to_date('89-01-01','rr-mm-dd') ,to_date('12-01-01','rr-mm-dd') FROM DUAL;

TO_DATE('89-01-01','RR-MM-DD') TO_DATE('12-01-01','RR-MM-DD')
------------------------------ ------------------------------
1989-01-01                     2012-01-01
我想oracle会搞这个东东出来,估计有两个考虑一个是为了方便,一个是为了对付百年或者千年问题。
32RRRR
如果输入参数只有两位,则同rr,否则就同yyyy作用.
33SS
秒(0-59),一分钟内
34SSSSS
一天从午夜开始的累积秒数.(0-86399)
35TS
返回短日期格式内容,包括时分秒等,只能和dl,ds组合使用,格式是:
dl ts或者dl ts ,中间以空格间隔开。TO_CHAR(SYSDATE,'TS')=下午 4:50:04
表现形式受NLS_TERRITORY 和NLS_LANGUAGE影响。
36TZD
夏令时制信息,时区简写加上夏令时信息,必须和格式tzr设置的时区对应。
包括下面三个TZ开头的,都是和时区相关,并不是直接用在to_char
37TZH
时区中的小时,例如hh:mi:ss.fftzh:tzm'
38TZM
时区中的分钟.
39TZR
时区中的区域信息,必须是数据库支持的时区,例如US/Pacific
40WW
和iw类似,也是表示星期的序号,从年的第一天算起到年的最后一个第七天。二者取值基本相同。(1-53) ,例如2008-01-01 到2008-01-07 算1,2008-01-09~2008-01-13 算2
41W
一个月中的星期序号,其算法同ww,不过是局限在一月之内而已,和iso的不同。
42X
代表本地根符号,没有特别用处,只能和timestamp类型一起使用.
43Y,YYY
四位年,用都好分隔 例如2,008
44YEAR
发音表达的年,例如 2008=two thousand eight
SYEARS前缀表示公元前BC
45YYYY
四位年,S前缀表示公元前BC
SYYYY
46YYY
一次表示后面3,2,1位的年,例如2008 可以分别取值为008,08,8
YY
Y

总结
从以上看,主要就是表示时间几个部分的格式:世纪、年,月,日,时,分,秒,毫秒,以及其它一些混合格式。每个时间部分都可以有多种的表达方式,通过这样归类就比较容易记忆。
很多格式可以组合使用,这样最终可以形成足够丰富的表达其形势;
其次很多格式和nls是密切相关的;最后某些输出(返回)和格式大小写是有关系的,这在中文环境下体现不出来(目前来没有看到),但是english环境下就名下,以to_char(sysdate,'day')为例子,如果是西文环境是返回sun(假设sysdate位于周末),如果to_char(sysdate,'DAY')则返回SUN

参数

  • x 是一个 date 或 number 数据类型

  • c2 为格式参数

  • c3 为 NLS 设置参数

返回值

varchar2 字符型

示例

SQL> select to_char(sysdate,' PM yyyy-mm-dd hh24:mi:sssss AD year mon day ddd iw') FROM DUAL;

TO_CHAR(SYSDATE,'PMYYYY-MM-DDHH24:MI:SSSSSADYEARMONDAYDDDIW')
--------------------------------------------------------------------------------
 下午 2022-05-08 16:01:57704 公元 twenty twenty-two 5月  星期日 128 18
 
 
 SQL> SELECT TO_CHAR(SYSTIMESTAMP,'HH24:MI:SS.FF5') FROM DUAL;

TO_CHAR(SYSTIMESTA
------------------
16:02:03.09300


SQL> SELECT TO_CHAR(SYSDATE,'DS DL') FROM DUAL;

TO_CHAR(SYSDATE,'DSDL')
-----------------------------------
2022-05-08 2022年5月8日 星期日

更多用法如下:

  • to_char(1210.73, '9999.9') 返回 '1210.7'

  • to_char(1210.73, '9,999.99') 返回 '1,210.73'

  • to_char(1210.73, '$9,999.00') 返回 '$1,210.73'

  • to_char(21, '000099') 返回 '000021'

  • to_char(852,'xxxx') 返回' 354'

  • to_char(sysdate,'d') 每周第几天

  • to_char(sysdate,'dd') 每月第几天

  • to_char(sysdate,'ddd') 每年第几天

  • to_char(sysdate,'ww') 每年第几周

  • to_char(sysdate,'mm') 每年第几月

  • to_char(sysdate,'q') 每年第几季

  • to_char(sysdate,'yyyy') 年

关于
本网站专注于 Java、数据库(MySQL、Oracle)、Linux、软件架构及大数据等多领域技术知识分享。涵盖丰富的原创与精选技术文章,助力技术传播与交流。无论是技术新手渴望入门,还是资深开发者寻求进阶,这里都能为您提供深度见解与实用经验,让复杂编码变得轻松易懂,携手共赴技术提升新高度。如有侵权,请来信告知:hxstrive@outlook.com
公众号