이 페이지는 Cloud Translation API를 통해 번역되었습니다.

DateTime

상용시 (또는 경우에 따라 물리적 시간)를 나타냅니다.

이 유형은 다음과 같은 몇 가지 방법 중 하나로 상용시를 나타낼 수 있습니다.

utcOffset이 설정되고 timeZone이 설정되지 않은 경우: 역일 중 UTC로부터 특정 오프셋을 갖는 상용 시간입니다.
timeZone이 설정되고 utcOffset이 설정되지 않은 경우: 특정 시간대에서 하루 중 하루 중 상용시입니다.
timeZone과 utcOffset이 모두 설정되지 않은 경우: 역일 중 현지 시간으로 된 상용 시간입니다.

날짜는 그레고리력을 기준으로 합니다.

연도, 월, 일이 0이면 DateTime은 각각 특정 연도, 월, 일이 없는 것으로 간주됩니다.

이 유형은 모든 날짜 및 시간 필드가 설정되고 time_offset 중 하나의 케이스가 설정된 경우 실제 시간을 나타내는 데 사용될 수도 있습니다. 대신 Timestamp 메시지를 물리적 시간으로 사용해 보세요. 사용 사례에서 사용자의 시간대를 저장하려면 다른 필드에서 수행하면 됩니다.

이 유형은 일부 애플리케이션에서 원하는 것보다 더 유연합니다. 애플리케이션의 제한사항을 문서화하고 검증하세요.

JSON 표현

JSON 표현
{ "year": integer, "month": integer, "day": integer, "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer, // Union field `time_offset` can be only one of the following: "utcOffset": string, "timeZone": { object (`TimeZone`) } // End of list of possible types for union field `time_offset`. }

{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}

입력란
`year`	`integer` 선택사항입니다. 연도. 1에서 9999 사이의 값이어야 합니다. 연도 없이 날짜/시간을 지정할 경우 0입니다.
`month`	`integer` 선택사항입니다. 월. 1~12 사이의 값이어야 합니다. 월 없이 날짜/시간을 지정하면 0입니다.
`day`	`integer` 선택사항입니다. 일. 1~31 사이의 값이어야 하며 연도와 월에 유효해야 합니다. 날짜 없이 날짜/시간을 지정하는 경우 0입니다.
`hours`	`integer` 선택사항입니다. 24시간 형식의 시간입니다. 범위는 0~23이며 기본값은 0 (자정)입니다. API는 비즈니스 종료 시간과 같은 시나리오에서 '24:00:00' 값을 허용하도록 선택할 수 있습니다.
`minutes`	`integer` 선택사항입니다. 특정 시간의 분입니다. 0~59 사이의 값이어야 하며 기본값은 0입니다.
`seconds`	`integer` 선택사항입니다. 특정 분의 초입니다. 일반적으로 0~59 사이여야 하며 기본값은 0입니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다.
`nanos`	`integer` 선택사항입니다. 나노초 단위의 초수입니다. 0~999,999,999 사이여야 하며 기본값은 0입니다.
통합 필드 `time_offset`. 선택사항입니다. UTC 오프셋 또는 DateTime의 시간대를 지정합니다. 시간대 데이터가 향후 변경될 수 있다는 점을 고려하여 (예: 국가에서 DST 시작일/종료일을 수정하며, 영향을 받는 범위의 미래 날짜/시간은 이미 저장되어 있음) 중에서 신중하게 선택하세요. 생략하면 DateTime은 현지 시간으로 간주됩니다. `time_offset`은 다음 중 하나여야 합니다.
`utcOffset`	`string (Duration format)` UTC 오프셋입니다. -18시간에서 +18시간 사이의 정수 초여야 합니다. 예를 들어 UTC 오프셋 -4:00은 { seconds: -14400 }으로 표시됩니다. 소수점 아래가 최대 9자리까지이고 '`s`'로 끝나는 초 단위 기간입니다. 예를 들면 `"3.5s"`입니다.
`timeZone`	`object (TimeZone)` 시간대

TimeZone

IANA 시간대 데이터베이스에서 가져온 시간대를 나타냅니다.

JSON 표현
{ "id": string, "version": string }

입력란

입력란
`id`	`string` IANA 시간대 데이터베이스의 시간대입니다(예: 'America/New_York').
`version`	`string` 선택사항입니다. IANA 시간대 데이터베이스의 버전 번호입니다(예: '2019a').

id

string

IANA 시간대 데이터베이스의 시간대입니다(예: 'America/New_York').

version

string

선택사항입니다. IANA 시간대 데이터베이스의 버전 번호입니다(예: '2019a').