---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/timezone-converter
---
# Timezone Converter

Look up current time in any city, convert between time zones, get DST transition info, or browse timezone identifiers by region. Accepts city names — no IANA codes needed. For scheduling, global teams, and travel apps.

- **Version:** 0.02
- **Categories:** data, productivity

## Skills (4)

### Current Time (`current_time`)

Get the current time in any timezone, city, or geographic coordinates. Supports 80+ city names, IANA timezone codes, or latitude/longitude.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `timezone` | string | No | Timezone name (e.g. "America/New_York") or city name (e.g. "Tokyo", "New York"). Use this OR latitude+longitude. |
| `latitude` | number | No | Latitude (-90 to 90). Use with longitude instead of timezone. |
| `longitude` | number | No | Longitude (-180 to 180). Use with latitude instead of timezone. |

**Returns:** Current date, time, day of week, and DST status for the specified timezone

**Examples:**

*Get current time in Tokyo:*

```json
{
  "timezone": "Tokyo"
}
```

*Get current time in New York using IANA timezone:*

```json
{
  "timezone": "America/New_York"
}
```

### Convert Time (`convert_time`)

Convert a specific time (or the current time) from one timezone to another. Supports IANA timezone names and city names. Omit the datetime parameter to convert the current time.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `from_timezone` | string | Yes | Source timezone or city name (e.g. "America/New_York", "London", "Tokyo") |
| `to_timezone` | string | Yes | Target timezone or city name (e.g. "Asia/Tokyo", "Sydney", "Paris") |
| `datetime` | string | No | Date and time to convert in "YYYY-MM-DD HH:MM:SS" format. Omit or set to "now" to convert the current time. |

**Returns:** Original and converted times with full date, time, day of week, and DST status for both timezones

**Examples:**

*Convert current time from New York to Tokyo:*

```json
{
  "from_timezone": "New York",
  "to_timezone": "Tokyo"
}
```

*Convert a specific time from London to Sydney:*

```json
{
  "from_timezone": "London",
  "to_timezone": "Sydney",
  "datetime": "2026-03-20 14:30:00"
}
```

### Timezone Info (`timezone_info`)

Get detailed information about a timezone including current UTC offset, standard offset, daylight saving time status, and DST transition dates. Supports IANA timezone names and city names.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `timezone` | string | Yes | Timezone name (e.g. "America/New_York", "Europe/London") or city name (e.g. "Tokyo", "New York", "Sydney") |

**Returns:** UTC offset, standard offset, DST status, and DST transition dates for the timezone

**Examples:**

*Get timezone info for New York:*

```json
{
  "timezone": "New York"
}
```

*Check DST details for London:*

```json
{
  "timezone": "Europe/London"
}
```

### List Timezones (`list_timezones`)

List all available IANA timezones. Optionally filter by region prefix like "America", "Europe", "Asia", "Africa", "Pacific", "Australia", "Atlantic", or "Indian".

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `region` | string | No | Optional region prefix to filter by (e.g. "America", "Europe", "Asia", "Pacific") |

**Returns:** List of IANA timezone identifiers, optionally filtered by region

**Examples:**

*List all European timezones:*

```json
{
  "region": "Europe"
}
```

*List all available timezones:*

```json
{}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call timezone-converter current_time --timezone Tokyo

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"timezone-converter","skill":"current_time","input":{"timezone":"Tokyo"}}' \
     https://api.toolrouter.com/v1/tools/call
```

## Frequently Asked Questions

### Can I get the current time in a city without knowing its IANA code?

Yes. `current_time` accepts city names directly, so you can ask for Tokyo, New York, or similar locations without looking up a timezone ID first.

### How do I convert time between two places?

Use `convert_time` with a source timezone and a destination timezone. If you leave out `datetime`, it converts the current time instead.

### Can I check DST and UTC offset details?

Yes. `timezone_info` shows the current UTC offset, standard offset, DST status, and the next transition dates for that timezone.

### How do I browse valid timezone names?

Use `list_timezones` to browse IANA timezone identifiers by region, such as Europe or America.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs