deen-time

# Deen Time Your daily Islamic prayer companion. Provides accurate Salah times (Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha) for any city or coordinates worldwide. During Ramadan, also provides Suhoor (pre-dawn meal) and Iftar (fast-breaking) schedules with full monthly calendars. ## When to Use This Skill Use this skill when the user asks about: - Prayer times for a specific location - Iftar or Suhoor times - Ramadan schedule or timetable - When to break fast or start fasting - Fajr, Dhuhr, Asr, Maghrib, or Isha times - Islamic prayer schedule ## How It Works This skill uses the **Aladhan Prayer Times API** (`https://aladhan.com/prayer-times-api`), a free and reliable public API that requires no authentication. ### Fetching Prayer Times by City ```bash curl -L "https://api.aladhan.com/v1/timingsByCity?city={CITY}&country={COUNTRY}&method={METHOD}" ``` Replace `{CITY}`, `{COUNTRY}`, and `{METHOD}` with actual values. URL-encode spaces (e.g., `New%20York`). Always use `-L` to follow redirects. ### Fetching Prayer Times by Coordinates ```bash curl -L "https://api.aladhan.com/v1/timings/{DD-MM-YYYY}?latitude={LAT}&longitude={LNG}&method={METHOD}" ``` Use this when the user provides latitude/longitude or when a city name is ambiguous. ### Fetching a Full Monthly Calendar ```bash curl -L "https://api.aladhan.com/v1/calendarByCity/{YEAR}/{MONTH}?city={CITY}&country={COUNTRY}&method={METHOD}" ``` Use this for Ramadan schedules. `{MONTH}` is the Gregorian month number (1-12). ## Calculation Methods The `method` parameter controls prayer time calculation. Pick the most appropriate one based on the user's region: | Method | Organization | Best For | |--------|-------------|----------| | 1 | University of Islamic Sciences, Karachi | Pakistan, Bangladesh, India | | 2 | Islamic Society of North America (ISNA) | North America | | 3 | Muslim World League (MWL) | Europe, Far East | | 4 | Umm Al-Qura University, Makkah | Saudi Arabia, Gulf | | 5 | Egyptian General Authority of Survey | Africa, Syria, Lebanon | | 7 | Institute of Geophysics, University of Tehran | Iran | | 8 | Gulf Region | UAE, Kuwait, Qatar | | 9 | Kuwait | Kuwait | | 10 | Qatar | Qatar | | 11 | Majlis Ugama Islam Singapura | Singapore | | 12 | Union Organization Islamic de France | France | | 13 | Diyanet Isleri Baskanligi | Turkey | | 14 | Spiritual Administration of Muslims of Russia | Russia | | 15 | Moonsighting Committee Worldwide | Global (moonsighting-based) | **Defaults**: Use method `2` for North America, `4` for Saudi/Gulf, `3` for Europe, `5` for Africa, `13` for Turkey, `1` for South Asia. If the user doesn't specify a preference, select based on their location. ## API Response Structure The API returns JSON. The key fields to extract: ```json { "data": { "timings": { "Fajr": "05:12", "Sunrise": "06:30", "Dhuhr": "12:15", "Asr": "15:30", "Maghrib": "18:00", "Isha": "19:20", "Imsak": "05:02" }, "date": { "readable": "19 Feb 2026", "hijri": { "date": "02-09-1447", "month": { "number": 9, "en": "Ramadan" }, "year": "1447" } } } } ``` For the calendar endpoint, `data` is an array of day objects with the same structure. ## Presenting Results ### Daily Prayer Times Display as a clean table: ``` Prayer Times for {City}, {Country} Date: {Gregorian Date} | {Hijri Date} | Prayer | Time | |----------|--------| | Fajr | 05:12 | | Sunrise | 06:30 | | Dhuhr | 12:15 | | Asr | 15:30 | | Maghrib | 18:00 | | Isha | 19:20 | Suhoor: Stop eating before 05:12 (Fajr). Recommended: 05:02 (Imsak). Iftar: Break fast at 18:00 (Maghrib). ``` ### Ramadan Monthly Schedule For monthly requests, present a condensed table: ``` Ramadan Schedule for {City} — {Year} | Day | Date | Suhoor (Imsak) | Fajr | Iftar (Maghrib) | |-----|------------|-----------------|-------|-----------------| | 1 | 17 Feb | 05:02 | 05:12 | 17:45 | | 2 | 18 Feb | 05:01 | 05:11 | 17:46 | | ... | ... | ... | ... | ... | ``` ### Important Notes to Convey - **Suhoor** must be completed before Fajr. The Imsak time (typically 10 min before Fajr) is the recommended cutoff. - **Iftar** is at Maghrib (sunset). - All times are in the **local timezone** of the requested location. - If the user doesn't specify a location, ask for their city and country. - If the user doesn't specify a date, use today's date. ## Example Interactions **User**: "What are the prayer times for London today?" → Call: `curl -L "https://api.aladhan.com/v1/timingsByCity?city=London&country=United%20Kingdom&method=3"` → Display all prayer times in a formatted table with both Gregorian and Hijri dates. **User**: "When is Iftar in Dubai?" → Call: `curl -L "https://api.aladhan.com/v1/timingsByCity?city=Dubai&country=United%20Arab%20Emirates&method=4"` → Highlight the Maghrib time as the Iftar time. **User**: "Give me the Ramadan schedule for Istanbul" → Determine the Gregorian months that overlap with Ramadan for the current year. → Call: `curl -L "https://api.aladhan.com/v1/calendarByCity/2026/2?city=Istanbul&country=Turkey&method=13"` (and March if Ramadan spans two months) → Filter to only Ramadan days (check Hijri month = 9 / Ramadan) and present the Suhoor/Iftar table. **User**: "Suhoor time for New York?" → Call: `curl -L "https://api.aladhan.com/v1/timingsByCity?city=New%20York&country=United%20States&method=2"` → Show the Imsak and Fajr times. Recommend stopping eating at Imsak (10 min before Fajr). **User**: "Prayer times for coordinates 21.4225, 39.8262" → Call: `curl -L "https://api.aladhan.com/v1/timings/19-02-2026?latitude=21.4225&longitude=39.8262&method=4"` → Display full prayer times (these coordinates are Makkah, so use Umm Al-Qura method). ## Privacy and Data Handling This skill makes **read-only HTTPS requests** to the [Aladhan Prayer Times API](https://aladhan.com/prayer-times-api), a well-known, free, public Islamic prayer times service. - **Data sent**: Only the city/country name or coordinates provided by the user, plus a calculation method number. No personal data, credentials, or device information is transmitted. - **Data received**: Prayer times (JSON) for the requested location and date. No tracking, cookies, or user profiling. - **No authentication**: The API requires no API keys, tokens, or accounts. - **No data storage**: This skill does not write to disk, store user data, or maintain any state between invocations. - **Single domain**: All network requests go exclusively to `api.aladhan.com` over HTTPS. No other external endpoints are contacted.