날짜 및 날짜-시간 질문에 대한 보고서 식의 예시가 아래에 나와 있습니다.
비고:
이러한 식은 문자열로 저장된 시간 문제에는 적용되지 않습니다.
날짜 및 날짜-시간 질문이 해당 지역의 서식에 맞는 방식으로 제시되도록 하려면 식을 사용하여 제공된 로캘과 일치하도록 질문의 서식을 지정할 수 있습니다. locale 메소드를 식 맨 앞에 배치하고 로캘 코드는 소문자여야 합니다.
${datetime | locale:"pt-br"}
비고:
특정 언어의 로캘 코드에 대한 자세한 내용은 Wikipedia의 ISO 639-1 코드 목록을 참고하세요. 다만 이러한 언어가 모두 Survey123에서 지원되는 것은 아닙니다.
피처 레이어의 모든 날짜 및 날짜-시간 값은 협정 세계시(UTC)로 저장됩니다. 기본 설정에 따라 보고서에서 반환된 모든 날짜 및 날짜-시간 값의 표준 시간대는 보고서 생성을 요청하는 데 사용한 웹 브라우저의 표준 시간대와 동일합니다. utcOffset 메소드를 사용하여 보고서 내의 이러한 값 표시를 특정 표준 시간대와 일치하도록 변경할 수 있습니다. 다음 식은 날짜-시간 질문 오프셋에 대한 응답을 UTC +1시간으로 표시합니다.
${datetime | utcOffset:"+01:00"}
utcOffset 메소드에는 +01:00, +0100, +01 형식이 지원되며 모두 동일한 결과가 반환됩니다. 이 메소드를 사용하여 응답 제출 시간에 대한 표시를 변경할 수도 있습니다.
날짜 및 날짜-시간 질문의 경우 식을 사용하여 날짜 형식을 지정할 수 있습니다. 일, 월, 년에 각각 DD, MM, YYYY 플레이스 홀더를 사용합니다. 다음 식은 연도를 제외하고 일과 월만 표시합니다.
${date | format:"DD/MM"}
또한 날짜-시간 질문에서 시간 형식을 지정할 수 있습니다. 시, 분, 초에 각각 HH, mm, ss 플레이스 홀더를 사용합니다. 다음 식은 일, 월, 시, 분을 표시합니다.
${datetime | format:"DD/MM HH:mm"}
다음 예시와 같이 format 메소드 값을 비워 두어 YYYY-MM-DDTHH:mm:ss±HH:mm의 ISO 8601 형식으로 날짜 및 시간을 표시할 수 있습니다.
${datetime | format:""}
날짜 및 시간 형식에 대한 자세한 내용은 아래 테이블을 참고하세요.
비고:
format 메소드는 식의 끝 부분에 배치해야 합니다.
$date 키워드를 사용하여 보고서가 생성된 날짜 및 시간을 인쇄할 수 있습니다. format 메소드를 사용하여 날짜, 시간 또는 둘 다 인쇄할지 여부를 제어합니다. 다음 예시는 보고서가 생성된 날짜(시간 제외)를 해당 로캘의 기본 날짜 형식으로 인쇄합니다.
${$date}
다음 식은 보고서가 생성된 날짜 및 시간에 대한 월, 일, 연도, 시, 분을 인쇄합니다.
${$date | format:"MM/DD/YYYY HH:mm"}
다음 식은 보고서가 생성된 시간(날짜 제외)을 12시간제의 시, 분, 초 단위로 인쇄합니다.
${$date | format:"h:mm:ss A"}
$date 키워드는 utcOffset 및 locale 메소드도 지원합니다. locale 메소드는 format 및 locale 모두 지정되면 무시됩니다.
날짜 및 시간 형식
다음 테이블에는 보고서의 날짜 및 날짜-시간 질문에서 날짜 및 시간 형식을 지정하는 format 메소드와 함께 사용할 수 있는 가장 일반적인 플레이스 홀더가 나와 있습니다.
| 플레이스 홀더 | 설명 |
|---|---|
YY | 연도의 마지막 2자리입니다. 예시: 2023년은 23으로 표시됩니다. |
YYYY | 연도 4자리입니다. 예시: 2023년은 2023으로 표시됩니다. |
M | 1~12 사이의 월 번호입니다. 예시: 1월은 1로 표시됩니다. |
MM | 2자리로 표현된 월 번호입니다. 예시: 1월은 01로 표시됩니다. |
MMM | 3개 문자로 표현된 월입니다. 예시: 1월은 Jan으로 표시됩니다. |
MMMM | 풀어 쓴 월입니다. 예시: 1월은 January로 표시됩니다. |
D | 1~31 사이의 날짜 번호입니다. 예시: 월의 첫날은 1로 표시됩니다. |
DD | 2자리로 표현된 날짜 번호입니다. 예시: 월의 첫날은 01로 표시됩니다. |
Do | 서수 접미어가 포함된 날짜 번호입니다. 예시: 월의 첫날은 1st로 표시됩니다. |
H | 24시간 기준의 시간 번호입니다. 예시: 오후 11시는 23으로 표시됩니다. |
HH | 2자리로 표현된 24시간 기준의 시간 번호입니다. 예시: 오전 2시는 02로 표시됩니다. |
시간 | 12시간 기준의 시간 번호입니다. 예시: 오후 11시는 11로 표시됩니다. |
hh | 2자리로 표현된 12시간 기준의 시간 번호입니다. 예시: 오전 2시는 02로 표시됩니다. |
m | 0~59 사이의 분 번호입니다. 예시: 8분은 8로 표시됩니다. |
mm | 2자리로 표현된 분 번호입니다. 예시: 8분은 08로 표시됩니다. |
ss | 2자리로 표현된 시간(초)입니다. 예시: 9초는 09로 표시됩니다. |
Z | 구분자를 사용하여 시간으로 표현된 표준 시간대 오프셋입니다. 예시: -07:00, +13:00 |
ZZ | 구분자를 사용하지 않고 시간으로 표현된 표준 시간대 오프셋입니다. 예시: -0700, +1300 |
x | UNIX 밀리초 타임스탬프입니다. 예시: 2023년 5월 4일 오후 9시(GMT)는 1683234000000으로 표시됩니다. |
X | UNIX 타임스탬프입니다. 예시: 2023년 5월 4일 오후 9시(GMT)는 1683234000으로 표시됩니다. |
a | 소문자로 된 오전 또는 오후 표기법입니다. 예시: a.m.은 am으로, p.m.은 pm으로 표시됩니다. |
A | 대문자로 된 오전 또는 오후 표기법입니다. 예시: a.m.은 AM으로, p.m.은 PM으로 표시됩니다. |