---
title: Convert Timezone and Meeting Planner API
slug: timezone-conversion
url: https://apyhub.com/creightonnick0/service/timezone-conversion
provider: nick creighton
categories: [Geolocation, Standard Data]
tags: [timezone-conversion, dst, iana-timezone, meeting-planner, time-zones]
auth: api_key
---

# Convert Timezone and Meeting Planner API

Convert local datetimes across IANA time zones with DST-aware offsets, or plan meetings across multiple zones. Returns structured source, UTC, and target times.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `` | What it does Converts or plans time across time zones using DST-aware timezone data. The request bo… | 10 |

## About

## What it does
Timezone Converter turns a local datetime into one or more target time zones, with DST-aware offsets and abbreviations. It also supports meeting planning across multiple IANA zones and a current-time lookup for a pinned instant.

Send `mode` with `convert`, `meeting`, or `now`. In `convert` mode, provide `from_tz`, `to_tz`, and `datetime_str` to translate a local ISO 8601 datetime from one IANA timezone into target zones. In `meeting` and `now` modes, pass `zones`; optionally pin the reference instant with `now_epoch`, and set `work_start` and `work_end` for meeting planning.

The response includes structured timezone results for the source, UTC, and each requested target zone. For each zone, you get `date`, `time`, `datetime`, `weekday`, `is_dst`, `utc_offset`, `utc_offset_minutes`, and `tz_abbreviation`. That makes it useful when you need to show local times in scheduling tools, coordinate distributed teams, or convert appointment times without hard-coding offset logic.

Use Timezone Converter when your app stores times in one region but displays them in another, or when you need to compare working hours across offices in different time zones.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/creightonnick0/service/timezone-conversion