Jet Lag Planner
A day-by-day sleep, light and caffeine plan to beat jet lag, with calendar export.
Try an example: Berlin → New York (westward, 6 h) · London → Tokyo (eastward, 9 h)
How it works
Pick your home and destination time zones, travel date and usual sleep times. The planner computes the real time difference for that date (including daylight saving), shifts your sleep before departure, and lists when to seek or avoid bright light and when to stop caffeine until you are adapted. Download it as a calendar file.
- Time difference = destination UTC offset (at noon UTC on the arrival date) − home UTC offset (at noon UTC on the departure date), via the Intl time-zone database, so daylight saving is included. It is normalised to −12…+12 h; positive = eastward (clock must advance), negative = westward (delay).
- Pre-flight: sleep and wake move 1 hour per day toward destination time (earlier for east, later for west), as suggested in the CDC Yellow Book jet-lag chapter for the 2–3 days before travel; days beyond what is needed are skipped.
- After arrival you sleep on local time; the body clock is assumed to catch up 1 h/day after eastward and 1.5 h/day after westward travel (common planning rule of thumb, not an individual prediction).
- Core body temperature minimum (CBTmin) is estimated at 2.5 h before the body’s habitual wake time (2 h for early birds, 3 h for night owls).
- Light rule (phase-response curve): to advance (east) seek bright light in the 3 h after CBTmin and avoid it in the 3 h before; to delay (west) seek light in the 3 h before CBTmin and avoid it in the 3 h after. If a window falls while you sleep, use only its waking part.
- Caffeine cut-off = 6 h before planned bedtime (CDC Yellow Book example).
- The .ics file contains bedtime, light and caffeine events in UTC with UIDs derived from a hash of your inputs, CRLF line endings and folded lines.
General planning guidance, not medical advice. Ask a clinician before using melatonin or sleep medication.
Sources
- Jet Lag Disorder — CDC Yellow Book 2026 (U.S. Centers for Disease Control and Prevention) retrieved 2026-10-12
For scripts and AI agents
- JSON API:
POST https://jetlagplanner.usefulweb.site/api/v1/calculate(same calculation as this page) - Interface description: OpenAPI 3.1 · AI guide: llms.txt
- MCP server (Streamable HTTP):
https://jetlagplanner.usefulweb.site/mcp· tool namejet_lag_planner
Example request
curl -s -X POST https://jetlagplanner.usefulweb.site/api/v1/calculate \
-H 'content-type: application/json' \
-d '{"homeZone":"Europe/Berlin","destinationZone":"America/New_York","departureDate":"2026-11-10","bedtime":"23:00","wakeTime":"07:00","daysBefore":3,"chronotype":"intermediate"}'Related tools
- Travel Connection Checker – Estimate your odds of making a flight connection, step by step.