calendar

أهلاً و سهلاً (welcome)

This website's purpose is to help people convert dates between the gregorian calendar and the hijri or islamic calendar. There is also a special tools for web developers: a Unix timestamps conversion tool and an API. hijri-tools.cc is based on Hijri.js, a small JS library that can be found here. It uses the Saudi calendar commonly called "Umm al-Qura".

What is a Hijri calendar ?

The Hijri calendar is the Islamic lunar calendar, which started with the migration (Hijrah) of the Prophet Muhammad ﷺ from Makkah to Medina in 622 CE. It is made up of 12 lunar months and is about 11 days shorter than the Gregorian solar calendar. In short, a hijri calendar is the islamic calendar.

In the Islamic calendar, each month begins with the sighting of the new moon, marking the start of a new lunar cycle. Historically, this has been determined by the actual observation of the moon's crescent (known as the hilal), which signals the end of the previous lunar month and the start of the new one. As a result, the length of each month can vary—either 29 or 30 days—depending on factors like the moon's visibility, Earth's astronomical position, and weather conditions. Among the twelve months of the Hijri calendar, four are regarded as sacred: Rajab (the 7th month), as well as the three consecutive months of Dhū al-Qa'dah (11th), Dhu al-Ḥijjah (12th), and Muḥarram (1st).


Tools

Please remember that Hijri dates may vary by country or region due to differences in moon sighting. This website operates using Eastern Standard Time.

Convert gregorian date to hijri date


Convert Unix timestamp to hijri date


API

A small API is offered, completely free of charge, to convert Unix timestamps to Hijri dates. No api key or password required.

Request



Try it yourself with today's timestamp

ENDPOINT: https://hijri-tools.cc/api/

key type description
timestamp Integer A Unix timestamp. please remember that the timestamp must be inferior to 3400000000. Timestamps beyond that are too far into the future for the api. All negative timestamps will be converted to positive values.
                                curl -X GET 'https://hijri-tools.cc/api/?timestamp=1767404350'
                              


Response

If the request succeeds, A JSON is returned with the following information
                              
                              {
                                "year":1389,
                                "month":10,
                                "day":22,
                                "monthname_ar":"ذوالقعدة",
                                "monthname_en":"Dhu al-Qi'dah",
                                "dayofweek_ar":"الأربع",
                                "dayofweek_en":"Wednesday",
                                "time":"19:00:01"
                              }
                              
key type description
year Integer The year in hijri
month Integer The number of the month from 1 to 12
day Integer The date number from 1 to 30
monthname_ar string The name of the hijri month in Arabic
monthname_en string The name of the hijri month in English
dayofweek_ar string The day of the week in Arabic.
dayofweek_en string The day of the week in English.
time string The time in EST (Eastern Standard Time)

Error Handling and Limits

On error, a message will be returned in JSON format indicating an invalid timestamp:
                              { "error": "invalid timestamp" }
                            

Please do not overflow the server with requests. When the server is overflown, it will return a 429 Too Many Requestse HTTP Code or simply block further calls to the api.

Terms and Conditions

**Terms and Conditions** These terms and conditions (the "Terms of Service" or "Agreement") represent the complete agreement between you ("User," "You," or "Your") and Caffeine Comics, a registered company in Canada ("Caffeine Comics," "The Company," "Us," "Our," or "We").

1. Acceptance of Terms By accessing or using this website (the "Service"), you agree to be bound by these Terms of Use. If you do not agree, do not use the Service.

2. Description of Service This website provides a tool to convert dates between the Gregorian and Hijri (Islamic) calendars. The Service is offered for informational and personal use only.

3. Accuracy and Reliability The date conversions are based on widely accepted algorithms and astronomical calculations. However, we do not guarantee the accuracy, completeness, or reliability of the results. Hijri dates may vary by country or region due to differences in moon sighting. This Service uses a standardized calculation and may not match local religious authorities' announcements. You acknowledge that the Service is not intended for legal, religious, or official purposes and should not be relied upon for such matters.

4. Disclaimer of Liability No Warranty: The Service is provided "as is" and "as available." We make no warranties, express or implied, regarding the Service’s accuracy, reliability, or availability. Limitation of Liability: To the fullest extent permitted by law, we are not liable for any indirect, incidental, special, or consequential damages arising from your use of the Service, including but not limited to errors in date conversions or reliance on the results.

5. User Responsibilities You agree to use the Service only for lawful purposes and in compliance with all applicable laws. You may not use the Service to violate intellectual property rights, transmit harmful content, or interfere with its operation.

6. Intellectual Property All content and tools on this website are the property of [Your Name/Company] and are protected by copyright and other intellectual property laws. You may not reproduce, distribute, or modify any part of the Service without prior written permission.

7. Modifications We reserve the right to modify these Terms of Use at any time. Continued use of the Service after changes constitutes acceptance of the new terms.

8. Governing Law These Terms are governed by the laws of the province of Quebec in Canada, and any disputes will be resolved in the courts of the province of Quebec in Canada.