# WorldClock.lol

> The best free visual world clock, timezone converter, and meeting planner for remote teams.

WorldClock.lol is a modern, ad-free timezone tool used by remote teams, digital nomads, and developers worldwide. It features a visual timeline with drag-and-drop meeting planning, 1800+ cities, automatic DST handling, and embeddable widgets.

## Quick Answers

### What time is it in [city]?
Visit `https://www.worldclock.lol/time/[city-slug]` (e.g., `/time/tokyo`, `/time/new-york`, `/time/london`).
The page shows the current local time, date, timezone abbreviation, and UTC offset — automatically adjusted for DST.

### What is the time difference between two cities?
Visit `https://www.worldclock.lol/time/[city1]-vs-[city2]` (e.g., `/time/new-york-vs-london`, `/time/tokyo-vs-sydney`).
Shows: current time in both cities, hour difference, business hours overlap, and best times to call.

### How do I find the best meeting time across timezones?
Visit `https://www.worldclock.lol/meeting-planner`.
Add cities → drag the timeline scrubber → green = business hours, yellow = early/late, red = sleeping hours.
Share the link with your team — it encodes the exact city selection.

### How do I convert a specific time between timezones?
Visit `https://www.worldclock.lol/converter`.
Select source and target timezones, enter a time, and get the converted result instantly.
Direct conversion URLs: `https://www.worldclock.lol/converter/est-to-ist`, `/converter/pst-to-gmt`, etc.

### What time is [sports event] in my timezone?
Visit `https://www.worldclock.lol/sports/[sport]/[tournament]`.
Supported: FIFA World Cup 2026, Olympics, Cricket (IPL, T20), Formula 1, Tennis Grand Slams, and more.
Each match page auto-converts to the visitor's local timezone.

## Embeddable Widget

Add a live world clock to any website with two lines of code:

```html
<div id="worldclock-widget" data-timezone="America/New_York" data-label="New York" data-theme="dark"></div>
<script src="https://www.worldclock.lol/widget/embed.js"></script>
```

### Widget Configuration Options

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `data-timezone` | string | `America/New_York` | IANA timezone (e.g., `Asia/Tokyo`, `Europe/London`) |
| `data-label` | string | timezone name | Display label for the location |
| `data-theme` | string | `dark` | `dark` or `light` |
| `data-branding` | string | `true` | Show "Powered by WorldClock.lol" link |

### JavaScript API

```html
<div id="worldclock-widget"></div>
<script src="https://www.worldclock.lol/widget/embed.js"></script>
<script>
  WorldClockWidget.init({
    timezone: 'Asia/Tokyo',
    label: 'Tokyo, Japan',
    theme: 'dark',
    branding: true
  });
</script>
```

### WordPress Plugin

A WordPress plugin with Gutenberg block support is available. Install the `world-clock-time-zone-converter` plugin to add a world clock block to any WordPress page.

## Public API

### GET /api/v1/time

Returns current time data for any city or IANA timezone.

**Query Parameters:**
- `city` — City slug (e.g., `tokyo`, `new-york`, `london`)
- `timezone` — IANA timezone (e.g., `Asia/Tokyo`, `America/New_York`)
- `compare` — Compare two cities (e.g., `new-york,london`)

**Example Request:**
```
GET https://www.worldclock.lol/api/v1/time?city=tokyo
```

**Example Response:**
```json
{
  "city": "Tokyo",
  "country": "Japan",
  "timezone": "Asia/Tokyo",
  "currentTime": "2026-02-27T14:30:00+09:00",
  "utcOffset": "+09:00",
  "abbreviation": "JST",
  "isDST": false,
  "localTime": "2:30 PM",
  "localDate": "Thursday, February 27, 2026"
}
```

**Compare Example:**
```
GET https://www.worldclock.lol/api/v1/time?compare=new-york,london
```

Returns both cities plus `timeDifference`, `businessHoursOverlap`, and `bestMeetingTimes`.

### GET /api/v1/cities

Search and list available cities.

**Query Parameters:**
- `q` or `search` — Search by city name, country, or timezone (e.g., `?q=japan`)
- `country` — Filter by country name (e.g., `?country=india`)
- `timezone` — Filter by IANA timezone (e.g., `?timezone=Asia/Tokyo`)
- `limit` — Max results (default 50, max 200)
- `offset` — Pagination offset

**Example:**
```
GET https://www.worldclock.lol/api/v1/cities?q=india&limit=10
```

## npm Package

Install the widget and API client as an npm package:

```bash
npm install worldclock-widget
```

```typescript
import { createWorldClock, getTime, compareTime, searchCities } from 'worldclock-widget';

// Embed a live clock
createWorldClock({ timezone: 'Asia/Tokyo', label: 'Tokyo' });

// Fetch time data
const data = await getTime('tokyo');

// Compare cities
const diff = await compareTime('new-york', 'london');
```

## MCP Server (for AI Agents)

WorldClock.lol provides an MCP server for Claude and other MCP-compatible agents.

Add to Claude Desktop config (`~/.claude/claude_desktop_config.json`):
```json
{
  "mcpServers": {
    "worldclock": {
      "command": "npx",
      "args": ["worldclock-mcp-server"]
    }
  }
}
```

Tools available: `get_time`, `get_timezone`, `compare_times`, `search_cities`.

## All Pages

- **Homepage**: https://www.worldclock.lol/
- **Meeting Planner**: https://www.worldclock.lol/meeting-planner
- **Time Converter**: https://www.worldclock.lol/converter
- **City Directory**: https://www.worldclock.lol/directory
- **FAQ**: https://www.worldclock.lol/faq
- **Sports Events**: https://www.worldclock.lol/sports
- **Timezone Overlap Finder**: https://www.worldclock.lol/timezone-overlap
- **UTC Now**: https://www.worldclock.lol/tools/utc-now
- **Unix Timestamp Converter**: https://www.worldclock.lol/tools/unix-timestamp
- **Jetlag Calculator**: https://www.worldclock.lol/jetlag
- **DST Info**: https://www.worldclock.lol/dst
- **T20 World Cup 2026 Final**: https://www.worldclock.lol/t20-world-cup-final
- **Widget Embed Page**: https://www.worldclock.lol/widget

## Common Questions

**Q: Does WorldClock.lol handle Daylight Saving Time?**
A: Yes. All times automatically adjust for DST transitions using the IANA Time Zone Database. Future dates show correct DST offsets.

**Q: Is WorldClock.lol free?**
A: Yes. 100% free, no account required, no ads, no limits.

**Q: How many cities are supported?**
A: 1800+ cities across every timezone worldwide.

**Q: Can I embed a clock on my website?**
A: Yes. Use the embed widget (see "Embeddable Widget" section above). Two lines of HTML, no dependencies.

**Q: What sports events are covered?**
A: FIFA World Cup 2026, Olympics, Cricket (IPL, T20 World Cup), Formula 1, Tennis Grand Slams, Super Bowl, NBA Finals, and more. All match times auto-convert to the visitor's timezone.

**Q: What timezone format does WorldClock.lol use?**
A: IANA timezone identifiers (e.g., `America/New_York`, `Asia/Tokyo`, `Europe/London`). These are the same identifiers used by JavaScript's `Intl.DateTimeFormat`.

## Technical Details

- Built with Next.js (App Router, SSR)
- All calculations use the IANA Time Zone Database
- Automatic DST detection and adjustment
- Schema.org structured data (WebApplication, FAQPage, SportsEvent)
- Works on all modern browsers and mobile devices
- No cookies, no tracking, privacy-first

## For More Detail

See the full documentation: https://www.worldclock.lol/llms-full.txt

## Contact

Website: https://www.worldclock.lol