tests/phpunit/includes/GlobalFunctions/wfTimestampTest.php

   1 <?php
   2 /*
   3  * @covers ::wfTimestamp
   4  */
   5 class WfTimestampTest extends MediaWikiTestCase {
   6         /**
   7          * @dataProvider provideNormalTimestamps
   8          */
   9         public function testNormalTimestamps( $input, $format, $output, $desc ) {
  10                 $this->assertEquals( $output, wfTimestamp( $format, $input ), $desc );
  11         }
  12
  13         public static function provideNormalTimestamps() {
  14                 $t = gmmktime( 12, 34, 56, 1, 15, 2001 );
  15
  16                 return array(
  17                         // TS_UNIX
  18                         array( $t, TS_MW, '20010115123456', 'TS_UNIX to TS_MW' ),
  19                         array( -30281104, TS_MW, '19690115123456', 'Negative TS_UNIX to TS_MW' ),
  20                         array( $t, TS_UNIX, 979562096, 'TS_UNIX to TS_UNIX' ),
  21                         array( $t, TS_DB, '2001-01-15 12:34:56', 'TS_UNIX to TS_DB' ),
  22
  23                         array( $t, TS_ISO_8601_BASIC, '20010115T123456Z', 'TS_ISO_8601_BASIC to TS_DB' ),
  24
  25                         // TS_MW
  26                         array( '20010115123456', TS_MW, '20010115123456', 'TS_MW to TS_MW' ),
  27                         array( '20010115123456', TS_UNIX, 979562096, 'TS_MW to TS_UNIX' ),
  28                         array( '20010115123456', TS_DB, '2001-01-15 12:34:56', 'TS_MW to TS_DB' ),
  29                         array( '20010115123456', TS_ISO_8601_BASIC, '20010115T123456Z', 'TS_MW to TS_ISO_8601_BASIC' ),
  30
  31                         // TS_DB
  32                         array( '2001-01-15 12:34:56', TS_MW, '20010115123456', 'TS_DB to TS_MW' ),
  33                         array( '2001-01-15 12:34:56', TS_UNIX, 979562096, 'TS_DB to TS_UNIX' ),
  34                         array( '2001-01-15 12:34:56', TS_DB, '2001-01-15 12:34:56', 'TS_DB to TS_DB' ),
  35                         array(
  36                                 '2001-01-15 12:34:56',
  37                                 TS_ISO_8601_BASIC,
  38                                 '20010115T123456Z',
  39                                 'TS_DB to TS_ISO_8601_BASIC'
  40                         ),
  41
  42                         # rfc2822 section 3.3
  43                         array( '20010115123456', TS_RFC2822, 'Mon, 15 Jan 2001 12:34:56 GMT', 'TS_MW to TS_RFC2822' ),
  44                         array( 'Mon, 15 Jan 2001 12:34:56 GMT', TS_MW, '20010115123456', 'TS_RFC2822 to TS_MW' ),
  45                         array(
  46                                 ' Mon, 15 Jan 2001 12:34:56 GMT',
  47                                 TS_MW,
  48                                 '20010115123456',
  49                                 'TS_RFC2822 with leading space to TS_MW'
  50                         ),
  51                         array(
  52                                 '15 Jan 2001 12:34:56 GMT',
  53                                 TS_MW,
  54                                 '20010115123456',
  55                                 'TS_RFC2822 without optional day-of-week to TS_MW'
  56                         ),
  57
  58                         # FWS = ([*WSP CRLF] 1*WSP) / obs-FWS ; Folding white space
  59                         # obs-FWS = 1*WSP *(CRLF 1*WSP) ; Section 4.2
  60                         array( 'Mon, 15         Jan 2001 12:34:56 GMT', TS_MW, '20010115123456', 'TS_RFC2822 to TS_MW' ),
  61
  62                         # WSP = SP / HTAB ; rfc2234
  63                         array(
  64                                 "Mon, 15 Jan\x092001 12:34:56 GMT",
  65                                 TS_MW,
  66                                 '20010115123456',
  67                                 'TS_RFC2822 with HTAB to TS_MW'
  68                         ),
  69                         array(
  70                                 "Mon, 15 Jan\x09 \x09  2001 12:34:56 GMT",
  71                                 TS_MW,
  72                                 '20010115123456',
  73                                 'TS_RFC2822 with HTAB and SP to TS_MW'
  74                         ),
  75                         array(
  76                                 'Sun, 6 Nov 94 08:49:37 GMT',
  77                                 TS_MW,
  78                                 '19941106084937',
  79                                 'TS_RFC2822 with obsolete year to TS_MW'
  80                         ),
  81                 );
  82         }
  83
  84         /**
  85          * This test checks wfTimestamp() with values outside.
  86          * It needs PHP 64 bits or PHP > 5.1.
  87          * See r74778 and bug 25451
  88          * @dataProvider provideOldTimestamps
  89          */
  90         public function testOldTimestamps( $input, $format, $output, $desc ) {
  91                 $this->assertEquals( $output, wfTimestamp( $format, $input ), $desc );
  92         }
  93
  94         public static function provideOldTimestamps() {
  95                 return array(
  96                         array(
  97                                 '19011213204554',
  98                                 TS_RFC2822,
  99                                 'Fri, 13 Dec 1901 20:45:54 GMT',
 100                                 'Earliest time according to PHP documentation'
 101                         ),
 102                         array( '20380119031407', TS_RFC2822, 'Tue, 19 Jan 2038 03:14:07 GMT', 'Latest 32 bit time' ),
 103                         array( '19011213204552', TS_UNIX, '-2147483648', 'Earliest 32 bit unix time' ),
 104                         array( '20380119031407', TS_UNIX, '2147483647', 'Latest 32 bit unix time' ),
 105                         array( '19011213204552', TS_RFC2822, 'Fri, 13 Dec 1901 20:45:52 GMT', 'Earliest 32 bit time' ),
 106                         array(
 107                                 '19011213204551',
 108                                 TS_RFC2822,
 109                                 'Fri, 13 Dec 1901 20:45:51 GMT', 'Earliest 32 bit time - 1'
 110                         ),
 111                         array( '20380119031408', TS_RFC2822, 'Tue, 19 Jan 2038 03:14:08 GMT', 'Latest 32 bit time + 1' ),
 112                         array( '19011212000000', TS_MW, '19011212000000', 'Convert to itself r74778#c10645' ),
 113                         array( '19011213204551', TS_UNIX, '-2147483649', 'Earliest 32 bit unix time - 1' ),
 114                         array( '20380119031408', TS_UNIX, '2147483648', 'Latest 32 bit unix time + 1' ),
 115                         array( '-2147483649', TS_MW, '19011213204551', '1901 negative unix time to MediaWiki' ),
 116                         array( '-5331871504', TS_MW, '18010115123456', '1801 negative unix time to MediaWiki' ),
 117                         array(
 118                                 '0117-08-09 12:34:56',
 119                                 TS_RFC2822,
 120                                 'Tue, 09 Aug 0117 12:34:56 GMT',
 121                                 'Death of Roman Emperor [[Trajan]]'
 122                         ),
 123
 124                         /* @todo FIXME: 00 to 101 years are taken as being in [1970-2069] */
 125                         array( '-58979923200', TS_RFC2822, 'Sun, 01 Jan 0101 00:00:00 GMT', '1/1/101' ),
 126                         array( '-62135596800', TS_RFC2822, 'Mon, 01 Jan 0001 00:00:00 GMT', 'Year 1' ),
 127
 128                         /* It is not clear if we should generate a year 0 or not
 129                          * We are completely off RFC2822 requirement of year being
 130                          * 1900 or later.
 131                          */
 132                         array(
 133                                 '-62142076800',
 134                                 TS_RFC2822,
 135                                 'Wed, 18 Oct 0000 00:00:00 GMT',
 136                                 'ISO 8601:2004 [[year 0]], also called [[1 BC]]'
 137                         ),
 138                 );
 139         }
 140
 141         /**
 142          * The Resource Loader uses wfTimestamp() to convert timestamps
 143          * from If-Modified-Since header. Thus it must be able to parse all
 144          * rfc2616 date formats
 145          * @see http://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.3.1
 146          * @dataProvider provideHttpDates
 147          */
 148         public function testHttpDate( $input, $output, $desc ) {
 149                 $this->assertEquals( $output, wfTimestamp( TS_MW, $input ), $desc );
 150         }
 151
 152         public static function provideHttpDates() {
 153                 return array(
 154                         array( 'Sun, 06 Nov 1994 08:49:37 GMT', '19941106084937', 'RFC 822 date' ),
 155                         array( 'Sunday, 06-Nov-94 08:49:37 GMT', '19941106084937', 'RFC 850 date' ),
 156                         array( 'Sun Nov  6 08:49:37 1994', '19941106084937', "ANSI C's asctime() format" ),
 157                         // See http://www.squid-cache.org/mail-archive/squid-users/200307/0122.html and r77171
 158                         array(
 159                                 'Mon, 22 Nov 2010 14:12:42 GMT; length=52626',
 160                                 '20101122141242',
 161                                 'Netscape extension to HTTP/1.0'
 162                         ),
 163                 );
 164         }
 165
 166         /**
 167          * There are a number of assumptions in our codebase where wfTimestamp()
 168          * should give the current date but it is not given a 0 there. See r71751 CR
 169          */
 170         public function testTimestampParameter() {
 171                 $now = wfTimestamp( TS_UNIX );
 172                 // We check that wfTimestamp doesn't return false (error) and use a LessThan assert
 173                 // for the cases where the test is run in a second boundary.
 174
 175                 $zero = wfTimestamp( TS_UNIX, 0 );
 176                 $this->assertNotEquals( false, $zero );
 177                 $this->assertLessThan( 5, $zero - $now );
 178
 179                 $empty = wfTimestamp( TS_UNIX, '' );
 180                 $this->assertNotEquals( false, $empty );
 181                 $this->assertLessThan( 5, $empty - $now );
 182
 183                 $null = wfTimestamp( TS_UNIX, null );
 184                 $this->assertNotEquals( false, $null );
 185                 $this->assertLessThan( 5, $null - $now );
 186         }
 187 }