README

此包帮助开发者在 lumen 5.5+ 应用程序中轻松处理贾拉利（波斯或伊朗）日期。

安装

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

    "kakajan/lumen-jalali": "1.0"

运行 Composer update 命令

$ composer update

或直接运行以下命令

$ composer require kakajan/lumen-jalali

在您的 bootstrap/app.php 中添加 $app->register(jDate\Jalali\JalaliServiceProvider::class); 以注册服务提供者。

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

在您的 bootstrap/app.php 中添加 class_alias('jDate\Jalali\jDate', 'jDate'); 在 return $app; 之前

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

基本用法

示例

一些示例

// 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 许可证发布。
• 由 kakajn 更新以支持 lumen 5.5+ - https://aykam.org。