setLocale('de_DE'); * * # Validation * * Caution: JavaScript validation is only supported for the 'en_NZ' locale at the moment, * it will be disabled automatically for all other locales. * * # Formats * * All format strings should follow the CLDR standard as per * http://userguide.icu-project.org/formatparse/datetime. These will be converted * automatically to jquery UI format. * * The value of this field in PHP will be ISO 8601 standard (e.g. 2004-02-12), and * stores this as a timestamp internally. * * Note: Do NOT use php date format strings. Date format strings follow the date * field symbol table as below. * * @see http://userguide.icu-project.org/formatparse/datetime * @see http://api.jqueryui.com/datepicker/#utility-formatDate */ class DateField extends TextField { protected $schemaDataType = FormField::SCHEMA_DATA_TYPE_DATE; /** * Override locale. If empty will default to current locale * * @var string */ protected $locale = null; /** * Override date format. If empty will default to that used by the current locale. * * @var null */ protected $dateFormat = null; /** * Set if js calendar should popup * * @var bool */ protected $showCalendar = false; /** * Length of this date (full, short, etc). * * @see http://php.net/manual/en/class.intldateformatter.php#intl.intldateformatter-constants * @var int */ protected $dateLength = null; /** * Override locale for client side. * * @var string */ protected $clientLocale = null; /** * Min date * * @var string ISO 8601 date for min date */ protected $minDate = null; /** * Max date * * @var string ISO 860 date for max date */ protected $maxDate = null; /** * Unparsed value, used exclusively for comparing with internal value * to detect invalid values. * * @var mixed */ protected $rawValue = null; /** * Use HTML5-based input fields (and force ISO 8601 date formats). * * @var bool */ protected $html5 = true; /** * @return bool */ public function getHTML5() { return $this->html5; } /** * @param boolean $bool * @return $this */ public function setHTML5($bool) { $this->html5 = $bool; return $this; } /** * Get length of the date format to use. One of: * * - IntlDateFormatter::SHORT * - IntlDateFormatter::MEDIUM * - IntlDateFormatter::LONG * - IntlDateFormatter::FULL * * @see http://php.net/manual/en/class.intldateformatter.php#intl.intldateformatter-constants * @return int */ public function getDateLength() { if ($this->dateLength) { return $this->dateLength; } return IntlDateFormatter::MEDIUM; } /** * Get length of the date format to use. * Only applicable with {@link setHTML5(false)}. * * @see http://php.net/manual/en/class.intldateformatter.php#intl.intldateformatter-constants * * @param int $length * @return $this */ public function setDateLength($length) { $this->dateLength = $length; return $this; } /** * Get date format in CLDR standard format * * This can be set explicitly. If not, this will be generated from the current locale * with the current date length. * * @see http://userguide.icu-project.org/formatparse/datetime#TOC-Date-Field-Symbol-Table */ public function getDateFormat() { if ($this->getHTML5()) { // Browsers expect ISO 8601 dates, localisation is handled on the client $this->setDateFormat(DBDate::ISO_DATE); } if ($this->dateFormat) { return $this->dateFormat; } // Get from locale return $this->getFrontendFormatter()->getPattern(); } /** * Set date format in CLDR standard format. * Only applicable with {@link setHTML5(false)}. * * @see http://userguide.icu-project.org/formatparse/datetime#TOC-Date-Field-Symbol-Table * @param string $format * @return $this */ public function setDateFormat($format) { $this->dateFormat = $format; return $this; } /** * Get date formatter with the standard locale / date format * * @throws \LogicException * @return IntlDateFormatter */ protected function getFrontendFormatter() { if ($this->getHTML5() && $this->dateFormat && $this->dateFormat !== DBDate::ISO_DATE) { throw new \LogicException( 'Please opt-out of HTML5 processing of ISO 8601 dates via setHTML5(false) if using setDateFormat()' ); } if ($this->getHTML5() && $this->dateLength) { throw new \LogicException( 'Please opt-out of HTML5 processing of ISO 8601 dates via setHTML5(false) if using setDateLength()' ); } if ($this->getHTML5() && $this->locale) { throw new \LogicException( 'Please opt-out of HTML5 processing of ISO 8601 dates via setHTML5(false) if using setLocale()' ); } $formatter = IntlDateFormatter::create( $this->getLocale(), $this->getDateLength(), IntlDateFormatter::NONE ); if ($this->getHTML5()) { // Browsers expect ISO 8601 dates, localisation is handled on the client $formatter->setPattern(DBDate::ISO_DATE); } elseif ($this->dateFormat) { // Don't invoke getDateFormat() directly to avoid infinite loop $ok = $formatter->setPattern($this->dateFormat); if (!$ok) { throw new InvalidArgumentException("Invalid date format {$this->dateFormat}"); } } return $formatter; } /** * Get a date formatter for the ISO 8601 format * * @return IntlDateFormatter */ protected function getInternalFormatter() { $locale = i18n::config()->uninherited('default_locale'); $formatter = IntlDateFormatter::create( i18n::config()->uninherited('default_locale'), IntlDateFormatter::MEDIUM, IntlDateFormatter::NONE ); $formatter->setLenient(false); // CLDR ISO 8601 date. $formatter->setPattern(DBDate::ISO_DATE); return $formatter; } public function getAttributes() { $attributes = parent::getAttributes(); $attributes['lang'] = i18n::convert_rfc1766($this->getLocale()); if ($this->getHTML5()) { $attributes['type'] = 'date'; $attributes['min'] = $this->getMinDate(); $attributes['max'] = $this->getMaxDate(); } return $attributes; } public function getSchemaDataDefaults() { $defaults = parent::getSchemaDataDefaults(); return array_merge($defaults, [ 'lang' => i18n::convert_rfc1766($this->getLocale()), 'data' => array_merge($defaults['data'], [ 'html5' => $this->getHTML5(), 'min' => $this->getMinDate(), 'max' => $this->getMaxDate() ]) ]); } public function Type() { return 'date text'; } /** * Assign value posted from form submission * * @param mixed $value * @param mixed $data * @return $this */ public function setSubmittedValue($value, $data = null) { // Save raw value for later validation $this->rawValue = $value; // Null case if (!$value) { $this->value = null; return $this; } // Parse from submitted value $this->value = $this->frontendToInternal($value); return $this; } /** * Assign value based on {@link $datetimeFormat}, which might be localised. * * When $html5=true, assign value from ISO 8601 string. * * @param mixed $value * @param mixed $data * @return $this */ public function setValue($value, $data = null) { // Save raw value for later validation $this->rawValue = $value; // Null case if (!$value) { $this->value = null; return $this; } // Re-run through formatter to tidy up (e.g. remove time component) $this->value = $this->tidyInternal($value); return $this; } public function Value() { return $this->internalToFrontend($this->value); } public function performReadonlyTransformation() { $field = $this->castedCopy(DateField_Disabled::class); $field->setValue($this->dataValue()); $field->setReadonly(true); return $field; } /** * @param Validator $validator * @return bool */ public function validate($validator) { // Don't validate empty fields if (empty($this->rawValue)) { return true; } // We submitted a value, but it couldn't be parsed if (empty($this->value)) { $validator->validationError( $this->name, _t( 'DateField.VALIDDATEFORMAT2', "Please enter a valid date format ({format})", ['format' => $this->getDateFormat()] ) ); return false; } // Check min date $min = $this->getMinDate(); if ($min) { $oops = strtotime($this->value) < strtotime($min); if ($oops) { $validator->validationError( $this->name, _t( 'DateField.VALIDDATEMINDATE', "Your date has to be newer or matching the minimum allowed date ({date})", ['date' => $this->internalToFrontend($min)] ) ); return false; } } // Check max date $max = $this->getMaxDate(); if ($max) { $oops = strtotime($this->value) > strtotime($max); if ($oops) { $validator->validationError( $this->name, _t( 'DateField.VALIDDATEMAXDATE', "Your date has to be older or matching the maximum allowed date ({date})", ['date' => $this->internalToFrontend($max)] ) ); return false; } } return true; } /** * Get locale to use for this field * * @return string */ public function getLocale() { return $this->locale ?: i18n::get_locale(); } /** * Determines the presented/processed format based on locale defaults, * instead of explicitly setting {@link setDateFormat()}. * Only applicable with {@link setHTML5(false)}. * * @param string $locale * @return $this */ public function setLocale($locale) { $this->locale = $locale; return $this; } public function getSchemaValidation() { $rules = parent::getSchemaValidation(); $rules['date'] = true; return $rules; } /** * @return string */ public function getMinDate() { return $this->minDate; } /** * @param string $minDate * @return $this */ public function setMinDate($minDate) { $this->minDate = $this->tidyInternal($minDate); return $this; } /** * @return string */ public function getMaxDate() { return $this->maxDate; } /** * @param string $maxDate * @return $this */ public function setMaxDate($maxDate) { $this->maxDate = $this->tidyInternal($maxDate); return $this; } /** * Convert frontend date to the internal representation (ISO 8601). * The frontend date is also in ISO 8601 when $html5=true. * * @param string $date * @return string The formatted date, or null if not a valid date */ protected function frontendToInternal($date) { if (!$date) { return null; } $fromFormatter = $this->getFrontendFormatter(); $toFormatter = $this->getInternalFormatter(); $timestamp = $fromFormatter->parse($date); if ($timestamp === false) { return null; } return $toFormatter->format($timestamp) ?: null; } /** * Convert the internal date representation (ISO 8601) to a format used by the frontend, * as defined by {@link $dateFormat}. With $html5=true, the frontend date will also be * in ISO 8601. * * @param string $date * @return string The formatted date, or null if not a valid date */ protected function internalToFrontend($date) { $date = $this->tidyInternal($date); if (!$date) { return null; } $fromFormatter = $this->getInternalFormatter(); $toFormatter = $this->getFrontendFormatter(); $timestamp = $fromFormatter->parse($date); if ($timestamp === false) { return null; } return $toFormatter->format($timestamp) ?: null; } /** * Tidy up the internal date representation (ISO 8601), * and fall back to strtotime() if there's parsing errors. * * @param string $date Date in ISO 8601 or approximate form * @return string ISO 8601 date, or null if not valid */ protected function tidyInternal($date) { if (!$date) { return null; } // Re-run through formatter to tidy up (e.g. remove time component) $formatter = $this->getInternalFormatter(); $timestamp = $formatter->parse($date); if ($timestamp === false) { // Fallback to strtotime $timestamp = strtotime($date, DBDatetime::now()->getTimestamp()); if ($timestamp === false) { return null; } } return $formatter->format($timestamp); } }