locations-v2

Resolve Local Timezone Offset

Converts an offset-free local birth datetime plus an IANA timezone ID into the ISO-8601 datetime with UTC offset expected by chart calculation endpoints.

post/v2/timezone/resolve

Request

  • Base URL: https://api.humandesignhub.app
  • URL: https://api.humandesignhub.app/v2/timezone/resolve
  • Auth: API key in header X-API-KEY

Request body

timezonestring required

IANA timezone ID (예: Asia/Seoul)

datestring nullable

로컬 날짜 YYYY-MM-DD

timestring nullable

로컬 시간 HH:MM 또는 HH:MM:SS

local_datetimestring nullable

오프셋 없는 로컬 ISO datetime (예: 1990-05-12T14:30:00)

disambiguation'earlier' | 'later' | 'reject'

DST fall-back처럼 같은 local time이 두 번 존재할 때 선택할 offset

Response

Successful Response

datetimestring required

차트 API에 바로 전달 가능한 ISO datetime

local_datetimestring required

입력 로컬 datetime

timezonestring required

IANA timezone ID

utc_offsetstring required

UTC offset 문자열

offset_minutesinteger required

UTC offset 분 단위

ambiguousboolean

DST fall-back 등으로 local time이 중복되는지 여부

disambiguation_used'earlier' | 'later' nullable

Changes

No recorded changes to this operation across all 1 revision of this API.