README

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

安装

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

    "miladr/jalali": "dev-master"

运行 Composer 更新命令

$ composer update

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

    'providers' => array(

        'Illuminate\Foundation\Providers\ArtisanServiceProvider',
        'Illuminate\Auth\AuthServiceProvider',
        ...
        'Miladr\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（MIT 许可证）由 Scott Travis 创建。
• 包含在包中的 贾拉利（波斯）DateTime 类是由 Sallar Kaboli 创建的，并发布在 MIT 许可证下。
• 此包由 Milad Rey 创建，并发布在 MIT 许可证下。