Download the PHP package sdo-sa/hijri-converter without Composer
On this page you can find all versions of the php package sdo-sa/hijri-converter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package hijri-converter
hijri-converter
Accurate Hijri (Umm al-Qura) ⇄ Gregorian date conversion for PHP.
- Exact, not approximate. Backed by the official Umm al-Qura calendar — no arithmetic guesswork.
- One class to remember:
SDOSA\Hijri, with::toHijri()and::toGregorian(). - Localized month and day names in Arabic, English, Bengali, and Turkish out of the box.
- Zero required dependencies. Optional first-class Laravel + Carbon support.
- Supported span: Gregorian
1924-08-01 → 2077-11-16, Hijri1343 → 1500.
Installation
Requires PHP 8.2+.
Quick start
Everything goes through the single static class SDOSA\Hijri — identical in plain PHP or Laravel:
Value objects
Conversions return small immutable value objects — SDOSA\HijriDate and
SDOSA\GregorianDate — that carry the rich API below. Build them yourself with
::make() (or a named constructor); the plain new constructor is intentionally
closed off, so there is exactly one obvious way to create a date.
API reference
Both value objects share the same shape:
| Method | Returns | Example |
|---|---|---|
year() month() day() |
int |
1403, 2, 17 |
toIso() |
string |
1403-02-17 |
format($sep = '/', $pad) |
string |
17/02/1403 |
monthName($locale = null) |
string |
صفر / Safar |
dayName($locale = null) |
string |
الخميس / Thursday |
notation($locale = null) |
string |
هـ / AH |
longFormat($locale = null) |
string |
17 صفر 1403 هـ / 17 Safar 1403 AH |
isoWeekday() |
int (1–7) |
4 — ISO, Monday = 1 |
weekday() |
int (1–7) |
5 — Saudi week, Sunday = 1 |
equals($other) |
bool |
|
compareTo($other) |
int (-1, 0, 1) |
|
(string) $date |
string |
same as toIso() |
HijriDate adds monthLength(), yearLength(), and toGregorian();
GregorianDate adds toDateTime(), toCarbon(), and toHijri().
Out-of-range or impossible dates throw SDOSA\Exceptions\DateOutOfRange,
InvalidHijriDate, or InvalidGregorianDate — all extend HijriException.
Locales
Four locales ship in the box: ar (default), en, bn (Bengali), tr (Turkish).
Pass a tag to any name method:
Or change the default used when no tag is passed:
In Laravel, set it in config/hijri.php (or the HIJRI_LOCALE env var) instead —
the service provider applies it on boot. Unknown tags fall back to the default,
so a missing translation never breaks a call.
Laravel
The service provider is auto-discovered. The core API is static, so there is no
facade to register — just call SDOSA\Hijri anywhere. The provider wires up
config, the default locale, and Carbon macros.
Try it
- CLI:
php examples/demo.php -
Web: a self-contained, interactive converter that runs the real library —
then open http://localhost:8000.
Credits
The Umm al-Qura dataset and conversion algorithm derive from
dralshehri/hijridate (MIT). See LICENSE.
