{"id":13812669,"url":"https://github.com/dralshehri/hijridate","last_synced_at":"2026-04-19T18:39:51.925Z","repository":{"id":39880819,"uuid":"155050699","full_name":"dralshehri/hijridate","owner":"dralshehri","description":"Accurate Hijri-Gregorian date conversion based on Umm al-Qura calendar","archived":false,"fork":false,"pushed_at":"2026-01-11T09:00:30.000Z","size":625,"stargazers_count":80,"open_issues_count":0,"forks_count":15,"subscribers_count":7,"default_branch":"main","last_synced_at":"2026-03-24T07:42:37.276Z","etag":null,"topics":["calendar","conversion","converter","date","gregorian","hijri","islamic","python","saudi-arabia","ummalqura","ummulqura"],"latest_commit_sha":null,"homepage":"https://hijridate.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dralshehri.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2018-10-28T08:37:30.000Z","updated_at":"2026-03-15T08:39:00.000Z","dependencies_parsed_at":"2023-11-16T03:12:15.595Z","dependency_job_id":"91e588b5-f68d-4065-818c-233dd5f2595b","html_url":"https://github.com/dralshehri/hijridate","commit_stats":{"total_commits":398,"total_committers":3,"mean_commits":"132.66666666666666","dds":0.007537688442211032,"last_synced_commit":"4898e635e05fe6c55098917c79807a552018efab"},"previous_names":["mhalshehri/hijri-converter","dralshehri/hijri-converter"],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/dralshehri/hijridate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dralshehri%2Fhijridate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dralshehri%2Fhijridate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dralshehri%2Fhijridate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dralshehri%2Fhijridate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dralshehri","download_url":"https://codeload.github.com/dralshehri/hijridate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dralshehri%2Fhijridate/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32018757,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["calendar","conversion","converter","date","gregorian","hijri","islamic","python","saudi-arabia","ummalqura","ummulqura"],"created_at":"2024-08-04T04:00:54.330Z","updated_at":"2026-04-19T18:39:51.890Z","avatar_url":"https://github.com/dralshehri.png","language":"Python","funding_links":[],"categories":["Libraries \u0026 Plugins","Islamic Events and Reminders (19 projects)"],"sub_categories":["Python"],"readme":"# HijriDate\n\n\u003c!-- start description --\u003e\n\n\u003e formerly `hijri-converter`\n\nA Python package for accurate Hijri-Gregorian date conversion using the Umm al-Qura calendar.\n\nHijriDate provides reliable date conversion based on official sources, including archived Umm al-Qura newspaper publications and comparative calendar data from King Abdulaziz City for Science and Technology (KACST). The package has been thoroughly tested and verified against original references to ensure accuracy and reliability.\n\n\u003c!-- end description --\u003e\n\n\u003c!-- start badges --\u003e\n\n[![Release Status](https://img.shields.io/badge/release-pass-success)][release] [![Coverage Status](https://img.shields.io/badge/coverage-100%25-success)][coverage] [![PyPI Downloads](https://static.pepy.tech/badge/hijri-converter)][downloads] [![PyPI Version](https://img.shields.io/pypi/v/hijridate)][pypi-version] [![Conda Version](https://img.shields.io/conda/vn/conda-forge/hijridate)][conda-version] [![Package License](https://img.shields.io/github/license/dralshehri/hijridate)][license] [![Package DOI](https://img.shields.io/badge/doi-10.5281%2Fzenodo.11200950-blue) ][doi]\n\n[release]: https://github.com/dralshehri/hijridate/releases/latest\n[coverage]: https://github.com/dralshehri/hijridate/releases/latest\n[downloads]: https://pepy.tech/project/hijri-converter\n[pypi-version]: https://pypi.python.org/pypi/hijridate\n[conda-version]: https://anaconda.org/conda-forge/hijridate\n[license]: https://github.com/dralshehri/hijridate/blob/main/LICENSE\n[doi]: https://doi.org/10.5281/zenodo.11200950\n\n\u003c!-- end badges --\u003e\n\n\u003c!-- start summary --\u003e\n\n## ✨ Features\n\n- Accurate and verified Hijri-Gregorian date conversion\n- Based on official Umm al-Qura calendar sources and archived publications\n- Optimized performance compared to existing implementations\n- Comprehensive input validation and error handling\n- Multilingual support for Arabic, English, and other languages\n- Rich comparison operations and date formatting options\n- Full type annotations and 100% test coverage\n- Zero runtime dependencies\n- Compatible with Python 3.9+\n\n## ⚠️ Limitations\n\n**Date Range**: The converter supports dates from 1343 AH to 1500 AH (1 August 1924 CE to 16 November 2077 CE), corresponding to the period covered by available official calendar sources.\n\n**Religious Context**: Not intended for religious purposes where lunar crescent sighting is preferred over astronomical calculations.\n\n## 📦 Installation\n\nTo install using `uv`, run:\n\n```shell\nuv add hijridate\n```\n\nTo install using `pip`, run:\n\n```shell\npip install hijridate\n```\n\nTo install using `conda`, run:\n\n```shell\nconda install -c conda-forge hijridate\n```\n\n## 🚀 Basic Usage\n\n```python\nfrom hijridate import Hijri, Gregorian\n\n# Convert a Hijri date to Gregorian\nhijri_date = Hijri(1445, 6, 15)\ngregorian_date = hijri_date.to_gregorian()\nprint(gregorian_date)  # 2023-12-28\n\n# Convert a Gregorian date to Hijri\ngregorian_date = Gregorian(2023, 12, 28)\nhijri_date = gregorian_date.to_hijri()\nprint(hijri_date)  # 1445-06-15\n```\n\n\u003c!-- end summary --\u003e\n\n## 📚 Documentation\n\nPlease refer to \u003chttps://hijridate.readthedocs.io\u003e for complete documentation on this package, which includes background information, benchmarking, usage examples, and API reference.\n\n## 🤝 Contributing\n\nIf you're interested in contributing, please check out the [Contributing](https://github.com/dralshehri/hijridate/blob/main/CONTRIBUTING.md) guide for more information on how you can help!\n\n## 📄 License\n\nThis project is licensed under the terms of the MIT license.\n\n\u003c!-- start attrs --\u003e\n\n## 🙏 Acknowledgements\n\n- [R.H. van Gent](http://www.staff.science.uu.nl/~gent0113) \u0026mdash; inspiration, scientific guidance and resources.\n- [@AZalshehri7](https://github.com/AZalshehri7) \u0026mdash; support in dates review and conversion accuracy verification.\n\n## 📝 Citation\n\nIf you plan to cite this project in your academic publication, please refer to \u003chttps://doi.org/10.5281/zenodo.11200950\u003e for citation information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdralshehri%2Fhijridate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdralshehri%2Fhijridate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdralshehri%2Fhijridate/lists"}