| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 9. 함수와 연산자 | Fast Forward | Next |
Table 9-26(은)는, 일자/시각형의 값의 처리로 사용 가능한 함수를 나타내고 있습니다. 자세한 것은, 이하의 부절로 설명합니다. Table 9-25(은)는, (+,*등의) 기본적인 산술 연산자의 행동을 설명하고 있습니다. 서식 설정 함수에 대해서는Section 9.8을 참조해 주세요. Section 8.5(을)를 참조해, 일자/시각 데이터형에 대한 배경이 되고 있는 정보에 정통하고 있어야 합니다.
후술의time혹은timestamp형의 입력을 받는 함수 및 연산자는 모두, 실제로는 2개의 종류가 있습니다. 1개는time with time zone형 또는timestamp with time zone형을 취해서, 이미 1개는time without time zone형 혹은timestamp without time zone형을 취하는 것입니다. 생략이기 때문에, 이러한 종류의 차이는 개별적으로 가리키고 있지 않습니다. 또한,+및*연산자는 교환 연산자를 가집니다(예를 들면 date + integer와 integer + date). 이러한 편성은 다른 한쪽만 가리킵니다.
Table 9-25. 일자/시각 연산자
| 연산자명 | 예 | 결과 |
|---|---|---|
| + | date '2001-09-28' + integer '7' | date '2001-10-05' |
| + | date '2001-09-28' + interval '1 hour' | timestamp '2001-09-28 01:00:00' |
| + | date '2001-09-28' + time '03:00' | timestamp '2001-09-28 03:00:00' |
| + | interval '1 day' + interval '1 hour' | interval '1 day 01:00:00' |
| + | timestamp '2001-09-28 01:00' + interval '23 hours' | timestamp '2001-09-29 00:00:00' |
| + | time '01:00' + interval '3 hours' | time '04:00:00' |
| - | - interval '23 hours' | interval '-23:00:00' |
| - | date '2001-10-01' - date '2001-09-28' | integer '3' |
| - | date '2001-10-01' - integer '7' | date '2001-09-24' |
| - | date '2001-09-28' - interval '1 hour' | timestamp '2001-09-27 23:00:00' |
| - | time '05:00' - time '03:00' | interval '02:00:00' |
| - | time '05:00' - interval '2 hours' | time '03:00:00' |
| - | timestamp '2001-09-28 23:00' - interval '23 hours' | timestamp '2001-09-28 00:00:00' |
| - | interval '1 day' - interval '1 hour' | interval '1 day -01:00:00' |
| - | timestamp '2001-09-29 03:00' - timestamp '2001-09-27 12:00' | interval '1 day 15:00:00' |
| * | 900 * interval '1 second' | interval '00:15:00' |
| * | 21 * interval '1 day' | interval '21 days' |
| * | double precision '3.5' * interval '1 hour' | interval '03:30:00' |
| / | interval '1 hour' / double precision '1.5' | interval '00:40:00' |
Table 9-26. 일자/시각 함수
| 함수명 | 반환값형 | 설명 | 예 | 결과 |
|---|---|---|---|---|
age(timestamp, timestamp)
|
interval | 인수간의 감산. 연도와 월을 사용한"심볼에 의한"결과를 생성 | age(timestamp '2001-04-10', timestamp '1957-06-13') | 43 years 9 mons 27 days |
age(timestamp)
|
interval |
current_date로부터 감산 |
age(timestamp '1957-06-13') | 43 years 8 mons 3 days |
clock_timestamp()
|
timestamp with time zone | 현재의 일자와 시각입니다. (문장 실행동안 변경됩니다. ) Section 9.9.4(을)를 참조. | ||
current_date
|
date | 현재의 일자. Section 9.9.4(을)를 참조 | ||
current_time
|
time with time zone | 현재의 시각. Section 9.9.4(을)를 참조. | ||
current_timestamp
|
timestamp with time zone | 현재의 일자와 시각(현재의 트랜잭션(transaction)의 개시 일자 시각). Section 9.9.4(을)를 참조. | ||
date_part(text, timestamp)
|
double precision | 서브필드의 취득(extract와 같다). Section 9.9.1(을)를 참조.
|
date_part('hour', timestamp '2001-02-16 20:38:40') | 20 |
date_part(text, interval)
|
double precision | 서브필드의 취득(extract와 같다). Section 9.9.1(을)를 참조.
|
date_part('month', interval '2 years 3 months') | 3 |
date_trunc(text, timestamp)
|
timestamp | 지정된 정밀도로 잘라서 버림. Section 9.9.2도 참조. | date_trunc('hour', timestamp '2001-02-16 20:38:40') | 2001-02-16 20:00:00 |
extract(field from
timestamp)
|
double precision | 서브필드의 취득. Section 9.9.1(을)를 참조. | extract(hour from timestamp '2001-02-16 20:38:40') | 20 |
extract(field from
interval)
|
double precision | 서브필드의 취득. Section 9.9.1(을)를 참조. | extract(month from interval '2 years 3 months') | 3 |
isfinite(timestamp)
|
boolean | 타임 스탬프의 유한(무한과 동일하지 않다) 성에 대한 검사 | isfinite(timestamp '2001-02-16 21:28:30') | true |
isfinite(interval)
|
boolean | 시간 간격이 유한한가의 검사 | isfinite(interval '4 hours') | true |
justify_days(interval)
|
interval | 30 일주기가 1월을 나타내도록 시간 간격을 조정 | justify_days(interval '30 days') | 1 month |
justify_hours(interval)
|
interval | 24시간을 1일로 할 시간 간격의 조정 | justify_hours(interval '24 hours') | 1 day |
justify_interval(interval)
|
interval |
justify_days및justify_hours를 사용하여, 추가적인 부호에 의한 조정을 실시한 시간 간격의 조정 |
justify_interval(interval '1 mon -1 hour') | 29 days 23:00:00 |
localtime
|
time | 현재의 시각. Section 9.9.4(을)를 참조. | ||
localtimestamp
|
timestamp | 현재의 일자와 시각(현재의 트랜잭션(transaction)의 개시). Section 9.9.4(을)를 참조. | ||
now()
|
timestamp with time zone | 현재의 일자와 시각(현재의 트랜잭션(transaction)의 개시). Section 9.9.4(을)를 참조. | ||
statement_timestamp()
|
timestamp with time zone | 현재의 일자와 시각(현재의 명령의 개시). Section 9.9.4(을)를 참조. | ||
timeofday()
|
text | 현재의 일자와 시각. (clock_timestamp와 유사합니만,text문자열로서 반환합니다. )
Section 9.9.4(을)를 참조.
|
||
transaction_timestamp()
|
timestamp with time zone | 현재의 일자와 시각(현재의 트랜잭션(transaction)의 개시). Section 9.9.4(을)를 참조. |
이러한 함수에 더하여OVERLAPS SQL 연산자가 지원되고 있습니다.
( start1 , end1 ) OVERLAPS ( start2 , end2 ) ( start1 , length1 ) OVERLAPS ( start2 , length2 )
이 식은, 2개의 시간 간격이 겹치는(그 종단으로 정의됩니다) 때에 true를 반환합니다. 겹치지 않는 경우는 false를 반환합니다. 종단은 일자, 시각, 타임 스탬프, 혹은, 일자/시각/타임 스탬프에 계속되는 시간 간격으로 지정됩니다.
SELECT (DATE '2001-02-16', DATE '2001-12-21') OVERLAPS
(DATE '2001-10-30', DATE '2002-10-30');
Result:
true
SELECT (DATE '2001-02-16', INTERVAL '100 days') OVERLAPS
(DATE '2001-10-30', DATE '2002-10-30');
Result:
false
timestamp with time zone의 값에interval의 값을 더할 때(또는timestamp with time zone의 값으로부터interval의 값을 공제할 때) 일의 부분은, 일의 수로 나타난 timestamp with time zone의 일자를 먼저 진행합니다(혹은 후에 되돌립니다). 서머타임에의 이행에 걸친 변경에 관해서는(세션의 시간대가 DST를 인식하게 되어 있으면),interval '1 day'가interval '24 hours'에 동일할 필요는 없습니다. 예를 들면, 세션의 시간대가 CST7CDT로 설정되어 있을 때에, timestamp with time zone '2005-04-02 12:00-07' + interval '1 day' 는,timestamp with time zone '2005-04-03 12:00-06'를 가져옵니다. 한편 같은 초기timestamp with time zone에interval '24 hours'를 더하면,timestamp with time zone '2005-04-03 13:00-06'라고 하는 결과가 됩니다. 그 이유는CST7CDT시간대에2005-04-03 02:00로 서머타임에의 변경이 있기 때문입니다.
EXTRACT, date_part
EXTRACT( field FROM source )
extract함수는, 일자/시각의 값으로부터 연도나 날짜/시간등의 서브필드를 추출합니다.
source
는timestamp형,time형, 또는interval형의 값의 식이어야 합니다
(date형의 식은timestamp형에 캐스트 되기 때문에, 똑같이 사용 가능합니다).
field
는 source의 값으로부터 어느 필드를 추출하는지를 선택하는 식별자 혹은 문자열입니다.
extract함수는double precision형의 값을 반환합니다. 이하에 유효한 필드명을 나타냅니다.
세기
SELECT EXTRACT(CENTURY FROM TIMESTAMP '2000-12-16 12:21:13'); Result: 20 SELECT EXTRACT(CENTURY FROM TIMESTAMP '2001-02-16 20:38:40'); Result: 21
당시의 사람들에게는 그러한 의식은 없었습니다만, 최초의 세기는0001-01-01 00:00:00 AD로부터 시작됩니다. 이 정의는 모든 그레고리 안 달력(일력)을 사용하는 나라에서 적용되고 있습니다. 0이라고 하는 값의 세기는 없습니다. -1의 다음은 1입니다. 이 정의에 납득할 수 없으면, 불평을 바티칸 로마성파울로대 성당의 로마황왕에게 전해 주세요.
PostgreSQL릴리스 8.0 이전으로는, 세기의 번호부의 관습에 따르고 있지 않았습니다. 단지 연도를 100으로 계산한 것을 돌려주고 있었습니다.
(월내의) 일자 필드(1~31)
SELECT EXTRACT(DAY FROM TIMESTAMP '2001-02-16 20:38:40'); Result: 16
연도 필드를 10으로 나눈 것
SELECT EXTRACT(DECADE FROM TIMESTAMP '2001-02-16 20:38:40'); Result: 200
한 주의 요일(0-6, 일요일은 0) (timestamp값에서만 사용)
SELECT EXTRACT(DOW FROM TIMESTAMP '2001-02-16 20:38:40'); Result: 5
extract함수의 요일 번호지정은, to_char함수의 요일 번호지정과 다릅니다.
연내에서의 통산 날짜(1~365/366)(timestamp값에서만 사용)
SELECT EXTRACT(DOY FROM TIMESTAMP '2001-02-16 20:38:40'); Result: 47
date형과timestamp형의 값에 대해,1970-01-01 00:00:00로부터의 초수(음수의 경우도 있어). interval형의 값으로는 그 시간 간격에 있어서의 초의 합계.
SELECT EXTRACT(EPOCH FROM TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40-08'); Result: 982384720 SELECT EXTRACT(EPOCH FROM INTERVAL '5 days 3 hours'); Result: 442800
이하에, 이 경과초수를 타임 스탬프값으로 변환하는 방법을 나타냅니다.
SELECT TIMESTAMP WITH TIME ZONE 'epoch' + 982384720 * INTERVAL '1 second';
시간의 필드(0~23)
SELECT EXTRACT(HOUR FROM TIMESTAMP '2001-02-16 20:38:40'); Result: 20
소수 부분도 포함하여, 1,000,000을 곱한 초필드. 모든 초를 포함하는 것에 주의.
SELECT EXTRACT(MICROSECONDS FROM TIME '17:12:28. 5'); Result: 28500000
밀레니엄(1 천년 기간)
SELECT EXTRACT(MILLENNIUM FROM TIMESTAMP '2001-02-16 20:38:40'); Result: 3
1900년대의 해는 제2 밀레니엄입니다. 제3 밀레니엄은 2001년 1월 1일부터 시작됩니다.
PostgreSQL릴리스 8.0 이전으로는, 밀레니엄의 번호부의 관습에 따르고 있지 않았습니다. 단지 연도 필드를 1000으로 나눈 값을 반환하였습니다.
소수 부분도 포함해, 1000을 곱할 수 있었던 초필드. 모든 초를 포함하는 것에 주의해 주세요.
SELECT EXTRACT(MILLISECONDS FROM TIME '17:12:28.5'); Result: 28500
분 필드(0~59)
SELECT EXTRACT(MINUTE FROM TIMESTAMP '2001-02-16 20:38:40'); Result: 38
timestamp형의 값에 대해서는 연중의 월번호(1~12). interval형의 값에 대해서는 월번호로, 12의 나머지(0~11).
SELECT EXTRACT(MONTH FROM TIMESTAMP '2001-02-16 20:38:40'); Result: 2 SELECT EXTRACT(MONTH FROM INTERVAL '2 years 3 months'); Result: 3 SELECT EXTRACT(MONTH FROM INTERVAL '2 years 13 months'); Result: 1
그 날이 포함되는 연도의 4분기(1~4). (timestamp값에서만 적용)
SELECT EXTRACT(QUARTER FROM TIMESTAMP '2001-02-16 20:38:40'); Result: 1
소수를 포함한 초필드(0~59, [1] ).
SELECT EXTRACT(SECOND FROM TIMESTAMP '2001-02-16 20:38:40'); Result: 40 SELECT EXTRACT(SECOND FROM TIME '17:12:28. 5'); Result: 28.5
초단위의 UTC로부터의 시간대 오프셋(offset). 양의 값은 UTC보다 동쪽의 시간대에 대응해, 음의 값은 UTC보다 서쪽의 시간대에 대응.
시간대 오프셋(offset)시간의 성분.
시간대 오프셋(offset)의 분의 성분.
그 날의 연간 통산에서의 주를 계산합니다. (ISO 8601의) 정의에서는, 그 해의 1월 4일의 주를 제1주로 합니다 (ISO 8601에서는, 주는 월요일부터 시작됩니다). 즉, 그 연도의 최초의 목요일이 있는 주가 그 연도의 제1주가 된다.
이것에 의해, 1월의 초순은 전년의 제52주 혹은 제53주가 되는 일이 있습니다. 예를 들면,2005-01-01은 2004년의 제53주이며,2006-01-01는 2005년의 제52주의 일부입니다.
SELECT EXTRACT(WEEK FROM TIMESTAMP '2001-02-16 20:38:40'); Result: 7
연도 필드. 0 AD가 존재하지 않다는 것을 기억하세요. 이 때문에AD의 연도부터BC의 연도를 감소 할 때에는 주의가 필요합니다.
SELECT EXTRACT(YEAR FROM TIMESTAMP '2001-02-16 20:38:40'); Result: 2001
extract함수는 원래 연산 처리의 목적이었습니다.
일자/시각의 값을 표시하는 목적에서의 서식에 대해서는Section 9.8을 참조해 주세요.
date_part함수는 전통적인Ingres상에서 설계된 것으로, 표준SQL의extract함수와 등가입니다.
date_part('
field
',
source
)
여기서
field
매개변수는 이름은 아니라, 문자열값일 필요가 있는 것에 주의해 주세요.
date_part로 유효한 필드명은extract와 같습니다.
SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40');
Result:
16
SELECT date_part('hour', INTERVAL '4 hours 3 minutes');
Result:
4
date_trunc
date_trunc함수는 개념적으로 수치에 대한trunc함수 와 유사합니다.
date_trunc('
field
',
source
)
source 는, 데이터형timestamp혹은interval의 표현값식입니다 (데이터형date와time는 각각 자동적으로timestamp혹은interval에 캐스트 됩니다). field 는, 입력값을 어느 정밀도로 잘라 버리는지를 선택합니다. 반환값은, 선택된 것 이하를 0으로 설정(일과 월의 경우는 1으로 설정)한, 모든 필드를 가지는timestamp혹은interval형입니다.
field 의 유효값에는 다음의 것이 있습니다.
| microseconds |
| milliseconds |
| second |
| minute |
| hour |
| day |
| week |
| month |
| quarter |
| year |
| decade |
| century |
| millennium |
예：
SELECT date_trunc('hour', TIMESTAMP '2001-02-16 20:38:40');
Result:
2001-02-16 20:00:00
SELECT date_trunc('year', TIMESTAMP '2001-02-16 20:38:40');
Result:
2001-01-01 00:00:00
AT TIME ZONE구문을 사용하는 것으로써, 타임 스탬프를 다른 시간대로 변환할 수가 있습니다.
Table 9-27에서 그 종류를 볼 수 있습니다.
Table 9-27. AT TIME ZONE Variants
| 식 | 반환값 | 설명 |
|---|---|---|
| timestamp without time zone AT TIME ZONE zone | timestamp with time zone | 주어진 타임 스탬프 without time zone 가 지정된 시간대에 있다고 취급합니다. |
| timestamp with time zone AT TIME ZONE zone | 주어진 타임 스탬프 with time zone 를 신규의 시간대로 변환합니다. | |
| time with time zone AT TIME ZONE zone | time with time zone | 주어졌을 때 각 with time zone 를 신규 시간대로 변환합니다. |
이러한 식에서는, 설정하는 시간대 zone 는, ('PST'와 같은) 텍스트 문자열, 또는(INTERVAL '-08:00'와 같은) 시간 간격으로 지정할 수가 있습니다. 텍스트의 경우,Section 8.5.3에 나타낸 방법으로 시간대 명칭을 지정할 수가 있습니다.
이하에 예를 나타냅니다(로컬인 시간대를PST8PDT로 설정하고 있습니다).
SELECT TIMESTAMP '2001-02-16 20:38:40' AT TIME ZONE 'MST'; Result: 2001-02-16 19:38:40-08 SELECT TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40-05' AT TIME ZONE 'MST'; Result: 2001-02-16 18:38:40
최초의 예는, 시간대가 없는 타임 스탬프를 사용해, 그것을 MST 시간(UTC-7)으로서 해석해, UTC 타임 스탬프를 생성합니다. 그리고, UTC 타임 스탬프가, 표시용으로 PST(UTC-7)로 변환됩니다. 2번째의 예는, EST(UTC-5)로 지정된 타임 스탬프를 사용해, MST(UTC-7)에서의 로컬 시간으로 변환하고 있습니다.
함수timezone(
zone
,
timestamp
)는, SQL 준거의 구문
timestamp
AT TIME ZONE
zone
와 동일합니다.
PostgreSQL는, 현재의 일자 및 시각에 관계된 값을 반환하는 많은 함수를 제공합니다. 이러한 표준 SQL 함수는 모두, 현재의 트랜잭션(transaction)의 개시시각에 근거한 값을 반환합니다.
CURRENT_DATE CURRENT_TIME CURRENT_TIMESTAMP CURRENT_TIME( precision ) CURRENT_TIMESTAMP( precision ) LOCALTIME LOCALTIMESTAMP LOCALTIME( precision ) LOCALTIMESTAMP( precision )
CURRENT_TIME및CURRENT_TIMESTAMP함수에서는, 시간대를 수반하는 값을 취급합니다.
한편,LOCALTIME및LOCALTIMESTAMP함수에서는, 시간대를 수반하지 않는 값을 취급합니다.
CURRENT_TIME,CURRENT_TIMESTAMP,LOCALTIME, 및LOCALTIMESTAMP함수에서는, 정밀도의 파라미터를 옵션으로 줄 수가 있어 , 초필드의 많은 소수부분의 결과를 가져옵니다.
정밀도의 파라미터가 없는 경우, 결과는 사용 가능한 최대 정밀도로 출력됩니다.
예：
Some examples:
SELECT CURRENT_TIME; Result: 14:39:53.662522-05 SELECT CURRENT_DATE; Result: 2001-12-23 SELECT CURRENT_TIMESTAMP; Result: 2001-12-23 14:39:53.662522-05 SELECT CURRENT_TIMESTAMP(2); Result: 2001-12-23 14:39:53.66-05 SELECT LOCALTIMESTAMP; Result: 2001-12-23 14:39:53.662522
이러한 함수는, 현재의 트랜잭션(transaction)의 개시시각을 반환합니다. 이 값은, 트랜잭션(transaction)이 실행되고 있는 동안은 변화하지 않습니다. 이것은, 다음의 기능을 검토한 결과입니다. 단일 트랜잭션(transaction)로,"current"시간을 일관성을 가진 표현을 실시할 수가 있도록 하는 것을 목적으로 하여, 이 때문에, 동일 트랜잭션(transaction)으로 몇 회 변경을 실시해도 동일한 타임 스탬프를 생성합니다.
Note: 다른 데이터베이스 시스템에서는, 이러한 값을 보다 빈번하게 증가시키는 일이 있습니다.
PostgreSQL는 또, 함수를 호출했을 때의 실제의 현재 시각이나 현재의 문장의 개시시각을 반환하는 함수도 제공합니다. 비표준 SQL의 함수의 전일람을 이하에 나타냅니다.
now() transaction_timestamp() statement_timestamp() clock_timestamp() timeofday()
now()는CURRENT_TIMESTAMP와 같은 것으로, 전통적인PostgreSQL함수입니다.
transaction_timestamp()는CURRENT_TIMESTAMP와 같은 것입니다만, 명확하게 무엇이 반환되는지를 나타내는지 지명되어 있습니다.
statement_timestamp()는 현재의 문장의 실행 개시시각을 반환하는 것입니다(보다 구체적으로 말하면, 직전의 커멘드 메세지를 클라이언트로부터 받았을 때의 시각입니다).
statement_timestamp()및transaction_timestamp()는 트랜잭션(transaction)의 최초의 커멘드에서는 같은 값을 반환합니다만, 그 후에 계속하는 커멘드에서는 다를 가능성이 있습니다.
clock_timestamp()는 실제의 현재 시각을 돌려주기 때문에, 그 값은 단일의 SQL 커멘드와도 다릅니다.
timeofday()는PostgreSQL의 역사적인 함수입니다.
clock_timestamp()같이, 실제의 현재 시각을 반환합니다만,timestamp with time zone형의 값은 아니고, 정형된text문자열을 반환합니다.
모든 일자/시각형은 또, 현재의 일자와 시각(반복합니다만, 트랜잭션(transaction)의 개시시각으로서 해석됩니다)을 나타내는 특수한 리터럴값 now를 받아들입니다. 따라서, 아래와 같은 3개의 실행 결과는 모두 같은 값을 반환합니다.
SELECT CURRENT_TIMESTAMP; SELECT now(); SELECT TIMESTAMP 'now'; -- incorrect for use with DEFAULT
Tip: 테이블을 작성할 때,DEFAULT구를 지정하는데 3번째의 형식을 사용하려고는 생각하지 않을 것입니다. 정수가 해석되었을 때, 시스템이now를timestamp로 변환하므로, 디폴트값으로서 테이블이 작성되었을 때의 시각이 사용됩니다. 최초의 2개의 형식은 함수 호출을 위해 디폴트값이 사용될 때까지 평가되지 않습니다. 그러므로, 이러한 함수는 열의 삽입 시간을 디폴트로 하는 동작을 실행합니다.
이하의 함수는, 서버 프로세스의 실행을 지연 시키기 위해서사용 가능합니다.
pg_sleep( seconds )
pg_sleep는,
seconds
초가 경과할 때까지, 현재의 세션의 프로세스를 정지시킵니다.
seconds
는double precision형의 값입니다.
그 때문에, 소수 단위로 지연초수를 지정할 수 있습니다. 이하에 예를 나타냅니다.
SELECT pg_sleep(1.5);
Note: 정지 시간의 효과적인 해결책은 특정한 플랫폼에 있습니다. 0.01초가 일반적인 값입니다. 지연은 적어도 지정한 대로 행해집니다. 서버의 부하가 요인이 되어, 보다 길어질 가능성이 있습니다.
| Warning |
|
|
| [1] |
작동 시스템으로 윤초가 실행되고 있는 경우는 60까지포함. |