| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 9. 함수와 연산자 | Fast Forward | Next |
PostgreSQL의 서식 설정 함수는 다양한 데이터형(일자/시각 데이터형, 정수 데이터형, 부동 소수점수(실수) 데이터형, 수치 데이터형)이 정형된 문자열으로 변환하거나 정형된 문자열을 특정의 데이터형으로 변환하는 강력한 툴의 일식을 제공하고 있습니다. Table 9-20에 이것들을 열거하고 있습니다. 이들 함수는 공통의 호출 규약을 따르고 있습니다. 최초의 인수는 정형되는 값으로 2번째의 인수는 입력 서식 또는 출력 서식을 정의하는 템플릿입니다.
to_timestamp함수는 Unix 시각부터timestamp with time zone로 변환하는 다만 하나의double precision인수를 취할 수도 있습니다.
(int Unix 시각은 암묵적으로double precision에 캐스트 됩니다. )
Table 9-20. 서식 설정 함수
| 함수 | 반환값 | 설명 | 예 |
|---|---|---|---|
to_char(timestamp, text)
|
text | 타임 스탬프를 문자열로 변환 | to_char(current_timestamp, 'HH12:MI:SS') |
to_char(interval, text)
|
text | 시간 간격을 문자열로 변환 | to_char(interval '15h 2m 12s', 'HH24:MI:SS') |
to_char(int, text)
|
text | 정수를 문자열로 변환 | to_char(125, '999') |
to_char(double precision,
text)
|
text | 실수, 배정밀도수를 문자열로 변환 | to_char(125.8::real, '999D9') |
to_char(numeric, text)
|
text | 수치를 문자열로 변환 | to_char(-125. 8, '999D99S') |
to_date(text, text)
|
date | 문자열을 일자로 변환 | to_date('05 Dec 2000', 'DD Mon YYYY') |
to_number(text, text)
|
numeric | 문자열을 수치로 변환합니다 | to_number('12,454.8-', '99G999D9S') |
to_timestamp(text, text)
|
timestamp with time zone | 문자열을 타임 스탬프로 변환 | to_timestamp('05 Dec 2000', 'DD Mon YYYY') |
to_timestamp(double precision)
|
timestamp with time zone | UNIX 시각을 타임 스탬프로 변환 | to_timestamp(200120400) |
(to_char용) 출력 템플릿 문자열로는, 그것이 인식되어 정형되는 값으로부터 적절히 정형된 데이터로 치환하는 패턴이 있습니다.
템플릿 패턴이 아닌 모든 텍스트는 단지 그대로 복사됩니다.
이와 유사하게, (to_char이외 용) 입력 템플릿 문자열로서는, 템플릿 패턴은 입력된 데이터 문자열이 보이는 부분과 거기서 발견된 값을 특정합니다.
Table 9-21에, 일자/시각형의 값의 서식에 사용 가능한 템플릿 패턴을 나타냅니다.
Table 9-21. 일자/시각형의 서식 템플릿 패턴
| 패턴 | 설명 |
|---|---|
| HH | 때(01~12) |
| HH12 | 때(01~12) |
| HH24 | 때(00~23) |
| MI | 분 (00~59) |
| SS | 초(00~59) |
| MS | 밀리 세컨드(000~999) |
| US | 마이크로 세컨드(000000~999999) |
| SSSS | 심야 0시부터의 초수(0~86399) |
| AM,A.M. , PM, 또는P.M. | 오전/오후의 지정(대문자) |
| am,a.m. , pm, 또는p.m. | 오전/오후의 지정(소문자) |
| Y, YYY | 구두점(콤마)과 연도(4자리수 이상) |
| YYYY | 연도(4자리수 이상) |
| YYY | 연도의 마지막 3자리수 |
| YY | 연도의 마지막 2자리수 |
| Y | 연도의 마지막 1자리수< |
| IYYY | ISO연도(4이상의 자리수) |
| IYY | ISO연도의 마지막 3자리수 |
| IY | ISO연도의 마지막 2자리수 |
| I | ISO연도의 마지막 1자리수 |
| BC,B.C. , AD, 또는A.D. | 기원 전, 후의 지정(대문자) |
| bc,b.c. , ad, 또는a.d. | 기원 전, 후의 지정(소문자) |
| MONTH | 완전히 대문자로된 월명(9 문자가 되도록 공백에서 패드) |
| Month | 대문자 소문자 혼재한 완전한 월명(9 문자가 되도록 공백에서 패드) |
| month | 소문자에서의 완전한 월명(9 문자가 되도록 공백에서 패드) |
| MON | 대문자에서의 단축형의 월명(영어에서는 3 문자, 현지어화 되었을 경우는 가변장) |
| Mon | 대문자 소문자 혼재한 단축형의 월명(영어에서는 3 문자. 현지어화 되었을 경우는 가변장) |
| mon | 소문자에서의 단축형의 월명(영어에서는 3 문자. 현지어화 되었을 경우는 가변장) |
| MM | 월의 숫자(01~12) |
| DAY | 완전히 대문자로된 요일명(9 문자가 되도록 공백에서 패드) |
| Day | 대문자 소문자 혼재한 완전한 요일명(9 문자가 되도록 공백에서 패드) |
| day | 완전히 소문자로된 요일명(9 문자가 되도록 공백에서 패드) |
| DY | 단축형의 대문자에서의 단축형의 요일명(영어에서는 3 문자. 현지어화 되었을 경우는 가변장) |
| Dy | 단축형의 대문자 소문자 혼재한 단축형의 요일명(영어에서는 3 문자. 현지어화 되었을 경우는 가변장) |
| dy | 소문자로된 단축형의 요일명(영어에서는 3 문자. 현지어화 되었을 경우는 가변장) |
| DDD | 연중의 일(001~366) |
| IDDD | ISO 연중의 일(001-371：연중 제 1일은 최초의 ISO주의 월요일) |
| DD | 한달 통산의 일(01~31) |
| D | 1주 통산의 요일 번호, 일요일(1)부터 토요일(7)까지 |
| W | 월중의 주번호(1~5)(그 달의 첫날이 있는 주가 제1주) |
| WW | 연중 주번호(1~53)(설날이 있는 주가 제1주) |
| IW | 연중 ISO 주번호(1 - 53：신년의 최초의 목요일이 있는 주가 제1주) |
| CC | 세기(2자리수. 21 세기는2001-01-01에 시작) |
| J | 율리우스일(기원 전 4714년 11월 24일 오전 영시부터의 통산 경과일) |
| Q | 분기 |
| RM | 로마 숫자에 의한 달(I~XII：I=1월)(대문자) |
| rm | 로마 숫자에 의한 달(i~xii：i=1월)(소문자) |
| TZ | 시간대명(대문자) |
| tz | 시간대명(소문자) |
어떤 종류의 수식자는 어떠한 템플릿 패턴에 대해서도, 그 행동을 변경하기 위해서 적용할 수가 있습니다. 예를 들면,FMMonth는FM수식자가 붙은Month패턴입니다. Table 9-22에서는, 일자/시각 서식의 수식자 패턴을 나타냅니다.
Table 9-22. 일자/시각 서식용의 템플릿 패턴 수식자
| 수식자 | 설명 | 예 |
|---|---|---|
| FM접두사 | 글자 수 모드(공백 및 제로의 패딩을 무효로한다) | FMMonth |
| TH접미말 | 대문자의 서수를 추가 | DDTH |
| th suffix | 소문자의 서수를 추가 | DDth |
| FX prefix | 고정 서식의 글로벌 옵션(사용상의 주의 사항을 참조) | FX Month DD Day |
| TM접두사 | 번역 모드(lc_messages에 기초를 두어, 번역된 일자, 첨부를 표시합니다. ) | TMMonth |
| SP접미말 | 스펠 모드(아직 실행되지 않았습니다) | DDSP |
일자/시각형 서식의 사용상의 주의 사항은 다음과 같습니다.
FM는 패턴의 출력을 고정장으로 하기 위해, 선두에는 제로, 말미에는 공백을 추가하는 기능을 무효로 합니다.
TM에는 말미의 공백은 포함되지 않습니다.
FX옵션이 템플릿이 사용되어 있지 않은 경우에는,to_timestamp와to_date는 입력 문자열의 복수의 공백 스페이스를 무시합니다.
FX는 템플릿의 제1항목으로서 지정될 필요가 있습니다.
예를 들면,to_timestamp에는 단 1개의 스페이스가 있게 되어 있으므로,to_timestamp('2000 JUN', 'YYYY MON')가 올바르고,to_timestamp('2000 JUN', 'FXYYYY MON')는 에러를 반환합니다.
to_char템플릿에서는, 통상의 텍스트가 허용되어 그대로 출력됩니다.
서브스트링을 이중 인용부호로 둘러싸고, 서브스트링에 패턴용의 키워드가 있었다고 해도, 강제적으로 리터럴 텍스트로서 해석시킬 수가 있습니다.
예를 들면,'"Hello Year "YYYY'에서는YYYY는 연도 데이터에 치환되어 버립니다만,Year내의Y는 치환되지 않습니다.
출력에 이중 인용부호를 붙이고 싶은 경우,E'\\"YYYY Month\\"'와 같이 그 전에 백슬래시를 붙여야 합니다 (이스케이프 문자열 구문을 사용하는 경우, backslash는 이미 특별한 의미를 가지기 때문에, 2개의 backslash가 필요합니다).
문자열을timestamp형 혹은date형으로 하는YYYY변환은, 연도의 값으로 4자리수 이상의 숫자를 사용하고 있으면 제한이 가해집니다. 이러한 경우, 숫자 이외의 문자 또는YYYY의 뒤에 템플릿을 사용해야 합니다. 그렇게 하지 않으면 연도는 항상 4자리수로 해석됩니다. 예를 들면(20000년으로서),to_date('200001131', 'YYYYMMDD')는 4자리수의 연도라고 해석되므로,to_date('20000-1131', 'YYYY-MMDD')또는to_date('20000Nov31', 'YYYYMonDD')와 같이 숫자가 아닌 단락 부호의 사용을 추천합니다.
문자열에서 timestamp혹은date으로의 변환에 대해,YYY,YYYY, 혹은Y, YYY필드가 존재하면, CC필드는 무시됩니다. CC가YY혹은Y와 함께 사용되면, 연도는(CC-1) *100+YY와 같이 계산됩니다.
문자열로부터timestamp형으로의 변환에 즈음해, 밀리 세컨드MS및 마이크로 세컨드US의 값은 소수점 2번째 자리로서 사용됩니다. 예를 들면,to_timestamp('12:3', 'SS:MS')는 3 밀리 세컨드는 아니고 300 밀리 세컨드입니다. 왜냐하면 변환에 대해 이것은 12 + 0.3으로 계산되기 때문입니다. 그 말은,SS:MS서식에 대해서 입력치인12:3,12:30, 및12:300은 같은 밀리 세컨드수를 지정합니다. 3 밀리 세컨드수가 필요한 경우에는12:003과 같이 해야 합니다. 이 때, 변환에 대해 12 + 0.003 = 12.003초로 계산합니다.
좀 더 복잡한 예를 듭니다. to_timestamp('15:12:02. 020.001230', 'HH:MI:SS.MS.US')는 15시간 12분과 2초+20밀리 세컨드+1230마이크로 세컨드 = 2.021230초입니다.
주를 넘버링하는 to_char의 일은('D'의 서식 패턴을 참조) extract함수의 것과는 다릅니다.
to_char(interval)함수는 하루의 시간을HH와
HH12와 같이 포맷 합니다. 한편HH24는 하루를 넘기는 시간을 >24 와 같이 출력합니다.
Table 9-23에, 수치형의 값의 서식 설정에 사용 가능한 템플릿 패턴을 나타냅니다.
Table 9-23. 수치 서식용의 템플릿 패턴
| 패턴 | 설명 |
|---|---|
| 9 | 지정된 자리수에서의 값 |
| 0 | 전에 제로가 붙은 값 |
| . (콤마) | 소수점 |
| , | 천단위로 단락짓는 부호 |
| PR | 음의 값의 꺽쇄묶음 표시 |
| S | (로케일 사용의) 부호 첨부치 |
| L | (로케일 사용의) 통화 기호 |
| D | (로케일 사용의) 소수점 |
| G | (로케일 사용의) 그룹 단락 문자 |
| MI | (수치 < 0이면) 지정 위치에 마이너스 기호 |
| PL | (수치 > 0이면) 지정 위치에 플러스 기호 |
| SG | 지정된 위치에 플러스/마이너스 기호 |
| RN | (1~3999의 입력치에 의한다) 로마 숫자 |
| TH또는th | 서수접미말 |
| V | n 자리수 쉬프트(주의 사항을 참조) |
| EEEE | 과학기술 표기법(미실행) |
수치형 서식의 사용상의 주의 사항은 다음과 같습니다.
SG,PL, 또는MI로 정형된 부호는, 수치로 관련지을 수 없습니다. 예를 들면,to_char(-12, 'S9999')는' -12'되는 한편,to_char(-12, 'MI9999')는'- 12'됩니다. Oracle의 실행에서는9의 앞에MI가 놓여져서는 안되며,9의 뒤에MI가 놓여지는 것을 요구하고 있습니다.
9는9가 줄지어 있는 수와 같은 자리수의 값을 출력합니다. 자리수가 사용 가능하지 않은 경우, 스페이스를 출력합니다.
TH는 0 미만의 값과 소수는 변환하지 않습니다
PL,SG, 및TH는PostgreSQL의 확장입니다.
V는 입력치를 유효하게10^
n
승 합니다.
여기서
n
는V에 계속되는 자리수입니다.
to_char함수는 소수점을 포함한 수치와V와의 혼재를 지원하지 않습니다(예를 들면,99.9V99 는 허가되지 않습니다).
Table 9-24에서,to_char함수를 사용한 몇 개의 예를 볼 수 있습니다.
Table 9-24. to_char Examples
| Expression | Result |
|---|---|
| to_char(current_timestamp, 'Day, DD HH12:MI:SS') | 'Tuesday , 06 05:39:18' |
| to_char(current_timestamp, 'FMDay, FMDD HH12:MI:SS') | 'Tuesday, 6 05:39:18' |
| to_char(-0.1, '99.99') | ' -.10' |
| to_char(-0.1, 'FM9.99') | '-.1' |
| to_char(0.1, '0.9') | ' 0.1' |
| to_char(12, '9990999.9') | ' 0012.0' |
| to_char(12, 'FM9990999.9') | '0012.' |
| to_char(485, '999') | ' 485' |
| to_char(-485, '999') | '-485' |
| to_char(485, '9 9 9') | ' 4 8 5' |
| to_char(1485, '9,999') | ' 1,485' |
| to_char(1485, '9G999') | ' 1 485' |
| to_char(148.5, '999.999') | ' 148.500' |
| to_char(148.5, 'FM999.999') | '148.5' |
| to_char(148.5, 'FM999.990') | '148.500' |
| to_char(148.5, '999D999') | ' 148,500' |
| to_char(3148.5, '9G999D999') | ' 3 148,500' |
| to_char(-485, '999S') | '485-' |
| to_char(-485, '999MI') | '485-' |
| to_char(485, '999MI') | '485 ' |
| to_char(485, 'FM999MI') | '485' |
| to_char(485, 'PL999') | '+485' |
| to_char(485, 'SG999') | '+485' |
| to_char(-485, 'SG999') | '-485' |
| to_char(-485, '9SG99') | '4-85' |
| to_char(-485, '999PR') | '<485>' |
| to_char(485, 'L999') | 'DM 485 |
| to_char(485, 'RN') | ' CDLXXXV' |
| to_char(485, 'FMRN') | 'CDLXXXV' |
| to_char(5.2, 'FMRN') | 'V' |
| to_char(482, '999th') | ' 482nd' |
| to_char(485, '"Good number:"999') | 'Good number: 485' |
| to_char(485.8, '"Pre:"999" Post:" .999') | 'Pre: 485 Post: .800' |
| to_char(12, '99V999') | ' 12000' |
| to_char(12.4, '99V999') | ' 12400' |
| to_char(12.45, '99V9') | ' 125' |