formatTime()
strLib.formatTime() 시스템 함수는 TIME 값을 입력으로 승인하고 STRING 값을 리턴합니다.
EGL은 변환에 다음 형식을 순서대로 시도합니다. 특정
형식이 널이거나, 비어 있거나, 올바르지 않은 경우 EGL이 다음으로
이동합니다.
- 매개변수로 제공되는 형식 문자열
- strLib.defaultTimeFormat
- Java™ 로케일 오브젝트의 시간 형식(Java 전용)
이러한 모든 시도에 실패하는 경우 리턴값은 널입니다.
구문
strLib.formatTime(
aTime TIME? in
[, timeFormat STRING? in] )
returns (result STRING?)
- aTime
- 형식화할 값입니다. 입력은 dateTimeLib.currentTime() 시스템 함수의 리턴값과 같이 TIME 값과 지정 호환 가능한 표현식입니다.
- timeFormat
- 날짜/시간 마스크 및 형식 지정자에 설명된 대로 시간 형식을 식별합니다. 리터럴, 문자열 변수 또는 EGL 라이브러리 strLib에 설명되어 있는 모든 시간 형식 상수를 사용할 수 있습니다.
- result
- STRING 값입니다. aTime이 널이거나 EGL이 올바른 형식을 찾을 수 없는 경우 함수가 널값을 리턴합니다.
예제
다음 예제에서는 미국 서부 해안 지역의 여름 오후 12시 32분이라고 가정합니다.
myFormat STRING = "hh 'o''clock' a, zzzz";
result STRING;
result = strLib.formatTime(dateTimeLib.currentTime(),myFormat);
// result is "12 o'clock PM, Pacific Daylight Time"