README

本包帮助开发者在Laravel 4应用程序中轻松处理贾拉利（伊斯兰或伊朗）日期，基于贾拉利（伊斯兰）DateTime类。本包基于Sallar Kaboli的Laravel 3包sallar/laravel-jdate。

安装

在composer.json文件的require键中添加以下内容

    "alifattahi/jalali": "dev-master"

运行Composer更新命令

$ composer update

在您的config/app.php中，将'Alifattahi\Jalali\JalaliServiceProvider'添加到$providers数组的末尾

    'providers' => array(

        'Illuminate\Foundation\Providers\ArtisanServiceProvider',
        'Illuminate\Auth\AuthServiceProvider',
        ...
        'Alifattahi\Jalali\JalaliServiceProvider',

    ),

基本用法

示例

一些示例（基于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

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

格式化

有关构建格式的帮助，请参阅PHP strftime() 文档。

注意

该类依赖于strtotime()来理解您的字符串，并依赖于strftime()来执行格式更改。只需始终检查time()的输出，以查看您是否获得了错误的戳记...这意味着类无法理解您告诉它的内容。

许可

• 本包基于Laravel-Date创建，由Scott Travis提供（MIT许可）。
• 包含在包中的贾拉利（伊斯兰）DateTime类由Sallar Kaboli创建，并按照MIT许可发布。
• 本包由Milad Rey创建，并按照MIT许可发布。