ADD_SECONDS 스칼라 함수

ADD_SECONDS 함수는 첫 번째 인수에 지정된 초 및 소수 초 수를 더한 값을 나타내는 시간소인 값을 리턴합니다.

스키마는 SYSIBM입니다.

표현식: 시작 시간소인을 지정하는 표현식입니다. 표현식은 TIMESTAMP, CHAR 또는 VARCHAR 데이터 유형인 값을 리턴해야 합니다. 유니코드 데이터베이스에서 표현식은 GRAPHIC 또는 VARGRAPHIC 데이터 유형이 될 수도 있습니다. CHAR, VARCHAR, GRAPHIC 및 VARGRAPHIC은 내재된 캐스팅을 사용하여 지원됩니다. expression은 DATE인 값을 리턴하지 않아야 합니다(SQLSTATE 42815). 표현식이 CHAR, VARCHAR, GRAPHIC 또는 VARGRAPHIC 데이터 유형인 경우 TIMESTAMP 스칼라 함수에서 허용하는 유효한 문자열이어야 합니다.
숫자 표현식: expression에 지정된 시작 시간소인에 추가할 초 및 소수 초 수를 지정하는 표현식입니다. 표현식은 내장 숫자, CHAR 또는 VARCHAR 데이터 유형인 값을 리턴해야 합니다. 유니코드 데이터베이스에서 표현식은 GRAPHIC 또는 VARGRAPHIC 데이터 유형이 될 수도 있습니다. CHAR, VARCHAR, GRAPHIC 및 VARGRAPHIC은 내재된 캐스팅을 사용하여 지원됩니다. 표현식이 DECIMAL(27,12)이 아닌 경우 함수가 평가되기 전에 DECIMAL(27,12)로 캐스트됩니다. 음수 숫자 값을 사용하여 초 및 소수 초를 뺄 수 있습니다.

함수의 결과는 expression이 시간소인인 경우 expression과 동일한 정밀도를 사용하는 시간소인입니다. 그렇지 않은 경우 결과는 TIMESTAMP(12)입니다. 인수가 널(NULL)일 수 있는 경우, 결과는 널(NULL)일 수 있습니다. 인수가 널(NULL)인 경우, 결과는 널(NULL) 값입니다.

예:

현재 시간소인이 2007년 1월 31일 01:02:03.123456이라고 가정하십시오. 현재 시간소인에 1초를 더하여 호스트 변수 ADD_SECOND를 설정하십시오.
```
   SET :ADD_SECOND = ADD_SECONDS(CURRENT TIMESTAMP, 1)
```
호스트 변수 ADD_SECOND는 2007-01-31-01.02.04.123456을 나타내는 값으로 설정됩니다.
TIMESTAMP가 July 27, 1965 23:59:59.123456 값을 사용하는 호스트 변수라고 가정하십시오. 호스트 변수 ADD_SECOND를 해당 시간소인에 3.123초를 더한 값으로 설정하십시오.
```
   SET :ADD_SECOND = ADD_SECONDS(:TIMESTAMP,3.123)
```
호스트 변수 ADD_SECOND는 시간소인에 3.123초를 더한 값 1965-07-28-00.00.02.246456으로 설정됩니다.
ADD_SECONDS 함수와 날짜 및 시간 산술을 사용하면 동일한 결과를 얻을 수 있습니다. 다음 예가 이를 보여줍니다.
```
   SET :TIMESTAMPHV = TIMESTAMP '2008-2-28-23.58.59.123456' + 61.654321 SECONDS
```
```
   SET :TIMESTAMPHV = ADD_SECONDS(
      TIMESTAMP '2008-2-28-23.58.59.123456', 61.654321)
```
두 경우에 모두 호스트 변수 TIMESTAMPHV는 값 '2008-02-29-00.00.00.777777'로 설정됩니다.
이제 시간소인 '2008-2-29-23.59.59.123456'을 인수로 사용하여 동일한 예를 고려합니다.
```
   SET :TIMESTAMPHV = TIMESTAMP '2008-2-29-23.59.59.123456' + 61.654321 SECONDS
```
```
   SET :TIMESTAMPHV = ADD_SECONDS(
      TIMESTAMP '2008-2-29-23.59.59.123456', 61.654321)
```
두 경우에 모두 호스트 변수 TIMESTAMPHV는 값 '2008-03-01-00.01.00.777777'로 설정됩니다.
TIMESTAMP가 July 27, 1965 23:59:59.123456 값을 사용하는 호스트 변수라고 가정하십시오. 호스트 변수 ADD_SECOND를 해당 시간소인에서 3.123초를 뺀 값으로 설정하십시오.
```
   SET :ADD_SECOND = ADD_SECONDS(:TIMESTAMP,-3.123)
```
호스트 변수 ADD_SECOND가 1965-07-27-23.59.56.000456으로 설정됩니다. 1965년 7월 27일 23:59:59.123456에서 3.123초를 뺀 값입니다.