includes/htmlform/fields/HTMLDateTimeField.php

   1 <?php
   2
   3 /**
   4  * A field that will contain a date and/or time
   5  *
   6  * Currently recognizes only {YYYY}-{MM}-{DD}T{HH}:{MM}:{SS.S*}Z formatted dates.
   7  *
   8  * Besides the parameters recognized by HTMLTextField, additional recognized
   9  * parameters in the field descriptor array include:
  10  *  type - 'date', 'time', or 'datetime'
  11  *  min - The minimum date to allow, in any recognized format.
  12  *  max - The maximum date to allow, in any recognized format.
  13  *  placeholder - The default comes from the htmlform-(date|time|datetime)-placeholder message.
  14  *
  15  * The result is a formatted date.
  16  *
  17  * @note This widget is not likely to work well in non-OOUI forms.
  18  */
  19 class HTMLDateTimeField extends HTMLTextField {
  20         protected static $patterns = [
  21                 'date' => '[0-9]{4}-[01][0-9]-[0-3][0-9]',
  22                 'time' => '[0-2][0-9]:[0-5][0-9]:[0-5][0-9](?:\.[0-9]+)?',
  23                 'datetime' => '[0-9]{4}-[01][0-9]-[0-3][0-9][T ][0-2][0-9]:[0-5][0-9]:[0-5][0-9](?:\.[0-9]+)?Z?',
  24         ];
  25
  26         protected $mType = 'datetime';
  27
  28         public function __construct( $params ) {
  29                 parent::__construct( $params );
  30
  31                 $this->mType = array_key_exists( 'type', $params )
  32                         ? $params['type']
  33                         : 'datetime';
  34
  35                 if ( !in_array( $this->mType, [ 'date', 'time', 'datetime' ] ) ) {
  36                         throw new InvalidArgumentException( "Invalid type '$this->mType'" );
  37                 }
  38
  39                 if ( $this->mPlaceholder === '' ) {
  40                         // Messages: htmlform-date-placeholder htmlform-time-placeholder htmlform-datetime-placeholder
  41                         $this->mPlaceholder = $this->msg( "htmlform-{$this->mType}-placeholder" )->text();
  42                 }
  43
  44                 $this->mClass .= ' mw-htmlform-datetime-field';
  45         }
  46
  47         public function getAttributes( array $list ) {
  48                 $parentList = array_diff( $list, [ 'min', 'max' ] );
  49                 $ret = parent::getAttributes( $parentList );
  50
  51                 if ( in_array( 'min', $list ) && isset( $this->mParams['min'] ) ) {
  52                         $min = $this->parseDate( $this->mParams['min'] );
  53                         if ( $min ) {
  54                                 $ret['min'] = $this->formatDate( $min );
  55                         }
  56                 }
  57                 if ( in_array( 'max', $list ) && isset( $this->mParams['max'] ) ) {
  58                         $max = $this->parseDate( $this->mParams['max'] );
  59                         if ( $max ) {
  60                                 $ret['max'] = $this->formatDate( $max );
  61                         }
  62                 }
  63
  64                 $ret['step'] = 1;
  65
  66                 $ret['type'] = $this->mType;
  67                 $ret['pattern'] = static::$patterns[$this->mType];
  68
  69                 return $ret;
  70         }
  71
  72         public function loadDataFromRequest( $request ) {
  73                 if ( !$request->getCheck( $this->mName ) ) {
  74                         return $this->getDefault();
  75                 }
  76
  77                 $value = $request->getText( $this->mName );
  78                 $date = $this->parseDate( $value );
  79                 return $date ? $this->formatDate( $date ) : $value;
  80         }
  81
  82         public function validate( $value, $alldata ) {
  83                 $p = parent::validate( $value, $alldata );
  84
  85                 if ( $p !== true ) {
  86                         return $p;
  87                 }
  88
  89                 if ( $value === '' ) {
  90                         // required was already checked by parent::validate
  91                         return true;
  92                 }
  93
  94                 $date = $this->parseDate( $value );
  95                 if ( !$date ) {
  96                         // Messages: htmlform-date-invalid htmlform-time-invalid htmlform-datetime-invalid
  97                         return $this->msg( "htmlform-{$this->mType}-invalid" );
  98                 }
  99
 100                 if ( isset( $this->mParams['min'] ) ) {
 101                         $min = $this->parseDate( $this->mParams['min'] );
 102                         if ( $min && $date < $min ) {
 103                                 // Messages: htmlform-date-toolow htmlform-time-toolow htmlform-datetime-toolow
 104                                 return $this->msg( "htmlform-{$this->mType}-toolow", $this->formatDate( $min ) );
 105                         }
 106                 }
 107
 108                 if ( isset( $this->mParams['max'] ) ) {
 109                         $max = $this->parseDate( $this->mParams['max'] );
 110                         if ( $max && $date > $max ) {
 111                                 // Messages: htmlform-date-toohigh htmlform-time-toohigh htmlform-datetime-toohigh
 112                                 return $this->msg( "htmlform-{$this->mType}-toohigh", $this->formatDate( $max ) );
 113                         }
 114                 }
 115
 116                 return true;
 117         }
 118
 119         protected function parseDate( $value ) {
 120                 $value = trim( $value );
 121                 if ( $value === '' ) {
 122                         return false;
 123                 }
 124
 125                 if ( $this->mType === 'date' ) {
 126                         $value .= ' T00:00:00+0000';
 127                 }
 128                 if ( $this->mType === 'time' ) {
 129                         $value = '1970-01-01 ' . $value . '+0000';
 130                 }
 131
 132                 try {
 133                         $date = new DateTime( $value, new DateTimeZone( 'GMT' ) );
 134                         return $date->getTimestamp();
 135                 } catch ( Exception $ex ) {
 136                         return false;
 137                 }
 138         }
 139
 140         protected function formatDate( $value ) {
 141                 switch ( $this->mType ) {
 142                         case 'date':
 143                                 return gmdate( 'Y-m-d', $value );
 144
 145                         case 'time':
 146                                 return gmdate( 'H:i:s', $value );
 147
 148                         case 'datetime':
 149                                 return gmdate( 'Y-m-d\\TH:i:s\\Z', $value );
 150                 }
 151         }
 152
 153         public function getInputOOUI( $value ) {
 154                 $params = [
 155                         'type' => $this->mType,
 156                         'value' => $value,
 157                         'name' => $this->mName,
 158                         'id' => $this->mID,
 159                 ];
 160
 161                 if ( isset( $this->mParams['min'] ) ) {
 162                         $min = $this->parseDate( $this->mParams['min'] );
 163                         if ( $min ) {
 164                                 $params['min'] = $this->formatDate( $min );
 165                         }
 166                 }
 167                 if ( isset( $this->mParams['max'] ) ) {
 168                         $max = $this->parseDate( $this->mParams['max'] );
 169                         if ( $max ) {
 170                                 $params['max'] = $this->formatDate( $max );
 171                         }
 172                 }
 173
 174                 return new MediaWiki\Widget\DateTimeInputWidget( $params );
 175         }
 176
 177         protected function getOOUIModules() {
 178                 return [ 'mediawiki.widgets.datetime' ];
 179         }
 180
 181         protected function shouldInfuseOOUI() {
 182                 return true;
 183         }
 184
 185 }