formatTimestamp()

strLib.formatTimestamp() 시스템 함수는 TIMESTAMP 값을 입력으로 승인하고 STRING 값을 리턴합니다.

EGL은 변환에 다음 형식을 순서대로 시도합니다. 특정 형식이 널이거나, 비어 있거나, 올바르지 않은 경우 EGL이 다음으로 이동합니다.
  1. 매개변수로 제공되는 형식 문자열
  2. strLib.defaultTimestampFormat
  3. 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 );