날짜 및 시간 열의 동작 및 형식

Microsoft Dataverse에서는 날짜 및 시간 값이 사용자에게 표시되는 방식과 시간대에 맞게 조정되는 방식을 지정할 수 있습니다.

날짜 및 시간 열에는 두 가지 옵션을 사용할 수 있습니다.

• 동작: 표준 시간대 값을 조정할지 여부입니다.
• 형식: 값의 시간 부분을 표시할지 여부입니다.

동작

Dataverse는 모든 날짜 및 시간 값을 UTC 시간대로 저장합니다. 앱이 사용자가 입력한 값 또는 처리 값을 표시하면 Dataverse 및 모델 기반 앱은 이러한 동작 옵션을 사용하여 사용자의 시간대를 조정할 수 있습니다.

• 사용자 현지 시간: 사용자의 시간대에 대한 값을 조정합니다. 이 옵션은 기본 동작입니다. 이 동작을 다른 동작으로 변경할 수 있습니다.
• 표준 시간대 독립: 시간대 변환이 없습니다.
• 날짜만: 시간대 변환이 없습니다. 표준 시간대 독립과 달리 시간 부분은 저장되지 않습니다.

사용자의 시간대는 Windows, Android, iOS, macOS의 시스템 시간대가 아닌 개인 옵션에 설정되어 있습니다. . 그러나, 시스템 시간대는 JavaScript 날짜와 함께 작동하는 클라이언트 스크립트에 영향을 미칠 수 있습니다.

Format

동작이 날짜만인 경우를 제외하고 모든 날짜 및 시간 열에는 시간 부분이 있습니다. 형식:은 값의 시간 부분을 표시할지 여부를 결정합니다.

• 날짜 및 시간: 값의 날짜 및 시간을 표시합니다.
• 날짜만: 값의 날짜 부분만 표시합니다.

참고

형식이 날짜만인 경우에도 사용자는 시간 부분을 변경할 수 있습니다. 예를 들어 Web API 호출을 사용하거나 시간 부분이 있는 컨트롤을 사용합니다. 이는 시간 부분이 전혀 저장되지 않는 날짜만 동작과 다릅니다.

사용 지침

호텔 체크인 시간과 같이 시간대 정보가 필요하지 않은 경우 표준 시간대 독립 동작을 사용하세요. 이 선택을 사용하면 모든 시간대의 사용자에게 동일한 날짜 및 시간 값이 표시됩니다.

생일이나 기념일과 같이 하루 중 시간 및 시간대에 대한 정보가 필요하지 않은 경우 날짜만 동작을 사용하세요. 이 선택을 사용하면 모든 시간대의 사용자에게 정확히 동일한 날짜 값이 표시됩니다.

날짜만 형식의 표준 시간대 독립 동작은 날짜만 동작과 실질적으로 동일합니다. 나중에 시간 부분이 필요한지 확실하지 않은 경우 전자를 사용하십시오.

예

표시 값

Dataverse는 2023-10-15T07:30:00Z(또는 날짜만 동작의 경우 2023-10-15)를 저장합니다. UTC-8 시간대의 사용자는 모델 기반 앱에서 또는 형식 지정된 값에 대한 웹 API 요청을 통해 다음을 볼 수 있습니다.

동작	Format	표시 값
사용자 현지 시간	날짜 및 시간	2023년 10월 14일 오후 11시 30분
사용자 현지 시간	날짜만	2023년 10월 14일
표준 시간대 독립	날짜 및 시간	2023년 10월 15일 오전 7시 30분
표준 시간대 독립	날짜만	2023년 10월 15일
날짜만	-	2023년 10월 15일

앱에 값 입력

UTC-8 시간대의 사용자는 모델 기반 앱에 October 14th, 2023, 11:30 pm을 입력합니다. 값은 Dataverse에 다음과 같이 저장됩니다.

동작	Format	Dataverse에 저장한 값
사용자 현지 시간	날짜 및 시간	2023-10-15T07:30:00Z
사용자 현지 시간	날짜만	2023-10-15T07:30:00Z
표준 시간대 독립	날짜 및 시간	2023-10-14T23:30:00Z
표준 시간대 독립	날짜만	2023-10-14T23:30:00Z
날짜만	-	2023-10-14

사용자가 October 14th, 2023이라는 날짜만 입력하면 시간 부분은 오전 12시로 간주됩니다.

동작	Format	Dataverse에 저장한 값
사용자 현지 시간	날짜만	2023-10-14T08:00:00Z
표준 시간대 독립	날짜만	2023-10-14T00:00:00Z
날짜만	-	2023-10-14

앱에 유효한 값 입력

클라이언트마다 잘못된 입력을 처리하는 방법이 다릅니다. 예를 들어 태평양 시간대에서는 일광 절약 시간제가 2023년 3월 12일 오전 2시에 시작되어 시간이 1시간 앞당겨 오전 3시로 이동됩니다. 해당 날짜 오전 2시부터 오전 3시 사이의 시간은 존재하지 않습니다. 사용자가 해당 시간 범위의 값을 입력하려고 하면 앱은 다음 중 하나를 수행할 수 있습니다.

• 이전 또는 다음 유효한 시간으로 변경합니다.
• 마지막으로 알려진 값으로 되돌립니다.
• 오류 메시지를 표시합니다.
• 사용자가 처음에 시간을 선택할 수 없도록 시간 선택 도구에 오전 2시부터 오전 3시 사이의 시간을 표시하지 마세요.

마찬가지로 클라이언트마다 반복되는 시간 범위를 처리하는 방법이 다릅니다. 예를 들어 태평양 시간대에서는 일광 절약 시간제가 2023년 11월 5일 오전 2시에 종료되어 시간이 한 시간 뒤로 이동하여 오전 1시로 이동합니다. 해당 날짜 오전 1시부터 오전 2시 사이의 시간이 두 번 반복됩니다. 오전 1시 30분과 같은 시간은 두 시간대 중 하나를 나타낼 수 있습니다. 해당 범위의 시간을 명확하게 표시하거나 입력해야 하는 경우 일광 절약 시간제를 사용하지 않는 시간대로 일시적으로 전환하는 것이 가장 좋습니다.

웹 API를 통해 원시 값 얻기

Dataverse는 2023-10-15T07:30:00Z(또는 날짜만 동작의 경우 2023-10-15)를 저장합니다. 모든 시간대의 사용자는 값에 대한 웹 API 요청을 통해 이러한 정보를 얻습니다.

동작	Format	원시 값
사용자 현지 시간	날짜 및 시간	2023-10-15T07:30:00Z
사용자 현지 시간	날짜만	2023-10-15T07:30:00Z
표준 시간대 독립	날짜 및 시간	2023-10-15T07:30:00Z
표준 시간대 독립	날짜만	2023-10-15T07:30:00Z
날짜만	-	2023-10-15

클라이언트 API를 통해 값 얻기

UTC-8 시간대의 사용자는 모델 기반 앱에 October 14th, 2023, 11:30 pm을 입력합니다. formContext.getAttribute(<column name>).getValue()와 같은 클라이언트 API 함수는 시간대 조정이 적용된 값을 반환합니다.

동작	Format	JavaScript dateValue.toUTCString()
사용자 현지 시간	날짜 및 시간	2023-10-15 07:30(UTC)
사용자 현지 시간	날짜만	2023-10-15 07:30(UTC)

표준 시간대 독립 동작의 경우 JavaScript 날짜 값은 브라우저의 시간대를 따릅니다.

동작	Format	JavaScript dateValue.toString()
표준 시간대 독립	날짜 및 시간	2023-10-14 23:30(브라우저 시간대)
표준 시간대 독립	날짜만	2023-10-14 23:30(브라우저 시간대)

JavaScript 날짜 값에는 항상 시간 구성 요소가 있습니다. 그렇기 때문에 날짜만 동작의 시간 구성 요소는 오전 12시입니다.

동작	Format	JavaScript dateValue.toString()
날짜만	-	2023-10-15 00:00(브라우저 시간대)

참고

JavaScript 날짜 값은 장치 운영 체제 설정에 따른 브라우저 시간대의 영향을 받습니다.

사용자 현지 시간 동작의 경우 클라이언트 API 결과는 UTC 값으로 해석되어야 합니다. Date.getUTCDate(), Date.getUTCHours() 등을 사용하여 작업하세요. 사용자에게 표시되는 내용을 얻으려면 getTimeZoneOffsetMinutes를 적용하세요. Date.getDate(), Date.getHours() 등은 브라우저의 시간대로 값을 표시하므로 사용하지 마세요.

표준 시간대 독립 및 날짜만 동작의 경우 클라이언트 API 결과는 브라우저 시간대의 값으로 해석되어야 합니다. Date.getDate(), Date.getHours() 등을 사용하여 작업하세요. 시간대를 조정할 필요가 없으므로 Date.getUTCDate(), Date.getUTCHours() 등을 사용하지 마십시오.

사용자 현지 시간 동작 변경

관리형 솔루션 게시자가 이를 금지하지 않는 한 기존 사용자 지정 날짜 열의 동작을 사용자 현지 시간에서 날짜만 또는 표준 시간대 독립으로 변경할 수 있습니다. 이것은 일회성 변경입니다.

열 동작을 변경하면 열 동작을 변경한 후 추가하거나 수정한 열 값에 영향을 미칩니다. 기존 열 값은 데이터베이스에 UTC 시간대 형식으로 유지됩니다. 기존 열 값의 동작을 UTC에서 날짜만으로 변경하려면 데이터베이스의 기존 날짜 및 시간 값 동작을 변환하기 위해 개발자의 도움이 필요할 수 있습니다.

경고

기존 날짜 및 시간 열의 동작을 변경하기 전에 비즈니스 규칙, 워크플로 및 계산 열 또는 롤업 필드 같은 열의 모든 종속성을 검토하여 동작 변경 결과로 문제가 발생하지 않도록 해야 합니다. 날짜 및 시간 열의 동작을 변경한 후에는 변경된 열에 종속되는 각 비즈니스 규칙, 워크플로, 계산 열 및 롤업 열을 열고 정보를 검토하고 저장하여 최신 날짜 및 시간 열의 동작 및 값을 사용하도록 합니다.

솔루션 가져오기 중 동작 변경

사용자 현지 시간 동작이 포함된 날짜 열이 포함된 솔루션을 가져오는 경우 동작을 날짜만 또는 표준 시간대 독립으로 변경할 수 있습니다.

참고

게시자인 경우에만 기존 관리되는 날짜만 또는 날짜 및 시간 열의 동작을 변경할 수 있습니다. 이러한 필드를 변경하려면 날짜만 또는 날짜 및 시간 열을 추가한 솔루션을 업그레이드해야 합니다. 추가 정보: 솔루션 업그레이드 또는 업데이트

동작 변경 방지

관리형 솔루션에서 사용자 지정 날짜 열을 배포하는 경우 CanChangeDateTimeBehavior 관리 속성을 False로 설정하여 솔루션을 사용하는 사용자가 동작을 변경하지 못하게 합니다. 추가 정보: 열 관리 속성 설정

날짜만 동작에서 지원되지 않는 날짜 및 시간 쿼리 연산자

다음 날짜 및 시간 관련 쿼리 연산자는 날짜만 동작에 유효하지 않습니다. 이러한 연산자 중 하나가 쿼리에 사용되면 잘못된 연산자 예외 오류가 throw됩니다.

• X분 이상 경과
• X시간 이상 경과
• 지난 X시간
• 다음 X시간

참조 항목

모델 기반 앱에서 날짜 및 시간 이슈 문제 해결
열을 만들고 편집합니다.
계산 열을 정의하여 수동 계산 자동화
열 관리형 속성
Managed 속성
블로그: Dataverse에서 표준 시간대 작업
코드를 사용하여 날짜 및 시간 열의 동작과 형식 구성

참고

귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)

이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).