# TimeFYI

> Comprehensive time and timezone reference for developers, travelers, and remote teams. 500 cities across 196 countries with real-time clocks, sunrise/sunset times, DST tracking, 200 glossary terms, 150 guides, 24 solar terms, 41 timezone abbreviations, 6 interactive tools, and N-squared time difference pages. All times computed on-the-fly via pure-Python TimeEngine.

## Data Scope
- 500 cities across 196 countries with timezone, coordinates, and population data
- Real-time world clock with sunrise/sunset, moon phase, and weather
- N-squared time difference pages (e.g. /difference/new-york-vs-tokyo/)
- 200 glossary terms covering timezone science and time standards
- 150 guides across 6 series (timezone basics, DST, travel, business, tech, calendar culture)
- 24 East Asian solar terms (節気/절기/节气) with astronomical dates
- 41 timezone abbreviations (PST, EST, CET, JST, KST, ...)
- 50 DST country profiles with transition schedules
- 7 continent overview pages
- Popular city pair comparisons (27 featured pairs)
- 15 languages: en, ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id).
- `/` — Homepage — world clock with featured cities (e.g. `/`)
- `/worldclock/` — World clock with all featured cities (e.g. `/worldclock/`)
- `/time/` — Browse all cities by region (e.g. `/time/`)
- `/time/{slug}/` — City detail — current time, sunrise/sunset, timezone info (e.g. `/time/new-york/`)
- `/country/{slug}/` — Country detail with cities and timezone info (e.g. `/country/united-states/`)
- `/timezone/{slug}/` — Timezone detail with cities (e.g. `/timezone/america-new-york/`)
- `/difference/{city1}-vs-{city2}/` — Time difference between two cities (N² pSEO) (e.g. `/difference/new-york-vs-tokyo/`)
- `/convert/{tz1}-to-{tz2}/` — Timezone conversion tool (e.g. `/convert/pst-to-jst/`)
- `/sun/{slug}/` — Sunrise/sunset times for a city (e.g. `/sun/tokyo/`)
- `/dst/{slug}/` — DST schedule for a country (e.g. `/dst/united-states/`)
- `/offset/{offset}/` — Cities in a UTC offset (e.g. `/offset/utc-plus-9/`)
- `/continent/{slug}/` — Continental overview (e.g. `/continent/asia/`)
- `/abbreviation/{slug}/` — Timezone abbreviation detail (e.g. `/abbreviation/pst/`)
- `/popular/` — Popular city pair comparisons (e.g. `/popular/`)
- `/popular/{slug}/` — Popular pair detail (e.g. `/popular/new-york-vs-london/`)
- `/solar-terms/` — 24 East Asian solar terms (e.g. `/solar-terms/`)
- `/solar-terms/{slug}/` — Solar term detail (e.g. `/solar-terms/spring-equinox/`)
- `/calendar/` — Calendar with holidays and events (e.g. `/calendar/`)
- `/holidays/` — Holidays browser (e.g. `/holidays/`)
- `/glossary/` — Time and timezone glossary index (e.g. `/glossary/`)
- `/glossary/{slug}/` — Glossary term detail (e.g. `/glossary/utc/`)
- `/guides/` — In-depth guides on time and timezones (e.g. `/guides/`)
- `/guides/{series}/{slug}/` — Guide article (e.g. `/guides/timezone-basics/what-is-utc/`)
- `/tools/` — Interactive time tools index (e.g. `/tools/`)
- `/tools/{slug}/` — Tool page (e.g. `/tools/converter/`)
- `/search/` — Search cities, countries, timezones (e.g. `/search/?q=tokyo`)

## World Clock & Cities
- [World Clock](https://timefyi.com/worldclock/)
- [Browse Cities](https://timefyi.com/time/)
- [Popular City Pairs](https://timefyi.com/popular/)

## Timezone Reference
- [Timezone Browser](https://timefyi.com/timezone/)
- [Timezone Abbreviations (41)](https://timefyi.com/abbreviation/)
- [UTC Offsets](https://timefyi.com/offset/)
- [DST Country Profiles (50)](https://timefyi.com/dst/)
- [Continent Overview](https://timefyi.com/continent/)

## Interactive Tools
- [Timezone Converter](https://timefyi.com/tools/converter/)
- [Date Calculator](https://timefyi.com/tools/date-calculator/)
- [Unix Time Converter](https://timefyi.com/tools/unix-time/)
- [Timer / Stopwatch](https://timefyi.com/tools/timer/)
- [Meeting Planner](https://timefyi.com/tools/meeting-planner/)
- [World Clock Dashboard](https://timefyi.com/tools/worldclock/)

## Astronomy & Calendar
- [24 Solar Terms (East Asian Calendar)](https://timefyi.com/solar-terms/)
- [Sunrise & Sunset Times](https://timefyi.com/sun/)
- [Calendar](https://timefyi.com/calendar/)
- [Holidays](https://timefyi.com/holidays/)

## Reference & Learning
- [Glossary — Time & Timezone Terms (200)](https://timefyi.com/glossary/)
- [Guides — 150 Articles in 6 Series](https://timefyi.com/guides/)

## Embed Widget
- [TimeFYI Widget Docs](https://widget.timefyi.com)
- [timefyi-embed on npm](https://www.npmjs.com/package/timefyi-embed)
- [timefyi-embed on GitHub](https://github.com/fyipedia/timefyi-embed)

## REST API

Free REST API. No authentication required. JSON responses. CORS enabled.

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/search/` | Autocomplete city search |
| GET | `/api/city/{slug}/` | City detail with current time and sun info |
| GET | `/api/country/{slug}/` | Country detail with cities |
| GET | `/api/cities/` | List all cities |
| GET | `/api/countries/` | List all countries |
| GET | `/api/compare/` | Time difference between cities |
| GET | `/api/v1/time/{timezone_id}/` | Current time in a timezone (IANA ID) |
| GET | `/api/glossary/{slug}/` | Glossary term detail |
| GET | `/api/guide/{series}/{slug}/` | Guide article detail |
| GET | `/api/v1/cities/` | Cities (DRF ViewSet, paginated) |
| GET | `/api/v1/countries/` | Countries (DRF ViewSet, paginated) |
| GET | `/api/v1/glossary/` | Glossary terms (DRF ViewSet, paginated) |
| GET | `/api/v1/guides/` | Guides (DRF ViewSet, paginated) |
| GET | `/api/v1/tools/` | Tools (DRF ViewSet) |
| GET | `/api/v1/faqs/` | FAQs (DRF ViewSet) |
| GET | `/api/v1/search/?q={query}` | Unified search (DRF) |
| GET | `/api/v1/stats/` | Site statistics |

```bash
curl -s "https://timefyi.com/api/city/tokyo/"
```

[API Docs](https://timefyi.com/developers/) · [OpenAPI Spec](https://timefyi.com/api/openapi.json)

## Developer Tools
- **PyPI**: `pip install timefyi` — [timefyi](https://pypi.org/project/timefyi/) — Timezone ops, business hours, sunrise/sunset (v0.1.2)
- **npm**: `npm install timefyi` — [timefyi](https://www.npmjs.com/package/timefyi) — TypeScript timezone utilities (v0.1.1)
- **Embed Widget**: [timefyi-embed](https://widget.timefyi.com)

## Utility FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [UnitFYI](https://unitfyi.com) — 220 units, 20 categories, Decimal precision
- [HolidayFYI](https://holidayfyi.com) — Holiday dates, Easter calculation, 200+ countries
- [NameFYI](https://namefyi.com) — Korean romanization, Five Elements, CJK strokes

## Images (CDN)

OG images at https://cdn.timefyi.com/og/
- https://cdn.timefyi.com/og/homepage.png

## Full Index
- [Full content index](https://timefyi.com/llms-full.txt)
- [XML Sitemap](https://timefyi.com/sitemap.xml)