릴리스 정보

42.8 GRAPHIC 유형 및 DATE/TIME/TIMESTAMP 호환성

다음 절에서, "character string"을 가진 날짜 시간 값에 대한 언급은 "string" 표현으로 바뀌었습니다. DB2는 현재 유니코드 데이터베이스의 경우 날짜 시간 값의 "graphic string" 표현만을 지원합니다.

42.8.1 날짜 시간 값의 문자열 표현

데이터 유형이 DATE, TIME 또는 TIMESTAMP인 값은 사용자가 볼 수 있는 내부 형식으로 표시됩니다. 그러나, 날짜, 시간, 시간소인 값은 문자열로도 표현할 수 있습니다. 데이터 유형이 DATE, TIME 또는 TIMESTAMP인 상수나 변수가 없기 때문에 이 기능은 유용합니다. 검색을 위해서는 날짜 시간 값을 문자열 변수에 지정해야 합니다. CHAR 함수 또는 GRAPHIC 함수(유니코드 데이터베이스의 경우에 한해)를 사용하여 날짜 시간 값을 문자열 표현으로 바꿀 수 있습니다. 프로그램이 사전 컴파일되거나 데이터베이스에 바인드될 때 DATETIME 옵션을 지정하여 대체하지 않는 한 날짜 및 시간 형식의 문자열 표현은 응용프로그램의 국가/지역 코드와 연관된 날짜 시간 값의 기본 형식입니다.

길이에 상관 없이, 대형 오브젝트(LOB) 문자열, LONG VARCHAR 값 또는 LONG VARGRAPHIC 값을 사용하여 날짜 시간 값을 나타낼 수 없습니다(SQLSTATE 42884).

날짜 시간 값의 올바른 문자열 표현이 내부 날짜 시간 값을 가진 조작에 사용된 경우, 문자열 표현은 조작이 수행되기 전에 내부 날짜, 시간, 시간소인 형태로 변환됩니다.

날짜 및 시간소인 문자열은 문자 및 숫자로만 구성되어야 합니다.

42.8.1.1 날짜 문자열, 시간 문자열, 날짜 시간 문자열

이러한 용어 정의는 약간 변경되었습니다. "character string" 표현에 대한 언급은 "string" 표현으로 바뀌었습니다.

42.8.2 데이터 유형 변환

이제 DATE, TIME, TIMESTAMP를 GRAPHIC 및 VARGRAPHIC으로 유형 변환할 수 있습니다. GRAPHIC 및 VARGRAPHIC도 DATE, TIME, TIMESTAMP로 유형 변환할 수 있습니다. 그래픽 문자열은 유니코드 데이터베이스에만 지원됩니다.

42.8.3 할당 및 비교

그래픽 문자열, DATE, TIME, TIMESTAMP 값 사이의 할당 및 비교와 관련하여 새로운 데이터 유형 호환성이 있습니다. 그래픽 문자열은 유니코드 데이터베이스에만 지원됩니다.

42.8.4 날짜 시간 할당

날짜 시간 할당에 대한 기본 규칙은 DATE, TIME 또는 TIMESTAMP 값을 일치하는 데이터 유형(DATE, TIME 또는 TIMESTAMP)을 가진 컬럼 또는 고정 또는 가변 길이 문자열 변수 또는 문자열 컬럼에만 할당할 수 있다는 점입니다. 할당은 LONG VARCHAR, CLOB, LONG VARGRAPHIC, DBCLOB 또는 BLOB 변수나 컬럼에 대한 것이 아니어야 합니다.

날짜 시간 값이 문자열 변수나 문자열 컬럼에 지정되면, 문자열 표현으로 자동으로 변환이 이루어집니다. 날짜, 시간 또는 시간소인의 부분에서 앞의 0은 생략되지 않습니다. 문자열 표현 형식에 따라 필요한 대상 길이가 달라집니다. 대상의 길이가 필요한 길이보다 길다면, 대상은 고정 길이 문자열로서 오른쪽에 공백이 삽입됩니다. 대상의 길이가 필요한 길이보다 적다면, 관련 날짜 시간 값 유형 및 대상 유형에 따라 결과는 달라집니다.

대상이 호스트 변수인 경우, 다음 규칙이 적용됩니다.

DATE: 변수 길이가 10자 미만인 경우, 오류가 발생합니다.
TIME: USA 형식이 사용된 경우, 변수 길이는 8자 이상이어야 합니다. 다른 형식의 경우 길이는 5자 이상이어야 합니다.

ISO 또는 JIS 형식이 사용되었으며 호스트 변수 길이가 8자 미만인 경우, 결과에서 시간의 두 번째 부분이 생략되어 표시기 변수(제공된 경우)에 지정됩니다. SQLCA의 SQLWARN1 필드는 생략을 나타내도록 설정됩니다.
TIMESTAMP 호스트 변수가 19자 미만인 경우, 오류가 발생합니다. 길이가 26자 미만이지만 19자보다 긴 경우, 값을 마이크로초 부분의 뒷 자리수가 생략됩니다. SQLCA의 SQLWARN1 필드는 생략을 나타내도록 설정됩니다.

42.8.5 DATE

>>-DATE--(--표현식--)------------------------------------------><

스키마는 SYSIBM입니다.

DATE 함수는 값에서 날짜를 리턴합니다.

인수는 날짜, 시간소인 3 652 059 미만의 양수, 날짜 또는 시간소인의 올바른 문자열 표현, LONG VARCHAR, CLOB, LONG VARGRAPHIC, DBCLOB 또는 BLOB가 아닌 길이 7인 문자열이어야 합니다.

유니코드 데이터베이스만이 날짜 또는 시간소인의 그래픽 문자열 표현으로 된 인수를 지원합니다.

인수가 길이 7인 문자열인 경우, yyyynnn 형태로 올바른 날짜를 나타내야 합니다. 여기서, yyyy은 연도를 나타내는 숫자이고 nnn이고 001에서 366 사이의 숫자로서 해당 연도의 날짜를 나타냅니다.

함수의 결과는 날짜입니다. 인수가 널(NULL)일 수 있는 경우, 결과는 널(NULL)일 수 있습니다. 인수가 널(NULL)인 경우, 결과는 널(NULL) 값입니다.

다른 규칙은 인수 데이터 유형에 따라 달라집니다.

인수가 날짜, 시간소인 또는 날짜나 시간소인의 올바른 문자열 표현인 경우,
- 결과는 값의 날짜 부분입니다.
인수가 숫자인 경우,
- 결과는 0001년 1월 1일 이후 n-1일인 날짜로서, n은 숫자의 정수 부분입니다.
인수가 길이 7인 문자열인 경우,
- 결과는 문자열로 표현된 날짜입니다.

예:

RECEIVED(timestamp) 컬럼의 내부 값이 '1988-12-25-17.12.30.000000'인 경우,

이 예의 결과는 '1988-12-25'의 내부 표현이 됩니다.
```
   DATE(RECEIVED)
```
이 예의 결과는 '1988-12-25'의 내부 표현이 됩니다.
```
   DATE('1988-12-25')
```
이 예의 결과는 '1988-12-25'의 내부 표현이 됩니다.
```
   DATE('25.12.1988')
```
이 예의 결과는 '0001-02-04'의 내부 표현이 됩니다.
```
   DATE(35)
```

42.8.6 GRAPHIC

>>-GRAPHIC--(--graphic-expression--+------------+--)-----------><
                                   '-,--integer-'

스키마는 SYSIBM입니다.

GRAPHIC 함수는 그래픽 문자열 유형의 GRAPHIC 표현 또는 날짜 시간 유형의 GRAPHIC 표현을 나타냅니다.

graphic-expression: 그래픽 문자열인 값을 리턴하는 표현식
integer: 결과로 표시되는 GRAPHIC 데이터 유형의 길이 속성을 지정하는 정수 값. 값은 1 - 127이어야 합니다. integer가 지정되지 않은 경우, 결과의 길이는 첫 번째 인수의 길이와 같습니다.

함수의 결과는 GRAPHIC입니다. 인수가 널(NULL)일 수 있는 경우, 결과는 널(NULL)일 수 있습니다. 인수가 널(NULL)인 경우, 결과는 널(NULL) 값입니다.

날짜 시간을 그래픽으로:

>>-GRAPHIC--(--datetime-expression--+--------------+--)--------><
                                    '-,--+-ISO---+-'
                                         +-USA---+
                                         +-EUR---+
                                         +-JIS---+
                                         '-LOCAL-'

날짜 시간을 그래픽으로:

datetime-expression

다음 세 가지 데이터 유형 중 하나인 표현식

date: 결과는 두 번째 인수가 지정하는 형식의 날짜 그래픽 문자열 표현입니다. 결과 길이는 10입니다. 두 번째 인수가 지정되었으며 올바른 값이 아닌 경우 오류가 발생합니다(SQLSTATE 42703).
time: 결과는 두 번째 인수가 지정하는 형식의 시간 그래픽 문자열 표현입니다. 결과 길이는 8입니다. 두 번째 인수가 지정되었으며 올바른 값이 아닌 경우 오류가 발생합니다(SQLSTATE 42703).
timestamp: 두 번째 인수를 적용할 수 없으며 지정할 수 없습니다(SQLSTATE 42815). 결과는 시간소인 그래픽 문자열 표현입니다. 결과 길이는 26입니다.

문자열 코드 페이지는 응용프로그램 서버(AS)에서의 데이터베이스 코드 페이지입니다.

42.8.7 TIME

>>-TIME--(--표현식--)------------------------------------------><

스키마는 SYSIBM입니다.

TIME 함수는 값에서 시간을 리턴합니다.

인수는 날짜, 시간소인, LONG VARCHAR, CLOB, LONG VARGRAPHIC, DBCLOB 또는 BLOB가 아닌 시간이나 시간소인의 올바른 문자열 표현이어야 합니다.

유니코드 데이터베이스만이 날짜 또는 시간소인의 그래픽 문자열 표현으로 된 인수를 지원합니다.

함수의 결과는 시간입니다. 인수가 널(NULL)일 수 있는 경우, 결과는 널(NULL)일 수 있습니다. 인수가 널(NULL)인 경우, 결과는 널(NULL) 값입니다.

다른 규칙은 인수 데이터 유형에 따라 달라집니다.

인수가 시간인 경우,
- 결과는 해당 시간입니다.
인수가 시간소인인 경우,
- 결과는 시간소인의 시간 부분입니다.
인수가 문자열인 경우,
- 결과는 문자열로 표현된 시간입니다.

예:

해당 날짜에 현재 시간보다 적어도 한 시간 후에 수신된 IN_TRAY 샘플 테이블에서 모든 참고를 선택하십시오.
```
   SELECT * FROM IN_TRAY
     WHERE TIME(RECEIVED) >= CURRENT TIME + 1 HOUR
```

42.8.8 TIMESTAMP

>>-TIMESTAMP--(--표현식--+-------------+--)--------------------><
                         '-,expression-'

스키마는 SYSIBM입니다.

TIMESTAMP 함수는 값이나 값 쌍으로부터 시간소인을 리턴합니다.

유니코드 데이터베이스만이 날짜, 시간 또는 시간소인의 그래픽 문자열 표현으로 된 인수를 지원합니다.

인수에 대한 규칙은 두 번째 인수가 지정되었는지 여부에 따라 다릅니다.

한 인수만 지정된 경우,
- 인수는 시간소인, 시간소인의 올바른 문자열 표현 또는 LONG VARCHAR, CLOB, LONG VARGRAPHIC, DBCLOB 또는 BLOB가 아닌 길이가 14인 문자열이어야 합니다.
  
  길이가 14인 문자열은 올바른 날짜 및 시간을 yyyyxxddhhmmss 형태로 나타내는 숫자 문자열이어야 합니다. 여기서, yyyy는 연도이고, xx는 월이고, dd는 일이고, hh는 시간이고, mm은 분이고, ss는 초입니다.
두 인수 모두 지정된 경우,
- 첫 번째 인수는 날짜 또는 날짜의 올바른 문자열 표현이어야 하며, 두 번째 인수는 시간 또는 시간의 올바른 문자열 표현이어야 합니다.

함수의 결과는 시간소인입니다. 인수가 널(NULL)일 수 있는 경우, 결과는 널(NULL)일 수 있습니다. 인수가 널(NULL)인 경우, 결과는 널(NULL) 값입니다.

다른 규칙은 두 번째 인수가 지정되었는지 여부에 따라 다릅니다.

두 인수 모두 지정된 경우,
- 결과는 첫 번째 인수로 지정된 날짜와 두 번째 인수로 지정된 시간으로 구성된 시간소인입니다. 시간소인의 마이크로초 부분은 0입니다.
한 인수만 지정되었으며 해당 인수가 시간소인인 경우,
- 결과는 해당 시간소인입니다.
한 인수만 지정되었으며 해당 인수가 문자열인 경우,
- 결과는 해당 문자열로 표현된 시간소인입니다. 인수가 길이 14인 문자열인 경우, 시간소인의 마이크로초 부분은 0입니다.

예:

START_DATE(date) 컬럼의 값은 1988-12-25와 같고, START_TIME(time) 컬럼의 값은 17.12.30인 경우,
```
   TIMESTAMP(START_DATE, START_TIME)
```
'1988-12-25-17.12.30.000000' 값을 리턴합니다.

42.8.9 VARGRAPHIC

문자열을 Vargraphic으로:

>>-VARGRAPHIC--(--character-string-expression--)---------------><

날짜 시간을 Vargraphic으로:

>>-VARGRAPHIC--(--datetime-expression--)-----------------------><

그래픽을 Vargraphic으로:

>>-VARGRAPHIC--(--graphic-string-expression--+------------+----->
                                             '-,--integer-'
 
>--)-----------------------------------------------------------><

스키마는 SYSIBM입니다.

VARGRAPHIC 함수는 다음에 대한 그래픽 문자열 표현을 리턴합니다.

1바이트 문자를 2바이트 문자로 변환하는 문자열 값
날짜 시간 값(유니코드 데이터베이스에서만 지원됨)
첫 번째 인수가 그래픽 문자열 유형인 경우 그래픽 문자열 값

함수의 결과는 가변 길이 그래픽 문자열(VARGRAPHIC 데이터 유형)입니다. 인수가 널(NULL)일 수 있는 경우, 결과는 널(NULL)일 수 있습니다. 인수가 널(NULL)인 경우, 결과는 널(NULL) 값입니다.

문자를 Vargraphic으로:

character-string-expression: 값이 LONG VARCHAR 또는 CLOB가 아닌 문자열 데이터 유형이어야 하며 최대 길이가 16 336바이트보다 길어야 하는 표현식.

결과의 길이 속성은 인수의 길이 속성과 같습니다.

S가 character-string-expression 값을 나타낼 경우, S의 각 1바이트 문자는 결과의 해당 2바이트 표현 또는 2바이트 대체 문자로 변환됩니다. S의 각 2바이트 문자는 '현상태대로' 맵핑됩니다. 2바이트 문자의 첫 번째 바이트가 S의 마지막 바이트로 표시되는 경우, 2바이트 대체 문자로 변환됩니다. S의 문자 순서는 보존됩니다.

다음은 변환에 대한 추가 고려사항입니다.

유니코드 데이터베이스의 경우, 이 함수는 문자열을 연산자 코드 페이지에서 UCS-2로 변환합니다. DBCS 문자를 포함한 모든 연산자 문자가 변환됩니다. 두 번째 인수가 제공되면, 결과 UCS-2 문자열의 원하는 길이(UCS-2 문자 수)를 지정합니다.
VARGRAPHIC 함수에 의해 2바이트 코드 포인트로 변환은 연산자 코드 페이지에 기초합니다.
연산자의 2바이트 문자는 변환되지 않습니다. 기타 모든 문자는 해당 2바이트 표현으로 변환됩니다. 해당 2바이트 표현이 없는 경우, 코드 페이지의 2바이트 대체 문자가 사용됩니다.
하나 이상의 2바이트 대체 문자가 결과에 리턴되지 않는 경우 경고 또는 오류 코드가 생성됩니다.

날짜 시간을 Vargraphic으로:

datetime-expression: 값이 DATE, TIME 또는 TIMESTAMP 데이터 유형이어야 하는 표현식.

그래픽을 Vargraphic으로:

graphic-string-expression: 그래픽 문자열인 값을 리턴하는 표현식.
integer: 결과 가변 길이 그래픽 문자열의 길이 속성. 값은 0 - 16 336이어야 합니다. 이 인수가 지정되지 않은 경우, 결과의 길이는 인수의 길이와 같습니다.

graphic-string-expression의 길이가 결과의 길이 속성보다 길 경우, 잘린 문자가 모두 공백이고 graphic-string-expression이 긴 문자열(LONG VARGRAPHIC 또는 DBCLOB)이 아닌 경우를 제외하고 데이터가 잘리면서 경고가 리턴됩니다(SQLSTATE 01004). 변경 끝

[ 페이지의 맨 위 | 이전 페이지 | 다음 페이지 | 목차 | 색인 ]