add DateTimeValidator

Author: nkovacs

DateTimeValidator.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace nkovacs\datetimepicker;
+
+use yii\validators\Validator;
+
+/**
+ * An improved version of Yii's DateValidator that supports parsing time as well.
+ */
+class DateTimeValidator extends \yii\validators\DateValidator
+{
+    /**
+     * @var string the type of value to accept: 'date', 'time' or 'datetime'.
+     * This is only used when the format is ambiguous (i.e. one of the ICU short formats),
+     * otherwise it is ignored, and the format dictates what is accepted.
+     */
+    public $type = 'datetime';
+
+    /**
+     * @inheritdoc
+     */
+    public function init()
+    {
+        parent::init();
+        // if $this->format is a short format,
+        // convert it to a pattern, so that DateValidator will respect $this->type.
+        $this->format = FormatConverter::convertIcuShortFormatToPattern($this->format, $this->type, $this->locale);
+    }
+
+    /**
+     * Replace built-in `date` validator and add `time` and `datetime` validator.
+     */
+    public static function register()
+    {
+        Validator::$builtInValidators['date'] = [
+            'class' => static::className(),
+            'type' => 'date',
+        ];
+        Validator::$builtInValidators['time'] = [
+            'class' => static::className(),
+            'type' => 'time',
+        ];
+        Validator::$builtInValidators['datetime'] = static::className();
+    }
+}

README.md

@@ -64,3 +64,26 @@ The widget will load the moment locale file for `Yii::$app->language` if it can
 It will also use `Yii::$app->formatter->dateFormat`, `Yii::$app->formatter->timeFormat` or `Yii::$app->formatter->datetimeFormat` depending on `type`.
 
 Both can be overriden using the `language` and `format` options.
+
+Validators
+----------
+
+The extension comes with an improved datetime validator. Yii's default DateValidator cannot handle
+time values with the default ICU 'medium' format. The validator adds a `type` option that specifies what
+kind of value should be accepted: `date`, `time` or `datetime`.
+
+To register the validator, add the following line to your app config file:
+
+```php
+\nkovacs\datetimepicker\DateTimeValidator::register();
+```
+
+This replaces the built-in `date` validator and adds a `time` and `datetime` validator:
+
+```php
+    ...
+    ['timestamp', 'datetime'],
+    ['time', 'time'],
+    ['date', 'date'],
+    ...
+```