🚀 Quick Start

No API key required for the free tier. Just send a GET request:

curl https://globetimezone.com/api/v1/current?tz=America/New_York

That's it. You get JSON back with the current time, UTC offset, DST status, and more.

📋 API Endpoints

GET /api/v1/current

Get current time for a timezone

Returns current date/time, UTC offset, DST status, and timezone abbreviation for any IANA timezone.

Parameters

Parameter	Type	Required	Description
`tz`	string	Yes	IANA timezone (e.g. America/New_York, Asia/Tokyo)
`format`	string	No	Output format: "json" (default) or "text"

Example Response

{
  "timezone": "America/New_York",
  "datetime": "2026-05-22T09:15:00-04:00",
  "time": "09:15",
  "date": "2026-05-22",
  "utc_offset": "-04:00",
  "dst": true,
  "abbreviation": "EDT",
  "weekday": "Friday",
  "timestamp": 1747912500
}

GET /api/v1/convert

Convert time between time zones

Convert a specific date/time from one timezone to another.

Parameter	Type	Required	Description
`from`	string	Yes	Source IANA timezone
`to`	string	Yes	Target IANA timezone
`time`	string	No	Time in HH:MM format (default: now)
`date`	string	No	Date in YYYY-MM-DD format (default: today)

{
  "from": { "timezone": "Asia/Shanghai", "datetime": "2026-05-22T21:00:00+08:00" },
  "to": { "timezone": "America/New_York", "datetime": "2026-05-22T09:00:00-04:00" },
  "offset_hours": -12
}

GET /api/v1/timezones

List all supported time zones

Returns a complete list of IANA timezones with metadata.

Parameter	Type	Required	Description
`region`	string	No	Filter by region (Asia, Europe, Americas, etc.)
`search`	string	No	Search by city/country name

{
  "total": 400,
  "timezones": [
    { "name": "America/New_York", "offset": -5, "region": "Americas", "dst": true },
    { "name": "Europe/London", "offset": 0, "region": "Europe", "dst": true }
  ]
}

GET /api/v1/overlap

Find overlapping working hours between time zones

Calculate the overlapping business hours for multiple time zones. Perfect for scheduling international meetings.

Parameter	Type	Required	Description
`zones`	string	Yes	Comma-separated IANA timezones (max 6)
`start`	number	No	Workday start hour (default: 9)
`end`	number	No	Workday end hour (default: 18)

{
  "zones": ["America/New_York", "Europe/London", "Asia/Shanghai"],
  "working_hours": { "start": 9, "end": 18 },
  "overlaps": [
    { "utc_hour": 13, "new_york": "09:00 AM", "london": "02:00 PM", "shanghai": "09:00 PM" },
    { "utc_hour": 14, "new_york": "10:00 AM", "london": "03:00 PM", "shanghai": "10:00 PM" },
    { "utc_hour": 15, "new_york": "11:00 AM", "london": "04:00 PM", "shanghai": "11:00 PM" }
  ]
}

GET /api/v1/timezone/:zone

Get current time and offset for a timezone

Returns detailed timezone information including current time, UTC offset, DST status, and abbreviation.

Example: GET /api/v1/timezone/America%2FNew_York

⚠️ 时区标识符中的 / 必须编码为 %2F（如 America%2FNew_York）。

Response

{
  "zone": "America/New_York",
  "offset": -14400,
  "abbreviation": "EDT",
  "dst": true,
  "currentTime": "2026-05-22T09:15:00-04:00"
}

💎 Plans & Pricing

🆓 Free

forever

1,000 requests/month
All endpoints
JSON responses
No API key needed
Community support

⚡ Pro

$9.99

/month

100,000 requests/month
All endpoints
JSON + XML responses
Higher rate limits
Email support
Bulk conversion endpoint

🏢 Enterprise

Custom

Unlimited requests
All endpoints
SLA guarantee
Dedicated support
On-premise option
Custom integrations

⏱️ Rate Limits

Plan	Rate	Burst	Reset
Free	10 req/min	5 concurrent	Every 60s
Pro	100 req/min	50 concurrent	Every 60s
Enterprise	1,000 req/min	200 concurrent	Every 60s

Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

💻 Code Examples

JavaScript (Fetch)

const response = await fetch(
  'https://globetimezone.com/api/v1/current?tz=Asia/Tokyo'
);
const data = await response.json();
console.log(`Tokyo time: ${data.time} ${data.abbreviation}`);

Python (requests)

import requests
r = requests.get(
  'https://globetimezone.com/api/v1/convert',
  params={'from': 'America/New_York', 'to': 'Asia/Shanghai'}
)
data = r.json()
print(f"Shanghai: {data['to']['datetime']}")

cURL

# Get current Tokyo time
curl "https://globetimezone.com/api/v1/current?tz=Asia/Tokyo"

# Find overlaps for meeting planning
curl "https://globetimezone.com/api/v1/overlap?zones=America/New_York,Europe/London,Asia/Shanghai"

⚡ GlobeTimeZone API