Download the PHP package remls/hijri-date without Composer

On this page you can find all versions of the php package remls/hijri-date. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Example code of remls/hijri-date

Informations about the package hijri-date

HijriDate

Laravel helper package for Hijri dates. Supports displaying dates in Arabic, Bengali, Dhivehi and English out of the box, with support for further customizations or adding a language of your choice.

Installation

To publish configuration files:

Creating dates

All of the following methods return an instance of Remls\HijriDate\HijriDate.

Customizing how dates are converted between Hijri and Gregorian

By default, the package uses an external map between Hijri and Gregorian dates in Maldives to convert between the two. This map is cached and reused for subsequent conversions.

You may customize for how long the map is cached by changing config/hijri.php > conversion.cache_period.

You may manually re-fetch data from the external source by running php artisan hijri:fetch.

The package also comes with an alternative class for converting dates using calculations instead of a map. You may enable it by changing config/hijri.php > conversion.converter to \Remls\HijriDate\Converters\MaldivesEstimateG2HConverter::class.

You may customize how dates are converted by:

Available methods

Conversions

You may customise how the conversion works, as detailed here.

Calculations

Comparisons

You may compare two HijriDate objects $a and $b using the following methods:

Method Description
$a->compareWith($b) Returns -1 if $a < $b.
Returns 0 if $a == $b.
Returns 1 if $a > $b.
$a->equalTo($b) Returns true if $a == $b.
$a->greaterThan($b) Returns true if $a > $b (a is after b).
$a->lessThan($b) Returns true if $a < $b (a is before b).
$a->greaterThanOrEqualTo($b) Returns true if $a >= $b (a is after or equal to b).
$a->lessThanOrEqualTo($b) Returns true if $a <= $b (a is before or equal to b).

Formatting

Each HijriDate object will have a set locale when it is created. This locale will be used for formatting.

The locale is 'dv' by default, but you may customize it by:

The following options are supported with $date->format():

Option Description Example
d Day of month (with leading zero) 01 ... 30
D Weekday (short) Sun ... Sat
j Day of month (without leading zero) 1 ... 30
l
(lowercase L)		 Weekday Sunday ... Saturday
F Month Muharram ... Dhul-Hijja
m Month (number, with leading zero) 01 ... 12
M Month (short) Mhr ... DhH
n Month (number, without leading zero) 1 ... 12
Y Year 1000 ... 1999
y Year (final two digits) 00 ... 99

Casting

The field to be cast must be a string field on database.

This will automatically store data as Y-m-d string in database, and cast to Remls\HijriDate\HijriDate when accessing.

Validation

Any string that passes the following conditions is considered a valid Hijri date:

Note that validation error messages will use app's locale (unlike formatting).

Localization

Publish translation files by using:

You may then customize strings as needed.

Adding a language

To add support for another language:

  1. Publish the configuration file. The file will be copied to config/hijri.php.
  2. Publish the translation files. The files will be copied to lang/vendor/hijri.
  3. Copy one of the existing translation folders, and rename it with the language code of your choice. Eg: lang/vendor/hijri/es
  4. Change strings to their respective translations.
  5. Add the language code to supported_locales in config/hijri.php.
  6. (Optional) Change default_locale in config/hijri.php to the new language code.

Migrating from v1 to v2

The package no longer uses estimates when converting from Hijri to Gregorian by default.

All versions of hijri-date with dependencies

PHP Build Version
Package Version
Requires php Version >=8.0
laravel/framework Version ^8.0||^9.0||^10.0||^11.0
ext-intl Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package remls/hijri-date contains the following files

Loading the files please wait ....