4 * Date formatter, recognises dates in plain text and formats them accoding to user preferences.
5 * @todo preferences, OutputPage
10 var $mSource, $mTarget;
11 var $monthNames = '', $rxDM, $rxMD, $rxDMY, $rxYDM, $rxMDY, $rxYMD;
13 var $regexes, $pDays, $pMonths, $pYears;
14 var $rules, $xMonths, $preferences;
32 function DateFormatter() {
35 $this->monthNames
= $this->getMonthRegex();
36 for ( $i=1; $i<=12; $i++
) {
37 $this->xMonths
[$wgContLang->lc( $wgContLang->getMonthName( $i ) )] = $i;
38 $this->xMonths
[$wgContLang->lc( $wgContLang->getMonthAbbreviation( $i ) )] = $i;
41 $this->regexTrail
= '(?![a-z])/iu';
43 # Partial regular expressions
44 $this->prxDM
= '\[\[(\d{1,2})[ _](' . $this->monthNames
. ')\]\]';
45 $this->prxMD
= '\[\[(' . $this->monthNames
. ')[ _](\d{1,2})\]\]';
46 $this->prxY
= '\[\[(\d{1,4}([ _]BC|))\]\]';
47 $this->prxISO1
= '\[\[(-?\d{4})]]-\[\[(\d{2})-(\d{2})\]\]';
48 $this->prxISO2
= '\[\[(-?\d{4})-(\d{2})-(\d{2})\]\]';
50 # Real regular expressions
51 $this->regexes
[self
::DMY
] = "/{$this->prxDM}(?: *, *| +){$this->prxY}{$this->regexTrail}";
52 $this->regexes
[self
::YDM
] = "/{$this->prxY}(?: *, *| +){$this->prxDM}{$this->regexTrail}";
53 $this->regexes
[self
::MDY
] = "/{$this->prxMD}(?: *, *| +){$this->prxY}{$this->regexTrail}";
54 $this->regexes
[self
::YMD
] = "/{$this->prxY}(?: *, *| +){$this->prxMD}{$this->regexTrail}";
55 $this->regexes
[self
::DM
] = "/{$this->prxDM}{$this->regexTrail}";
56 $this->regexes
[self
::MD
] = "/{$this->prxMD}{$this->regexTrail}";
57 $this->regexes
[self
::ISO1
] = "/{$this->prxISO1}{$this->regexTrail}";
58 $this->regexes
[self
::ISO2
] = "/{$this->prxISO2}{$this->regexTrail}";
61 # See the comments in replace() for the meaning of the letters
62 $this->keys
[self
::DMY
] = 'jFY';
63 $this->keys
[self
::YDM
] = 'Y jF';
64 $this->keys
[self
::MDY
] = 'FjY';
65 $this->keys
[self
::YMD
] = 'Y Fj';
66 $this->keys
[self
::DM
] = 'jF';
67 $this->keys
[self
::MD
] = 'Fj';
68 $this->keys
[self
::ISO1
] = 'ymd'; # y means ISO year
69 $this->keys
[self
::ISO2
] = 'ymd';
72 $this->targets
[self
::DMY
] = '[[F j|j F]] [[Y]]';
73 $this->targets
[self
::YDM
] = '[[Y]], [[F j|j F]]';
74 $this->targets
[self
::MDY
] = '[[F j]], [[Y]]';
75 $this->targets
[self
::YMD
] = '[[Y]] [[F j]]';
76 $this->targets
[self
::DM
] = '[[F j|j F]]';
77 $this->targets
[self
::MD
] = '[[F j]]';
78 $this->targets
[self
::ISO1
] = '[[Y|y]]-[[F j|m-d]]';
79 $this->targets
[self
::ISO2
] = '[[y-m-d]]';
83 $this->rules
[self
::DMY
][self
::MD
] = self
::DM
;
84 $this->rules
[self
::ALL
][self
::MD
] = self
::MD
;
85 $this->rules
[self
::MDY
][self
::DM
] = self
::MD
;
86 $this->rules
[self
::ALL
][self
::DM
] = self
::DM
;
87 $this->rules
[self
::NONE
][self
::ISO2
] = self
::ISO1
;
89 $this->preferences
= array(
90 'default' => self
::NONE
,
94 'ISO 8601' => self
::ISO1
,
99 * Get a DateFormatter object
101 * @return DateFormatter object
103 public static function &getInstance() {
105 static $dateFormatter = false;
106 if ( !$dateFormatter ) {
107 $dateFormatter = $wgMemc->get( wfMemcKey( 'dateformatter' ) );
108 if ( !$dateFormatter ) {
109 $dateFormatter = new DateFormatter
;
110 $wgMemc->set( wfMemcKey( 'dateformatter' ), $dateFormatter, 3600 );
113 return $dateFormatter;
117 * @param $preference String: User preference
118 * @param $text String: Text to reformat
119 * @param $options Array: can contain 'linked' and/or 'match-whole'
121 function reformat( $preference, $text, $options = array('linked') ) {
123 $linked = in_array( 'linked', $options );
124 $match_whole = in_array( 'match-whole', $options );
126 if ( isset( $this->preferences
[$preference] ) ) {
127 $preference = $this->preferences
[$preference];
129 $preference = self
::NONE
;
131 for ( $i=1; $i<=self
::LAST
; $i++
) {
133 if ( isset ( $this->rules
[$preference][$i] ) ) {
135 $this->mTarget
= $this->rules
[$preference][$i];
136 } elseif ( isset ( $this->rules
[self
::ALL
][$i] ) ) {
138 $this->mTarget
= $this->rules
[self
::ALL
][$i];
139 } elseif ( $preference ) {
141 $this->mTarget
= $preference;
146 $regex = $this->regexes
[$i];
150 $regex = str_replace( array( '\[\[', '\]\]' ), '', $regex );
154 // Let's hope this works
155 $regex = preg_replace( '!^/!', '/^', $regex );
156 $regex = str_replace( $this->regexTrail
,
157 '$'.$this->regexTrail
, $regex );
160 // Another horrible hack
161 $this->mLinked
= $linked;
162 $text = preg_replace_callback( $regex, array( &$this, 'replace' ), $text );
163 unset($this->mLinked
);
171 function replace( $matches ) {
172 # Extract information from $matches
174 if ( isset( $this->mLinked
) )
175 $linked = $this->mLinked
;
178 $key = $this->keys
[$this->mSource
];
179 for ( $p=0; $p < strlen($key); $p++
) {
180 if ( $key{$p} != ' ' ) {
181 $bits[$key{$p}] = $matches[$p+
1];
185 return $this->formatDate( $bits, $linked );
188 function formatDate( $bits, $link = true ) {
189 $format = $this->targets
[$this->mTarget
];
193 $format = preg_replace( '/\[\[[^|]+\|([^\]]+)\]\]/', '$1', $format );
194 // strip remaining links
195 $format = str_replace( array( '[[', ']]' ), '', $format );
202 // Pre-generate y/Y stuff because we need the year for the <span> title.
203 if ( !isset( $bits['y'] ) && isset( $bits['Y'] ) )
204 $bits['y'] = $this->makeIsoYear( $bits['Y'] );
205 if ( !isset( $bits['Y'] ) && isset( $bits['y'] ) )
206 $bits['Y'] = $this->makeNormalYear( $bits['y'] );
208 if ( !isset( $bits['m'] ) ) {
209 $m = $this->makeIsoMonth( $bits['F'] );
210 if ( !$m ||
$m == '00' ) {
217 if ( !isset($bits['d']) ) {
218 $bits['d'] = sprintf( '%02d', $bits['j'] );
221 for ( $p=0; $p < strlen( $format ); $p++
) {
224 case 'd': # ISO day of month
227 case 'm': # ISO month
233 case 'j': # ordinary day of month
234 if ( !isset($bits['j']) ) {
235 $text .= intval( $bits['d'] );
240 case 'F': # long month
241 if ( !isset( $bits['F'] ) ) {
242 $m = intval($bits['m']);
243 if ( $m > 12 ||
$m < 1 ) {
247 $text .= $wgContLang->getMonthName( $m );
250 $text .= ucfirst( $bits['F'] );
253 case 'Y': # ordinary (optional BC) year
265 if ( isset($bits['y']) )
266 $isoBits[] = $bits['y'];
267 $isoBits[] = $bits['m'];
268 $isoBits[] = $bits['d'];
269 $isoDate = implode( '-', $isoBits );;
271 // Output is not strictly HTML (it's wikitext), but <span> is whitelisted.
272 $text = Html
::rawElement( 'span',
273 array( 'class' => 'mw-formatted-date', 'title' => $isoDate ), $text );
281 function getMonthRegex() {
284 for( $i = 1; $i <= 12; $i++
) {
285 $names[] = $wgContLang->getMonthName( $i );
286 $names[] = $wgContLang->getMonthAbbreviation( $i );
288 return implode( '|', $names );
292 * Makes an ISO month, e.g. 02, from a month name
293 * @param $monthName String: month name
294 * @return string ISO month name
296 function makeIsoMonth( $monthName ) {
299 $n = $this->xMonths
[$wgContLang->lc( $monthName )];
300 return sprintf( '%02d', $n );
305 * @param $year String: Year name
306 * @return string ISO year name
308 function makeIsoYear( $year ) {
309 # Assumes the year is in a nice format, as enforced by the regex
310 if ( substr( $year, -2 ) == 'BC' ) {
311 $num = intval(substr( $year, 0, -3 )) - 1;
312 # PHP bug note: sprintf( "%04d", -1 ) fails poorly
313 $text = sprintf( '-%04d', $num );
316 $text = sprintf( '%04d', $year );
324 function makeNormalYear( $iso ) {
325 if ( $iso{0} == '-' ) {
326 $text = (intval( substr( $iso, 1 ) ) +
1) . ' BC';
328 $text = intval( $iso );