Package google.type

색인

날짜

생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0이 아닌 전체 날짜
  • 월과 일, 연도는 0(예: 기념일)
  • 연도만, 월과 일은 0
  • 연도와 월, 일은 0(예: 신용카드 만료일)

관련 유형:

필드
year

int32

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.
month

int32

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.
day

int32

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

일시

상용시(또는 간혹 물리적 시간)를 나타냅니다.

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

  • utc_offset이 설정되고 time_zone이 설정되지 않은 경우: UTC 기준으로 특정 오프셋이 있는 캘린더 일자의 상용시입니다.
  • time_zone이 설정되고 utc_offset이 설정되지 않은 경우: 특정 시간대의 캘린더 일자 상용시입니다.
  • time_zone 또는 utc_offset이 모두 설정되지 않은 경우: 현지 시간으로 캘린더 일자의 상용시입니다.

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

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

이 유형은 모든 날짜 및 시간 필드가 설정되었고 time_offset 중 하나가 설정된 경우 실제 시간을 나타내는 데 사용될 수도 있습니다. 실제 시간으로 대신 Timestamp 메시지를 사용하는 것이 좋습니다. 사용 사례에서 사용자의 시간대를 저장하려는 경우 다른 필드에서 저장할 수 있습니다.

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

필드
year

int32

선택사항. 연도. 1~9999 사이의 값이어야 합니다. 단, 연도 없이 날짜/시간을 지정할 경우 0입니다.
month

int32

선택사항. 월. 1~12 사이의 값이어야 합니다. 단, 월 없이 날짜/시간을 지정할 경우 0입니다.
day

int32

선택사항. 일. 1~31 사이의 값이어야 하며 유효한 연도와 월이어야 합니다. 정해진 날 없이 날짜/시간을 지정할 경우 0입니다.
hours

int32

선택사항. 24시간 형식의 시간입니다. 0~23 사이의 값이어야 하며 기본값은 0(자정)입니다. API는 비즈니스 종료 시간과 같은 시나리오에서 '24:00:00' 값을 허용하도록 선택할 수 있습니다.
minutes

int32

선택사항. 특정 시간의 분입니다. 0에서 59 사이의 값이어야 하며 기본값은 0입니다.
seconds

int32

선택사항. 특정 분의 초입니다. 일반적으로 0에서 59 사이의 값이어야 하며 기본값은 0입니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다.
nanos

int32

선택사항. 나노초 단위의 초수입니다. 0~999,999,999 사이의 값이어야 하며 기본값은 0입니다.
통합 필드 time_offset. 선택사항. UTC 오프셋 또는 DateTime의 시간대를 지정합니다. 이후에 시간대 데이터가 변경될 수 있으므로(예: 국가에서 DST 시작일/종료일을 수정하고 영향을 받는 범위의 향후 DateTime이 이미 저장된 경우) 이 점을 고려하여 신중하게 선택하세요. 생략하면 DateTime이 현지 시간으로 간주됩니다. time_offset은 다음 중 하나여야 합니다.
utc_offset

Duration

UTC 오프셋입니다. -18시간에서 +18시간 사이의 정수 초여야 합니다. 예를 들어 UTC 오프셋 -4:00은 {초: -14400}으로 표현됩니다.
time_zone

TimeZone

시간대입니다.

간격

타임스탬프 시작(포함) 및 타임스탬프 종료(제외)로 인코딩된 시간 간격을 나타냅니다.

시작은 종료보다 작거나 같아야 합니다. 시작이 종료와 같으면 간격이 비어 있습니다(시간과 일치하지 않음). 시작과 종료가 모두 지정되지 않은 경우 간격은 모든 시간과 일치합니다.

필드
start_time

Timestamp

선택사항입니다. 간격의 시작(포함)입니다.

지정된 경우 이 간격과 일치하는 타임스탬프는 시작과 같거나 시작 이후여야 합니다.
end_time

Timestamp

선택사항입니다. 간격의 끝(제외)입니다.

지정된 경우 이 간격과 일치하는 타임스탬프는 종료 시간 이전이어야 합니다.

LatLng

위도/경도 쌍을 나타내는 객체로 위도와 경도를 나타내는 복식 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.

필드
latitude

double

위도입니다. 범위는 [-90.0, +90.0]입니다.
longitude

double

경도입니다. 범위는 [-180.0, +180.0]입니다.

LocalizedText

특정 언어로 된 텍스트의 현지화된 변형입니다.

필드
text

string

아래의 language_code에 해당하는 언어로 된 현지화된 문자열입니다.
language_code

string

텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').

자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참조하세요.

TimeZone

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

필드
id

string

IANA 시간대 데이터베이스 시간대입니다. 예를 들면 "America/New_York"입니다.
version

string

선택사항. IANA 시간대 데이터베이스 버전 번호입니다. 예를 들면 "2019a"입니다.