README

此包为 filament v3 DatePicker 和 DateTimePicker 添加了 jalali 支持。

对于 Filament v2，您可以使用此包的版本 1。

安装

您可以通过 composer 安装此包

composer require ariaieboy/filament-jalali-datetimepicker

用法

use Ariaieboy\FilamentJalaliDatetimepicker\Forms\Components\JalaliDatePicker;
use Ariaieboy\FilamentJalaliDatetimepicker\Forms\Components\JalaliDateTimePicker;
\Filament\Forms\Components\DatePicker::make('birth_date')->jalali();

\Filament\Forms\Components\DateTimePicker::make('birth_date')->jalali(weekdaysShort: true);

有关更多信息，请参阅默认的 DateTimePicker 文档： https://filamentphp.com/docs/2.x/forms/fields#date-time-picker

更新日志

请参阅 CHANGELOG 了解最近更改的信息。

升级

v2 到 v3

• 步骤 1：将您的 composer.json 中的包版本更改为 ^3 并运行 composer update 命令

        "ariaieboy/filament-jalali-datetimepicker": "^3",

• 步骤 2：如果您正在使用 JalaliDateTimePicker 或 JalaliDatePicker 类，应删除这些类并使用默认的 Filament DatePicker 类。
  • 有关更多信息，请参阅 v1 到 v2 升级指南的第 2 步。
• 步骤 3（可选）：在 V3 中，我们引入了两个新的 lang 文件，名为 months 和 days。使用这两个文件，您可以自定义月份和日期标签。
  • 要自定义 lang 文件，请使用以下命令
    • php artisan vendor:publish --tag=filament-jalali-datetimepicker-translations
• 向后兼容性检查
  • 在 V3 中，我们更改了一些默认值。如果您想自定义这些值，您应该在 jalali 方法之后使用方法。
    1. 默认的日期标签是 long。要更改此，您应将 true 作为第一个 jalali(weekdaysShort: true) 参数传递。
    2. 我们将默认周的开始更改为 周六。
    3. 默认格式已更改为 Y-m-d 和 Y-m-d H:i:s，用于 datePicker 和 dateTimePicker。
  • 我们将提供 jalali 兼容性的底层包从 dayjs 更改为 @calidy/dayjs-calendarsystems。
  • 在 V3 中，我们仅支持 laravel >= 11 和 php >= 8.2。

v1 到 v2

• 步骤 1：将您的 composer.json 中的包版本更改为 ^2 并运行 composer update 命令

        "ariaieboy/filament-jalali-datetimepicker": "^2",

• 步骤 2（可选）

  您可以将 jalaliDatePicker 和 jalaliDateTimePicker 更改为默认的 DatePicker 和 DateTimePicker，然后使用 jalali() 方法将日期选择器转换为 jalali 格式。例如

//convert
JalaliDateTimePicker::make('birth_date'),
// to 
Forms\Components\DateTimePicker::make('birth_date')->jalali(),
//and
//convert
JalaliDatePicker::make('birth_date'),
//to
\Filament\Forms\Components\DatePicker::make('birth_date')->jalali()

旧格式将在 v2 中正常工作，但我们可能会在下一个主要版本中删除它。

贡献

有关详细信息，请参阅 CONTRIBUTING。

安全漏洞

有关如何报告安全漏洞的信息，请参阅 我们的安全策略。

鸣谢

• ariaieboy
• 所有贡献者

许可证

MIT 许可证（MIT）。有关更多信息，请参阅 许可证文件。