kakajan/lumen-jalali

This Package helps developers to easily work with Jalali (Shamsi or Iranian) dates in lumen 5.5+ applications

Maintainers

Details

github.com/kakajan/lumen-jalali

Source

Issues

Installs: 407

Dependents: 0

Suggesters: 0

Security: 0

Stars: 4

Watchers: 2

Forks: 0

Open Issues: 0

1.0 2017-12-07 15:48 UTC

Requires

  • php: >=5.3.0

MIT ea7adaa5e794b5ffdaf937262d9a26975a006bd4

  • UsherQelich Sayyedmuhammadi <faslolkhitab.woop@gmail.com>

datedatetimeJalalilumen

This package is not auto-updated.

Last update: 2024-11-10 05:45:54 UTC

README

npm Dockbit Chrome Web Store Jenkins tests

This Package helps developers to easily work with Jalali (Shamsi or Iranian) dates in lumen 5.5+ applications.

Installation

In the require key of composer.json file add the following

    "kakajan/lumen-jalali": "1.0"

Run the Composer update comand

$ composer update

Or just run command

$ composer require kakajan/lumen-jalali

In your bootstrap/app.php add $app->register(jDate\Jalali\JalaliServiceProvider::class); for registring service provider.

    
    $app->register(App\Providers\AppServiceProvider::class);
    $app->register(App\Providers\AuthServiceProvider::class);
    .
    .
    $app->register(jDate\Jalali\JalaliServiceProvider::class);

In your bootstrap/app.php add class_alias('jDate\Jalali\jDate', 'jDate'); before return $app;

    
    class_alias('jDate\Jalali\jDate', 'jDate');
    return $app;

Basic Usage

Examples

Some Examples

// 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

// get relative 'ago' format
$date = jDate::forge('now - 10 minutes')->ago(); // ۱۰ دقیقه پیش

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