날짜 및 시간

XLSForm에는 날짜, 시간 또는 날짜 및 시간 질문을 포함할 수 있습니다. 해당 질문은 모양을 사용한 데이터 캡처를 지원하도록 스타일을 지정할 수 있습니다.

날짜, 시간 또는 날짜 및 시간 질문의 계산 열에서 format-date 함수를 사용하여 날짜 및 시간의 형식을 지정할 수 있습니다. 자세한 내용은 날짜 형식 지정을 참고하세요.

기본 설정에 따라 Survey123에서 날짜 및 시간 질문이 할당된 ArcGIS 필드 유형은 날짜만, 시간만 또는 타임스탬프 오프셋을 캡처하도록 변경할 수 있습니다. 자세히 알아보려면 Esri 사용자 설정 열을 참고하세요.

주의:

Survey123 Connect 3.19 11월 릴리즈 이전 버전은 날짜만, 시간만 또는 타임스탬프 오프셋 필드 유형을 할당할 수 없습니다. Survey123 Connect 3.19 2월 업데이트에서는 해당 데이터 유형을 ArcGIS Enterprise 11.2에 발행할 수 있지만 완전히 지원되지는 않으며, ArcGIS Enterprise 11.2 웹 레이어에서 사용할 경우 베타 기능으로 간주됩니다.

시작 및 종료 질문은 자동으로 현장조사의 시작 및 종료일과 시간을 취득하며 현장조사를 완료하는 데 걸린 시간을 계산하는 데 사용될 수 있습니다.

날짜 및 시간 형식

Survey123에서 사용할 수 있는 날짜 및 시간 형식에는 ISO 8601 형식, 에포크(Unix) 시간, 소수 시간의 세 가지가 있습니다.

다음 테이블에 이러한 형식이 요약되어 있습니다.

이름설명예시

ISO 8601 형식

협정 세계시(UTC) 오프셋을 포함할 수 있는 문자열입니다. 이 형식은 Survey123 현장 앱 및 웹 앱 모두에서 지원됩니다.

해당 형식은 사람이 읽을 수 있으므로 기본값 및 제약 조건에 유용합니다.

2015-08-31T09:07:01Z

2015-08-31T09:07:01Z-07:00

에포크(Unix) 시간

1970년 1월 1일 00:00:00 협정 세계시(UTC) 이후 경과된 시간(밀리초)을 나타내는 정수입니다. 이 형식은 Survey123 웹 앱에서 지원되지 않습니다.

에포크 시간은 ArcGIS apps에 표시될 때 사람이 읽을 수 있는 날짜 또는 시간으로 변환되지만 데이터가 ArcGIS OnlineArcGIS Enterprise에 저장되는 방식이며 피처 객체에서 반환되는 값입니다.

1441011600000

소수 시간

1970년 1월 1일 00:00:00 협정 세계시(UTC) 이후 경과된 시간(일)을 나타내는 소수입니다. 이 형식은 Survey123 현장 앱 및 웹 앱 모두에서 지원됩니다.

날짜 값을 더하거나 빼는 경우 소수 시간을 사용해야 합니다.

16678.375

팁:

현장조사가 현장 앱과 웹 앱에서 일관적으로 사용되도록 하려면 날짜 및 시간 계산에 ISO 8601 형식이나 소수 시간을 사용해야 합니다.

에포크 시간 및 소수 시간 계산

다음 테이블에는 사람이 읽기 편한 시간에 해당되는 에포크 및 소수 시간이 나와 있습니다.

사람이 읽기 편한 시간에포크 시간소수 시간

1초

1000

0.00001157407407(1/24/60/60)

1분

60,000(1000 * 60)

0.00069444444444(1/24/60)

1시간

3600000(1000 * 60 * 60)

0.04166666666667(1/24)

1일

86400000(1000 * 60 * 60 * 24)

1

1주

604800000(1000 * 60 * 60 * 24 * 7)

7

1개월

2630880000(1000 * 60 * 60 * 24 * 30.45)

30.45

1년

31557600000(1000 * 60 * 60 * 24 * 365.25)

365.25

에포크 기반 시간 계산을 사용하여 생성한 기존 현장조사가 있는 경우 이를 소수 시간으로 변환해야 Survey123 웹 앱에서 올바르게 작동합니다. 다음은 에포크 시간을 소수 시간으로 변환하는 식의 예시입니다.

목표에포크 시간 계산소수 시간 계산

15분 후

now() + 15 * 60 * 1000

date-time(decimal-date-time(now()) + 0.0104166675)

12주 후

now() + 14 * 24 * 60 * 60 * 1000

date(decimal-date-time(now()) + 14)

점심 시간(분)

int(${LunchEnd} - ${LunchStart}) div (1000 * 60)

int((decimal-date-time(${lunchends}) - decimal-date-time(${lunchstarts})) * 24 * 60)

생일로 나이 계산(년)

int((today() - ${birth_date}) div (1000 * 24 * 60 * 60 * 365.25))

int((decimal-date-time(today()) - decimal-date-time(${birth_date})) div 365.25)

현장조사에서 변경해야 할 계산 식을 파악한 후에는 다음과 같이 업데이트합니다.

  1. Survey123 Connect에서 소수 날짜 계산이 사용되도록 에포크 기반 시간 계산을 업데이트합니다. 계속하기 전에 XLSForm 백업을 저장하는 것을 권장합니다.
  2. 업데이트한 계산을 Survey123 Connect 미리 보기에서 테스트하여 제대로 계산되는지 확인합니다.
  3. 현장조사를 다시 발행합니다. 계산을 업데이트하는 경우 피처 레이어에 대한 재발행이 트리거되지 않으므로 기존 데이터가 손실되지 않습니다.
  4. 현장 사용자에게 Survey123 현장 앱에서 현장조사를 업데이트하도록 합니다.