أهلاً و سهلاً (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".
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.