ORACLE的TO_CHAR函数详解

本来这是很简单的函数，但在屡次忘记格式之后，决定还是翻译一遍以铭记在心。
      参考<<Oracle Database SQL Reference>>.
      关于nls可有取值，请注意视图sys.V_$NLS_VALID_VALUES
     一 ，TO_CHAR(NUMBER)
本函数把参数N转为一个VARCHAR2类型的数值。N可以是NUMBER,BINARY_FLOAT,或者BINARY_DOUBLE。如果不带格式，那么函数会把N转换为足以表示N的VARCHAR2字符串。
      格式表参考：
     
序号
格式 简例 说明
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')
注意事项:只能出现一次.

4 0(零) '0999.99'
零.在对应位置返回对应的字符,如果没有则以'0'填充.
to_char(0.34,'9,9,9,0.$99')='$0.34';to_char(1234,'9999.00')='1234.00';
注意事项:这是一个强制的符号,对应位没有,则以'o'填充,这是9很大不同地方

5 9 '999.99'
9.在小数位,则表示转换为对应字符,如果没有则以0表示;在整数位,没有对应则不填充字符.
to_char(123,'999.99')=123.00; TO_CHAR(123,'99999.9')=123.0;
注意事项:对于0和9而言,如果格式的位数不如数字的位数多,会返回'#'.
譬如to_char(12345,'9999')='#####'

6 B(空格符) 'B999' 没有其它特别作用,在整数部分最前面加一个空格,可以出现在任意位置.
'S'||TO_CHAR(1234,'99B99')='S 1234';
注意事项:只能出现在整数部位.

7 C(国际货币符号) 'C9999' 在特定的位置返回一个ISO货币符号(就是NLS_ISO_CURRENCY参数所代表的值)
TO_CHAR(1233,'C9999')='CNY1234' ,这是新的国际标准RMB,关于这个可查询"国际货币符号"
注意事项:只能出现在整数部位第一位.
可以通过alter session set NLS_ISO_CURRENCY='JAPAN';来修改当前会话的设置.

8 D(ISO 小数位符号) '999D99'
这是"点号"的国际版本(ISO),作用等同于点号,也是只能出现一次.所不同的是,数据库会根据NLS_NUMERIC_CHARACTER的参数值来设置内容.默认的这个值是点号.
注意事项:没有特别需要一般不要用这个格式符号.也不要轻易修改参数值.
也可用alter sesssion set 来修改.
alter session set nls_numeric_characters='!,';   to_char(1234.34,'9999d99')=1234!34

9 EEEE(科学计算符) 9.9EEEE 科学计算符号
TO_CHAR(2008032001,'9.9EEEE')='2.01E+09',由于是科学计算方法,所以小数位前面加一个9或者0即可,多个是没有意义的.

10 G(分组符号) 999G999 是逗号(,)的的ISO标准,作为分组符号使用,可以放在多个地方使用.
TO_CHAR(123456,'999G9G99')=123,4,56
注意事项:同第八项 -D, 此外如果要转换出小数点,则要和D配合使用,不能和点号配合.
11 L(本地货币符号) 'L999' 是C的本地版本.可以放在整个格式的最前面和最后面.
TO_CHAR(123456,'999G9G99D00L')=123,4,56.00￥
注意事项:同第七项 C

12 MI(负号) '9999MI'
如果是负数,在尾部加上负号(-),如果是正数,则尾巴加上空格
to_char(1234,'9999mi')||'S'||TO_CHAR(-5678,'9999MI') =1234 S5678-
注意事项:只能放在格式尾巴

13 PR(符号) 9999PR 是表达负数的另外一种方式.如果是正数,则头部加上空格;如果是负数,则用小简括号<>把数字包起来.
TO_CHAR(-1234.89,'9G999D00PR')=<1,234.89>
注意事项:同12

14 RN(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;
注意事项:只能自己使用,不能和其它符号组合使用.

15 S '9999S' 是12,13的综合改进版本.为整数加一个正号+,为负数加一个符号-.S在前则加在前,在后则在后.
TO_CHAR(-1234,'S9999')=-1234;TO_CHAR(1234,'S9999')=+1234

16 TM TM9/TMe
使用这个参数等于没有用参数to_char(number)一样,应为'tm9'是默认的格式参数.
to_char(1234,'tme')=1234
注意事项:格式要么是TM9,要么是TME.
当数字长度超过64位时候,TM9的输出等同于TME的输出.

17 U U999 双币符号,例如欧元.作用同11的L
TO_CHAR(999,'U999')=￥999
注意事项：通过NLS_DUAL_CURRENCY 控制

18 V 999V9 这是个比较古怪，又不是很常使用的符号。它的作用在于做一个计算。
例如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的个数不够
注意事项：格式中不能和小数表达写在一起，但是可以混合货币等。

19 X xxxx 转换为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

      1.2 格式说明
      从上图可以看到格式是可选取的，保留字fmt也不是必须的，关键是NLSPARAM的意思，
      从第2-54章节（FORMAT MODELS)查看。
      NLSPARAM可以是这样　'NLS_NUMERIC_CHARACTERS = ''dg'' NLS_CURRENCY = ''text'' NLS_ISO_CURRENCY = territory '
　　举例：(待续)
　　SELECT TO_CHAR(-10000, 'C99G999D99PR',
               'NLS_NUMERIC_CHARACTERS=''._'' NLS_ISO_CURRENCY=''UNITED KINGDOM''') "Amount"
       FROM DUAL;
       结果返回：<GBP10_000.00>
       如果要了解可以使用的NLS_ISO_CURRENCY值,可以查询数据库的视图V_$NLS_VALID_VALUES
      二， TO_CHAR(CHARACTER)
　　把NCLOB,CLOB,NCHAR转换为VARCHAR2.
      三， TO_CHAR(DATETIME)
　　把日期转化为字符串.
       关于这个格式，没有什么太好说的。它的格式主要分为两类：简写单个字母（或者其复现形式）代表时间位置譬如yyyy ,mm,dd ,hh之类;其次是以英文的时间单词的简写代表时间，例如mon,day,year.     
       下表的格式基本上也都可以用于TO_DATE, TO_TIMESTAMP, TO_TIMESTAMP_TZ, TO_YMINTERVAL,
TO_DSINTERVAL函数。
序号
格式
简例
说明

1 - / , . ; :
"text" 略 时间分隔符号，除了标准的几个，还允许用文字作为分割符号。
例如 to_char(sysdate,'YYYY"年"mm"月"dd"日"')=2008年04月24日

2 AD
A.D.    即拉丁文Anno Domini的简写，表示公元.会根据nls的不同转换为公元或者ad等
无特殊注意事项

3 AM
A.M.    上午的简写 ,同pm, p.m. （下午) , 中文环境输出为上午（如果是上午）

4 BC
B.C.    虽然标准的写法是B.c. (c小写） 或者BC,好在Oracle不讲究这个。表示公元前

5 CC
SCC    返回世纪，以阿拉伯数字表示
如果年的后两位介于01-99那么，返回前两位+1，否则返回前两位

6 D    一周之中的某天，返回的是序号1-7
7 DAY    一周之中的某天，不过返回的是星期几而已，这和语言设置有关系，在中国环境 NLS_DATE_LANGUAGE=SIMPLIFIED CHINESE ，用星期一到星期天表示

8 DD   月份中的某天(1-31)

9 DDD    年份中的某天（1-366）
10 DL 'DL' 返回长的日期格式。受到NLS_TERRITORY,NLS_LANGUAGE参数控制。例 2008年4月28日 星期一
限制：除了DL，其它什么的都不能设置。

11 DS    返回短的日期格式。受到NLS_TERRITORY,NLS_LANGUAGE参数控制。 例如 2008-04-28
限制：除了DL，其它什么的都不能设置。
12 DY    日期的简称，就是星期几（当然这指的是中国环境下)
13 E    纪元简称，但是只适合以下集中日历：日本皇室，中华民国,太过佛历
14 EE    纪元全程，适合情况同E
15 FF [1..9]    就是毫秒,如果不更上数字就是用默认的精度。
只能用于timestamp类型的。

16 FM    值得注意的一个函数：不返回任何内容。
有点不明白oracle为什么设置这个东西.

17 FX    同上
18 HH    表示小时，为12小时制，同hh12(1-12)
19 HH12    表示小时，为12小时制(1-12)
20 HH24    表示小时，为24小时制（0-23）

21 IW    ISO标准的星期序号(1-52,或者1-53）
22 IYYY
IYY
IY
I
   IYY,IY,I, ISO年(4位）的4,3，2，1位数字(倒数）
to_char(to_date(21120401,'yyyymmdd'),'iyyy, iyy,iy,i')=2112, 112,12,2

23 J    儒略日(多用于天文的一种日历）,从公元前4712年一月一日算起，得出的结果是个整数，算法大体为 （公元日期+4712）*儒略日历年平均天数
24 MI    秒（0-59）
25 MM    2位月（1-12）
26 MON    月的简称，和国家有关系NLS_DATE_LANGUAGE，例如04在中文环境下用4月表示.

27 MONTH    月的名称，国家有关系NLS_DATE_LANGUAGE,目前在中文下04表示为4月。
28 PM
P.M.
    同am,a.m.表示下午
29 Q    季度（1-4）
30 RM    用罗马数字表示的月份，I   ,II ,III ,IV ,V   ,VI ,VII ,VIII,IX ,X   ,XI ,XII

31 RR    有点四舍五入表示年的意思，具体的用法有那么一点点复杂。
以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会搞这个东东出来，估计有两个考虑一个是为了方便，一个是为了对付百年或者千年问题。

32 RRRR    如果输入参数只有两位，则同rr，否则就同yyyy作用.
33 SS    秒（0-59），一分钟内

34 SSSSS    一天从午夜开始的累积秒数.(0-86399)
35 TS    返回短日期格式内容，包括时分秒等,只能和dl,ds组合使用，格式是:
dl ts或者dl ts ,中间以空格间隔开。TO_CHAR(SYSDATE,'TS')=下午 4:50:04
表现形式受NLS_TERRITORY 和NLS_LANGUAGE影响。

36 TZD    夏令时制信息，时区简写加上夏令时信息，必须和格式tzr设置的时区对应。
包括下面三个TZ开头的，都是和时区相关，并不是直接用在to_char

37 TZH    时区中的小时，例如hh:mi:ss.fftzh:tzm'
38 TZM    时区中的分钟.

39 TZR    时区中的区域信息，必须是数据库支持的时区，例如US/Pacific
40 WW    和iw类似，也是表示星期的序号，从年的第一天算起到年的最后一个第七天。二者取值基本相同。（1-53） ，例如2008-01-01 到2008-01-07 算1，2008-01-09~2008-01-13 算2

41 W    一个月中的星期序号，其算法同ww,不过是局限在一月之内而已，和iso的不同。
42 X    代表本地根符号，没有特别用处，只能和timestamp类型一起使用.
43 Y,YYY    四位年，用都好分隔 例如2,008

44 YEAR
SYEAR    发音表达的年，例如 2008=two thousand eight
S前缀表示公元前BC

45 YYYY
SYYYY    四位年，S前缀表示公元前BC
46 YYY
YY
Y    一次表示后面3，2，1位的年，例如2008 可以分别取值为008,08,8

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




使用前对一些不确定的先试验一下最好，实在不行就查阅oracle的原始文档.






       由于可以采取非常多的格式，所以实在是很灵活的.下面简单的举例几个：
       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-DDH
       --------------------------------------------------------------------------------
      上午 2008-03-27 09:58:35917 公元   two thousand eight 3月 星期四 087 13
       SQL> SELECT TO_CHAR(SYSTIMESTAMP,'HH24:MI:SS.FF5') FROM DUAL;
       TO_CHAR(SYSTIMESTAMP,'HH24:MI:
       ------------------------------
       10:02:28.90000
       SQL>SELECT TO_CHAR(SYSDATE,'DS DL') FROM DUAL
       TO_CHAR(SYSDATE,'DSDL')
        -----------------------------------
       2008-03-27 2008年3月27日 星期四
       最后一个和国家地区有关.


本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/jinlong5200/archive/2008/10/24/3135949.aspx