Islamic Calendar API

GET /v1/calendar

Chuyển đổi ngày Gregorian sang Hijri và ngược lại.

Query Parameters

Tên	Loại	Mô tả
`date`	string	Ngày Gregorian `YYYY-MM-DD`. Mặc định: hôm nay
`hijri`	string	Ngày Hijri `DD-MM-YYYY` (để chuyển ngược lại)

Ví dụ

# Gregorian → Hijri
GET /v1/calendar?date=2024-03-15

# Hijri → Gregorian
GET /v1/calendar?hijri=04-09-1445

Response

{
  "success": true,
  "data": {
    "gregorian": {
      "date": "2024-03-15",
      "day": 15,
      "month": 3,
      "year": 2024,
      "weekday": "Friday",
      "weekdayLocal": "Thứ Sáu"
    },
    "hijri": {
      "date": "04-09-1445",
      "day": 4,
      "month": 9,
      "monthName": "Ramadan",
      "year": 1445,
      "isRamadan": true
    }
  }
}

GET /v1/calendar/events

Lấy danh sách sự kiện Hồi giáo trong một năm.

Query Parameters

Tên	Loại	Mô tả
`year`	number	Năm Gregorian. Mặc định: năm hiện tại

Ví dụ

GET /v1/calendar/events?year=2024

Response

{
  "success": true,
  "data": [
    {
      "name": "Ramadan",
      "nameLocal": "Tháng Ramadan",
      "hijriDate": "1 Ramadan 1445",
      "gregorianDate": "2024-03-12",
      "gregorianDateEnd": "2024-04-09",
      "type": "month",
      "description": "Tháng nhịn chay của người Hồi giáo"
    },
    {
      "name": "Eid al-Fitr",
      "nameLocal": "Lễ Eid al-Fitr",
      "hijriDate": "1 Shawwal 1445",
      "gregorianDate": "2024-04-10",
      "type": "holiday",
      "description": "Lễ kết thúc tháng Ramadan"
    },
    {
      "name": "Eid al-Adha",
      "nameLocal": "Lễ Eid al-Adha",
      "hijriDate": "10 Dhul Hijjah 1445",
      "gregorianDate": "2024-06-17",
      "type": "holiday",
      "description": "Lễ hiến tế"
    }
  ]
}

Sự kiện được hỗ trợ

Sự kiện	Ngày Hijri
Ramadan (bắt đầu)	1 Ramadan
Eid al-Fitr	1 Shawwal
Eid al-Adha	10 Dhul Hijjah
Mawlid al-Nabi	12 Rabi' al-Awwal
Laylat al-Qadr	27 Ramadan
Islamic New Year	1 Muharram
Ashura	10 Muharram

On this page