# TimeFYI — Full Documentation

> World clock service for 6040+ cities, 196 countries,
> 268 time zones in 15 languages (English default).

## URL Patterns

### City Time Pages
- Pattern: /time/{city-slug}/
- Example: /time/seoul/, /time/new-york/, /time/london/
- Count: 6040 cities

### Country Pages
- Pattern: /country/{country-slug}/
- Example: /country/south-korea/, /country/united-states/
- Count: 196 countries

### Timezone Pages
- Pattern: /timezone/{tz-slug}/
- Example: /timezone/asia-seoul/, /timezone/america-new-york/
- Count: 268 timezones

### Time Difference
- Pattern: /difference/{from-city}-to-{to-city}/
- Example: /difference/seoul-to-new-york/

### Tools
- /tools/ — Tools index
- /tools/converter/ — Time zone converter

### Search
- /search/?q={query} — Search cities, countries, and glossary terms

### Glossary
- /glossary/ — Time-related terminology
- /glossary/{slug}/ — Term detail

## Languages (15)
English (default, no URL prefix), Korean (/ko/), Japanese (/ja/),
Chinese (/zh-hans/), Spanish (/es/), Portuguese (/pt/), Hindi (/hi/),
Arabic (/ar/), French (/fr/), Russian (/ru/), German (/de/),
Turkish (/tr/), Vietnamese (/vi/), Indonesian (/id/), Thai (/th/)

## Data Sources
- IANA Time Zone Database (tzdata)
- GeoNames.org city database
- Python holidays library
- Korean Lunar Calendar (korean-lunar-calendar)
- Astral library for sunrise/sunset calculations