formatTimestamp()
strLib.formatTimestamp() 시스템 함수는 TIMESTAMP 값을 입력으로 승인하고 STRING 값을 리턴합니다.
EGL은 변환에 다음 형식을 순서대로 시도합니다. 특정
형식이 널이거나, 비어 있거나, 올바르지 않은 경우 EGL이 다음으로
이동합니다.
- 매개변수로 제공되는 형식 문자열
- strLib.defaultTimestampFormat
- TIMESTAMP 변수를 정의하는 데 사용한 마스크
해당 정의 마스크를 기반으로 TIMESTAMP를 변환하는 경우 EGL이 다음
문자를 삽입합니다.
- 날짜 컴포넌트 사이의 구분 기호인 대시
- 날짜와 시간 사이의 공백
- 시간 컴포넌트 사이의 콜론
- 초와 초 수의 소수 간 소수점(로케일에 따른 문자가 아닌 마침표)
자세한 정보는 이 주제의 두 번째 예제를 참조하십시오.
구문
strLib.formatTimestamp(
aTimeStamp TIMESTAMP(yyyyMMddHHmmssSSSSSS)? in
[, timestampFormat STRING? in
])
returns (result STRING?)
- aTimeStamp
- 형식화할 TIMESTAMP 값입니다. 입력은 dateTimeLib.currentTimestamp() 시스템 함수가 리턴한 값처럼 TIMESTAMP 값과 지정 호환 가능한 표현식입니다.
- timestampFormat
- 날짜/시간 마스크 및 형식 지정자에 설명된 대로 시간소인 형식을 식별합니다. 리터럴, 문자열 변수 또는 EGL 라이브러리 strLib에 설명되어 있는 모든 시간소인 형식 상수를 사용할 수 있습니다.
- result
- STRING 변수입니다. aTimeStamp가 올바르지 않은 경우에는 함수가 널값을 리턴합니다.
예제
다음 예에서는 복합 형식 패턴을 제공합니다.
myTs TIMESTAMP = "20060606123200";
myFormat STRING = "MMMMMMMMM dd, yyyy ' at ' hh:mm aa";
result STRING;
result = strLib.formatTimestamp(myTs,myFormat);
// result is "June 6, 2006 at 12:32 pm"
다음 예제에서는 EGL이 변수의 마스크를 사용하여 문자열을 작성합니다.
ts1 timestamp( "yyyyMMddHHmmssffffff" );
ts2 timestamp( "yyyyMMdd" );
ts3 timestamp( "MMddHHmmssff" );
tsString STRING;
defaultTimestampFormat = "";
// uses pattern yyyy-MM-dd HH:mm:ss.SSSSSS
tsString = formatTimestamp( ts1 );
// uses pattern yyyy-MM-dd
tsString = formatTimestamp( ts2 );
// uses pattern MM-dd HH:mm:ss.SS
tsString = formatTimestamp( ts3 );