README

基于 Eonasdan/bootstrap-datetimepicker 的 Yii 2 日期时间选择小部件。

安装

安装此扩展的首选方法是通过 composer。

运行以下命令之一：

php composer.phar require --prefer-dist nkovacs/yii2-datetimepicker "*"

或者

"nkovacs/yii2-datetimepicker": "*"

将以下内容添加到您的 composer.json 文件的 require 部分。

用法

一旦安装了扩展，只需在您的代码中使用它

<?= \nkovacs\datetimepicker\DateTimePicker::widget([
    'name' => 'time',
]); ?>

或作为活动字段

<?= $form->field($model, 'time')->widget(\nkovacs\datetimepicker\DateTimePicker::className(), [
    'clientOptions' => [
        'extraFormats' => ['YYYY-MM-DD HH:mm'],
    ],
]) ?>

只显示日期选择器

<?= $form->field($model, 'time')->widget(\nkovacs\datetimepicker\DateTimePicker::className(), [
    'type' => 'date',
]) ?>

或只显示时间选择器

<?= $form->field($model, 'time')->widget(\nkovacs\datetimepicker\DateTimePicker::className(), [
    'type' => 'time',
]) ?>

如果找到，小部件将加载 Yii::$app->language 的 moment 本地化文件。

根据 type，它将使用 Yii::$app->formatter->dateFormat、Yii::$app->formatter->timeFormat 或 Yii::$app->formatter->datetimeFormat。

使用此扩展中验证器的 timestampAttribute 属性来获取解析后的时间戳。

这两个都可以使用 locale 和 format 选项进行重写。

验证器

该扩展附带了一个改进的日期时间验证器。Yii 的默认 DateValidator 无法处理使用默认 ICU 'medium' 格式的时间值。验证器添加了一个 type 选项，该选项指定应接受哪种类型的值：date、time 或 datetime。

要注册验证器，将以下行添加到您的应用配置文件中

\nkovacs\datetimepicker\DateTimeValidator::register();

这替换了内置的 date 验证器，并添加了 time 和 datetime 验证器

    ...
    ['timestamp', 'datetime'],
    ['time', 'time'],
    ['date', 'date'],
    ...

nkovacs / yii2-datetimepicker

维护者

详细信息

README

安装

用法

验证器