mmkargar/jalali
- This package compatible with Laravel 5
Installation
Run the Composer update comand
$ composer require mmkargar/jalali
In your config/app.php
add 'MmKargar\Jalali\JalaliServiceProvider'
to the end of the $providers
array
'providers' => [
'Illuminate\Foundation\Providers\ArtisanServiceProvider',
'Illuminate\Auth\AuthServiceProvider',
...
'MmKargar\Jalali\JalaliServiceProvider',
],
.
.
.
.
.
'alias' => [
...
'jDate' => 'MmKargar\Jalali\Facades\jDate',
'jDateTime' => 'MmKargar\Jalali\Facades\jDateTime',
]
Basic Usage
Examples
Some Examples (based on examples provided by Sallar)
// default timestamp is now
$date = jDate::forge();
// pass timestamps
$date = jDate::forge(1333857600);
// pass strings to make timestamps
$date = jDate::forge('last sunday');
// get the timestamp
$date = jDate::forge('last sunday')->time(); // 1333857600
// format the timestamp
$date = jDate::forge('last sunday')->format('%B %d، %Y'); // دی 02، 1391
// get a predefined format
$date = jDate::forge('last sunday')->format('datetime'); // 1391-10-02 00:00:00
$date = jDate::forge('last sunday')->format('date'); // 1391-10-02
$date = jDate::forge('last sunday')->format('time'); // 00:00:00
// amend the timestamp value, relative to existing value
$date = jDate::forge('2012-10-12')->reforge('+ 3 days')->format('date'); // 1391-07-24
//convert jalali to gregorian
$date = JDate::jalaliToGregorian("1399/09/15"); // output : 2020-12-05
// get relative 'ago' format
$date = jDate::forge('now - 10 minutes')->ago() // ۱۰ دقیقه پیش
//date_parse_from_format for jalali date
$date = jDate::parseFromFormat('Y/m/d', '1393/01/18');
echo $date['year']; //1393
echo $date['month']; //01
echo $date['day']; //18
Formatting
For help in building your formats, checkout the PHP strftime() docs.
Notes
The class relies on strtotime()
to make sense of your strings, and strftime()
to make the format changes. Just always check the time()
output to see if you get false timestamps... which means the class couldn't understand what you were telling it.
License
- This bundle is created based on Laravel-Date by Scott Travis (MIT Licensed).
- Jalali (Shamsi) DateTime class included in the package is created by Sallar Kaboli and is released under the MIT License.
- This package was created by Milad Rey and is released under the MIT License.