README

此包帮助开发者在 Laravel 4 应用程序中轻松处理贾拉利（波斯或伊朗）日期，基于贾拉利（波斯）DateTime 类。此包基于 Laravel 3 捆绑包 sallar/laravel-jdate 由 Sallar Kaboli 开发。此包由 Milad Rey 从 Laravel 3 捆绑包转换为 Laravel 4 包。此库的旧版本无法以拉丁文风格在贾拉利日期中创建两个年份之间的数字范围。

安装

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

    "sajjadrad/jalali": "dev-master"

运行 Composer 更新命令

$ composer update

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

    'providers' => array(

        'Illuminate\Foundation\Providers\ArtisanServiceProvider',
        'Illuminate\Auth\AuthServiceProvider',
        ...
        'Sajjadrad\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() // ۱۰ دقیقه پیش

// Format function return number in persian style by default.You can convert it to latin style by init convert flag in argument.
$date = jDate::forge(time())->format('Y',true);

格式化

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

注意

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

许可证

• 此捆绑包基于 Laravel-Date 由 Scott Travis（MIT 许可证）创建。
• 包含在包中的 贾拉利（波斯）DateTime 类由 Sallar Kaboli 创建，并发布在 MIT 许可证下。
• 旧版本由 Milad Rey 创建，并发布在 MIT 许可证下。_ 此版本也发布在 MIT 许可证下。