3 ADOdb Date Library, part of the ADOdb abstraction library
4 Download: http://phplens.com/phpeverywhere/
6 PHP native date functions use integer timestamps for computations.
7 Because of this, dates are restricted to the years 1901-2038 on Unix
8 and 1970-2038 on Windows due to integer overflow for dates beyond
9 those years. This library overcomes these limitations by replacing the
10 native function's signed integers (normally 32-bits) with PHP floating
11 point numbers (normally 64-bits).
13 Dates from 100 A.D. to 3000 A.D. and later
14 have been tested. The minimum is 100 A.D. as <100 will invoke the
15 2 => 4 digit year conversion. The maximum is billions of years in the
16 future, but this is a theoretical limit as the computation of that year
17 would take too long with the current implementation of adodb_mktime().
19 This library replaces native functions as follows:
22 getdate() with adodb_getdate()
23 date() with adodb_date()
24 gmdate() with adodb_gmdate()
25 mktime() with adodb_mktime()
26 gmmktime() with adodb_gmmktime()
27 strftime() with adodb_strftime()
28 strftime() with adodb_gmstrftime()
31 The parameters are identical, except that adodb_date() accepts a subset
32 of date()'s field formats. Mktime() will convert from local time to GMT,
33 and date() will convert from GMT to local time, but daylight savings is
34 not handled currently.
36 This library is independant of the rest of ADOdb, and can be used
41 For high speed, this library uses the native date functions where
42 possible, and only switches to PHP code when the dates fall outside
43 the 32-bit signed integer range.
47 Pope Gregory shortened October of A.D. 1582 by ten days. Thursday,
48 October 4, 1582 (Julian) was followed immediately by Friday, October 15,
51 Since 0.06, we handle this correctly, so:
53 adodb_mktime(0,0,0,10,15,1582) - adodb_mktime(0,0,0,10,4,1582)
56 =============================================================================
60 (c) 2003-2005 John Lim and released under BSD-style license except for code by
61 jackbbs, which includes adodb_mktime, adodb_get_gmt_diff, adodb_is_leap_year
62 and originally found at http://www.php.net/manual/en/function.mktime.php
64 =============================================================================
68 These should be posted to the ADOdb forums at
70 http://phplens.com/lens/lensforum/topics.php?id=4
72 =============================================================================
77 ** FUNCTION adodb_getdate($date=false)
79 Returns an array containing date information, as getdate(), but supports
80 dates greater than 1901 to 2038. The local date/time format is derived from a
81 heuristic the first time adodb_getdate is called.
84 ** FUNCTION adodb_date($fmt, $timestamp = false)
86 Convert a timestamp to a formatted local date. If $timestamp is not defined, the
87 current timestamp is used. Unlike the function date(), it supports dates
88 outside the 1901 to 2038 range.
90 The format fields that adodb_date supports:
95 d - day of the month, 2 digits with leading zeros; i.e. "01" to "31"
96 D - day of the week, textual, 3 letters; e.g. "Fri"
97 F - month, textual, long; e.g. "January"
98 g - hour, 12-hour format without leading zeros; i.e. "1" to "12"
99 G - hour, 24-hour format without leading zeros; i.e. "0" to "23"
100 h - hour, 12-hour format; i.e. "01" to "12"
101 H - hour, 24-hour format; i.e. "00" to "23"
102 i - minutes; i.e. "00" to "59"
103 j - day of the month without leading zeros; i.e. "1" to "31"
104 l (lowercase 'L') - day of the week, textual, long; e.g. "Friday"
105 L - boolean for whether it is a leap year; i.e. "0" or "1"
106 m - month; i.e. "01" to "12"
107 M - month, textual, 3 letters; e.g. "Jan"
108 n - month without leading zeros; i.e. "1" to "12"
109 O - Difference to Greenwich time in hours; e.g. "+0200"
110 Q - Quarter, as in 1, 2, 3, 4
111 r - RFC 2822 formatted date; e.g. "Thu, 21 Dec 2000 16:01:07 +0200"
112 s - seconds; i.e. "00" to "59"
113 S - English ordinal suffix for the day of the month, 2 characters;
114 i.e. "st", "nd", "rd" or "th"
115 t - number of days in the given month; i.e. "28" to "31"
116 T - Timezone setting of this machine; e.g. "EST" or "MDT"
117 U - seconds since the Unix Epoch (January 1 1970 00:00:00 GMT)
118 w - day of the week, numeric, i.e. "0" (Sunday) to "6" (Saturday)
119 Y - year, 4 digits; e.g. "1999"
120 y - year, 2 digits; e.g. "99"
121 z - day of the year; i.e. "0" to "365"
122 Z - timezone offset in seconds (i.e. "-43200" to "43200").
123 The offset for timezones west of UTC is always negative,
124 and for those east of UTC is always positive.
129 B - Swatch Internet time
130 I (capital i) - "1" if Daylight Savings Time, "0" otherwise.
131 W - ISO-8601 week number of year, weeks starting on Monday
136 ** FUNCTION adodb_date2($fmt, $isoDateString = false)
137 Same as adodb_date, but 2nd parameter accepts iso date, eg.
139 adodb_date2('d-M-Y H:i','2003-12-25 13:01:34');
142 ** FUNCTION adodb_gmdate($fmt, $timestamp = false)
144 Convert a timestamp to a formatted GMT date. If $timestamp is not defined, the
145 current timestamp is used. Unlike the function date(), it supports dates
146 outside the 1901 to 2038 range.
149 ** FUNCTION adodb_mktime($hr, $min, $sec[, $month, $day, $year])
151 Converts a local date to a unix timestamp. Unlike the function mktime(), it supports
152 dates outside the 1901 to 2038 range. All parameters are optional.
155 ** FUNCTION adodb_gmmktime($hr, $min, $sec [, $month, $day, $year])
157 Converts a gmt date to a unix timestamp. Unlike the function gmmktime(), it supports
158 dates outside the 1901 to 2038 range. Differs from gmmktime() in that all parameters
159 are currently compulsory.
161 ** FUNCTION adodb_gmstrftime($fmt, $timestamp = false)
162 Convert a timestamp to a formatted GMT date.
164 ** FUNCTION adodb_strftime($fmt, $timestamp = false)
166 Convert a timestamp to a formatted local date. Internally converts $fmt into
167 adodb_date format, then echo result.
169 For best results, you can define the local date format yourself. Define a global
170 variable $ADODB_DATE_LOCALE which is an array, 1st element is date format using
171 adodb_date syntax, and 2nd element is the time format, also in adodb_date syntax.
173 eg. $ADODB_DATE_LOCALE = array('d/m/Y','H:i:s');
175 Supported format codes:
178 %a - abbreviated weekday name according to the current locale
179 %A - full weekday name according to the current locale
180 %b - abbreviated month name according to the current locale
181 %B - full month name according to the current locale
182 %c - preferred date and time representation for the current locale
183 %d - day of the month as a decimal number (range 01 to 31)
184 %D - same as %m/%d/%y
185 %e - day of the month as a decimal number, a single digit is preceded by a space (range ' 1' to '31')
187 %H - hour as a decimal number using a 24-hour clock (range 00 to 23)
188 %I - hour as a decimal number using a 12-hour clock (range 01 to 12)
189 %m - month as a decimal number (range 01 to 12)
190 %M - minute as a decimal number
191 %n - newline character
192 %p - either `am' or `pm' according to the given time value, or the corresponding strings for the current locale
193 %r - time in a.m. and p.m. notation
194 %R - time in 24 hour notation
195 %S - second as a decimal number
197 %T - current time, equal to %H:%M:%S
198 %x - preferred date representation for the current locale without the time
199 %X - preferred time representation for the current locale without the date
200 %y - year as a decimal number without a century (range 00 to 99)
201 %Y - year as a decimal number including the century
202 %Z - time zone or name or abbreviation
203 %% - a literal `%' character
208 %C - century number (the year divided by 100 and truncated to an integer, range 00 to 99)
209 %g - like %G, but without the century.
210 %G - The 4-digit year corresponding to the ISO week number (see %V).
211 This has the same format and value as %Y, except that if the ISO week number belongs
212 to the previous or next year, that year is used instead.
213 %j - day of the year as a decimal number (range 001 to 366)
214 %u - weekday as a decimal number [1,7], with 1 representing Monday
215 %U - week number of the current year as a decimal number, starting
216 with the first Sunday as the first day of the first week
217 %V - The ISO 8601:1988 week number of the current year as a decimal number,
218 range 01 to 53, where week 1 is the first week that has at least 4 days in the
219 current year, and with Monday as the first day of the week. (Use %G or %g for
220 the year component that corresponds to the week number for the specified timestamp.)
221 %w - day of the week as a decimal, Sunday being 0
222 %W - week number of the current year as a decimal number, starting with the
223 first Monday as the first day of the first week
226 =============================================================================
230 Useful url for generating test timestamps:
231 http://www.4webhelp.net/us/timestamp.php
233 Possible future optimizations include
235 a. Using an algorithm similar to Plauger's in "The Standard C Library"
236 (page 428, xttotm.c _Ttotm() function). Plauger's algorithm will not
237 work outside 32-bit signed range, so i decided not to implement it.
239 b. Implement daylight savings, which looks awfully complicated, see
240 http://webexhibits.org/daylightsaving/
245 Changed strftime() locale detection, because some locales prepend the day of week to the date when %c is used.
248 PHP5 compat: when we detect PHP5, the RFC2822 format for gmt 0000hrs is changed from -0000 to +0000.
249 In PHP4, we will still use -0000 for 100% compat with PHP4.
252 In adodb_date2(), $is_gmt not supported properly. Fixed.
255 In PHP 4.3.11, the 'r' format has changed. Leading 0 in day is added. Changed for compat.
256 Added support for negative months in adodb_mktime().
259 Added limited strftime/gmstrftime support. x10 improvement in performance of adodb_date().
262 In adodb_getdate(), the timestamp was accidentally converted to gmt when $is_gmt is false.
263 Also adodb_mktime(0,0,0) did not work properly. Both fixed thx Mauro.
266 Removed intval typecast in adodb_mktime() for secs, allowing:
267 adodb_mktime(0,0,0 + 2236672153,1,1,1934);
271 All params in adodb_mktime were formerly compulsory. Now only the hour, min, secs is compulsory.
272 This brings it more in line with mktime (still not identical).
276 Allow you to define your own daylights savings function, adodb_daylight_sv.
277 If the function is defined (somewhere in an include), then you can correct for daylights savings.
279 In this example, we apply daylights savings in June or July, adding one hour. This is extremely
280 unrealistic as it does not take into account time-zone, geographic location, current year.
282 function adodb_daylight_sv(&$arr, $is_gmt)
286 if ($m == 6 || $m == 7) $arr['hours'] += 1;
289 This is only called by adodb_date() and not by adodb_mktime().
291 The format of $arr is
296 [mday] => 1 # day of month, eg 1st day of the month
297 [mon] => 2 # month (eg. Feb)
299 [yday] => 31 # days in current year
300 [leap] => # true if leap year
301 [ndays] => 28 # no of days in current month
306 Fixed adodb_date to properly support $is_gmt. Thx to Dimitar Angelov.
309 Fixed month calculation error in adodb_date. 2102-June-01 appeared as 2102-May-32.
312 Because of daylight savings problems (some systems apply daylight savings to
313 January!!!), changed adodb_get_gmt_diff() to ignore daylight savings.
316 Fixed bug with dates after 2038.
317 See http://phplens.com/lens/lensforum/msgs.php?id=6980
320 Added support for Q (Quarter).
321 Added adodb_date2(), which accepts ISO date in 2nd param
324 Added support for 'S' adodb_date() format char. Added constant ADODB_ALLOW_NEGATIVE_TS
325 if you want PHP to handle negative timestamps between 1901 to 1969.
328 All negative numbers handled by adodb now because of RH 7.3+ problems.
329 See http://bugs.php.net/bug.php?id=20048&edit=2
332 Fixed a typo, 1852 changed to 1582! This means that pre-1852 dates
333 are now correctly handled.
337 Leap year checking differs under Julian calendar (pre 1582). Also
338 leap year code optimized by checking for most common case first.
340 We also handle month overflow correctly in mktime (eg month set to 13).
342 Day overflow for less than one month's days is supported.
346 Gregorian correction handled. In PHP5, we might throw an error if
347 mktime uses invalid dates around 5-14 Oct 1582. Released with ADOdb 3.10.
348 Added limbo 5-14 Oct 1582 check, when we set to 15 Oct 1582.
352 Fixed some more month problems due to gmt issues. Added constant ADODB_DATE_VERSION.
353 Fixed calculation of days since start of year for <1970.
357 Changed _adodb_getdate() to inline leap year checking for better performance.
358 Fixed problem with time-zones west of GMT +0000.
362 First implementation.
371 define('ADODB_DATE_VERSION',0.24);
374 This code was originally for windows. But apparently this problem happens
375 also with Linux, RH 7.3 and later!
377 glibc-2.2.5-34 and greater has been changed to return -1 for dates <
378 1970. This used to work. The problem exists with RedHat 7.3 and 8.0
379 echo (mktime(0, 0, 0, 1, 1, 1960)); // prints -1
382 http://bugs.php.net/bug.php?id=20048&edit=2
383 http://lists.debian.org/debian-glibc/2002/debian-glibc-200205/msg00010.html
386 if (!defined('ADODB_ALLOW_NEGATIVE_TS')) define('ADODB_NO_NEGATIVE_TS',1);
388 function adodb_date_test_date($y1,$m,$d=13)
390 $t = adodb_mktime(0,0,0,$m,$d,$y1);
391 $rez = adodb_date('Y-n-j H:i:s',$t);
392 if ("$y1-$m-$d 00:00:00" != $rez) {
393 print "<b>$y1 error, expected=$y1-$m-$d 00:00:00, adodb=$rez</b><br>";
399 function adodb_date_test_strftime($fmt)
401 $s1 = strftime($fmt);
402 $s2 = adodb_strftime($fmt);
404 if ($s1 == $s2) return true;
406 echo "error for $fmt, strftime=$s1, $adodb=$s2<br>";
413 function adodb_date_test()
416 error_reporting(E_ALL
);
417 print "<h4>Testing adodb_date and adodb_mktime. version=".ADODB_DATE_VERSION
.' PHP='.PHP_VERSION
."</h4>";
421 // This flag disables calling of PHP native functions, so we can properly test the code
422 if (!defined('ADODB_TEST_DATES')) define('ADODB_TEST_DATES',1);
424 adodb_date_test_strftime('%Y %m %x %X');
425 adodb_date_test_strftime("%A %d %B %Y");
426 adodb_date_test_strftime("%H %M S");
428 $t = adodb_mktime(0,0,0);
429 if (!(adodb_date('Y-m-d') == date('Y-m-d'))) print 'Error in '.adodb_mktime(0,0,0).'<br>';
431 $t = adodb_mktime(0,0,0,6,1,2102);
432 if (!(adodb_date('Y-m-d',$t) == '2102-06-01')) print 'Error in '.adodb_date('Y-m-d',$t).'<br>';
434 $t = adodb_mktime(0,0,0,2,1,2102);
435 if (!(adodb_date('Y-m-d',$t) == '2102-02-01')) print 'Error in '.adodb_date('Y-m-d',$t).'<br>';
438 print "<p>Testing gregorian <=> julian conversion<p>";
439 $t = adodb_mktime(0,0,0,10,11,1492);
440 //http://www.holidayorigins.com/html/columbus_day.html - Friday check
441 if (!(adodb_date('D Y-m-d',$t) == 'Fri 1492-10-11')) print 'Error in Columbus landing<br>';
443 $t = adodb_mktime(0,0,0,2,29,1500);
444 if (!(adodb_date('Y-m-d',$t) == '1500-02-29')) print 'Error in julian leap years<br>';
446 $t = adodb_mktime(0,0,0,2,29,1700);
447 if (!(adodb_date('Y-m-d',$t) == '1700-03-01')) print 'Error in gregorian leap years<br>';
449 print adodb_mktime(0,0,0,10,4,1582).' ';
450 print adodb_mktime(0,0,0,10,15,1582);
451 $diff = (adodb_mktime(0,0,0,10,15,1582) - adodb_mktime(0,0,0,10,4,1582));
452 if ($diff != 3600*24) print " <b>Error in gregorian correction = ".($diff/3600/24)." days </b><br>";
454 print " 15 Oct 1582, Fri=".(adodb_dow(1582,10,15) == 5 ?
'Fri' : '<b>Error</b>')."<br>";
455 print " 4 Oct 1582, Thu=".(adodb_dow(1582,10,4) == 4 ?
'Thu' : '<b>Error</b>')."<br>";
457 print "<p>Testing overflow<p>";
459 $t = adodb_mktime(0,0,0,3,33,1965);
460 if (!(adodb_date('Y-m-d',$t) == '1965-04-02')) print 'Error in day overflow 1 <br>';
461 $t = adodb_mktime(0,0,0,4,33,1971);
462 if (!(adodb_date('Y-m-d',$t) == '1971-05-03')) print 'Error in day overflow 2 <br>';
463 $t = adodb_mktime(0,0,0,1,60,1965);
464 if (!(adodb_date('Y-m-d',$t) == '1965-03-01')) print 'Error in day overflow 3 '.adodb_date('Y-m-d',$t).' <br>';
465 $t = adodb_mktime(0,0,0,12,32,1965);
466 if (!(adodb_date('Y-m-d',$t) == '1966-01-01')) print 'Error in day overflow 4 '.adodb_date('Y-m-d',$t).' <br>';
467 $t = adodb_mktime(0,0,0,12,63,1965);
468 if (!(adodb_date('Y-m-d',$t) == '1966-02-01')) print 'Error in day overflow 5 '.adodb_date('Y-m-d',$t).' <br>';
469 $t = adodb_mktime(0,0,0,13,3,1965);
470 if (!(adodb_date('Y-m-d',$t) == '1966-01-03')) print 'Error in mth overflow 1 <br>';
472 print "Testing 2-digit => 4-digit year conversion<p>";
473 if (adodb_year_digit_check(00) != 2000) print "Err 2-digit 2000<br>";
474 if (adodb_year_digit_check(10) != 2010) print "Err 2-digit 2010<br>";
475 if (adodb_year_digit_check(20) != 2020) print "Err 2-digit 2020<br>";
476 if (adodb_year_digit_check(30) != 2030) print "Err 2-digit 2030<br>";
477 if (adodb_year_digit_check(40) != 1940) print "Err 2-digit 1940<br>";
478 if (adodb_year_digit_check(50) != 1950) print "Err 2-digit 1950<br>";
479 if (adodb_year_digit_check(90) != 1990) print "Err 2-digit 1990<br>";
481 // Test string formating
482 print "<p>Testing date formating</p>";
483 $fmt = '\d\a\t\e T Y-m-d H:i:s a A d D F g G h H i j l L m M n O \R\F\C2822 r s t U w y Y z Z 2003';
485 $s2 = adodb_date($fmt,0);
487 print " date() 0 failed<br>$s1<br>$s2<br>";
490 for ($i=100; --$i > 0; ) {
492 $ts = 3600.0*((rand()%60000
)+
(rand()%60000
))+
(rand()%60000
);
493 $s1 = date($fmt,$ts);
494 $s2 = adodb_date($fmt,$ts);
495 //print "$s1 <br>$s2 <p>";
496 $pos = strcmp($s1,$s2);
498 if (($s1) != ($s2)) {
499 for ($j=0,$k=strlen($s1); $j < $k; $j++
) {
500 if ($s1[$j] != $s2[$j]) {
501 print substr($s1,$j).' ';
505 print "<b>Error date(): $ts<br><pre>
506 \"$s1\" (date len=".strlen($s1).")
507 \"$s2\" (adodb_date len=".strlen($s2).")</b></pre><br>";
512 $a2 = adodb_getdate($ts);
513 $rez = array_diff($a1,$a2);
514 if (sizeof($rez)>0) {
515 print "<b>Error getdate() $ts</b><br>";
524 // Test generation of dates outside 1901-2038
525 print "<p>Testing random dates between 100 and 4000</p>";
526 adodb_date_test_date(100,1);
527 for ($i=100; --$i >= 0;) {
528 $y1 = 100+
rand(0,1970-100);
530 adodb_date_test_date($y1,$m);
532 $y1 = 3000-rand(0,3000-1970);
533 adodb_date_test_date($y1,$m);
536 $start = 1960+
rand(0,10);
538 $i = 365.25*86400*($start-1970);
539 $offset = 36000+
rand(10000,60000);
540 $max = 365*$yrs*86400;
543 // we generate a timestamp, convert it to a date, and convert it back to a timestamp
544 // and check if the roundtrip broke the original timestamp value.
545 print "Testing $start to ".($start+
$yrs).", or $max seconds, offset=$offset: ";
547 for ($max +
= $i; $i < $max; $i +
= $offset) {
548 $ret = adodb_date('m,d,Y,H,i,s',$i);
549 $arr = explode(',',$ret);
550 if ($lastyear != $arr[2]) {
555 $newi = adodb_mktime($arr[3],$arr[4],$arr[5],$arr[0],$arr[1],$arr[2]);
557 print "Error at $i, adodb_mktime returned $newi ($ret)";
563 echo "Tested $cnt dates<br>";
564 if (!$fail) print "<p>Passed !</p>";
565 else print "<p><b>Failed</b> :-(</p>";
569 Returns day of week, 0 = Sunday,... 6=Saturday.
570 Algorithm from PEAR::Date_Calc
572 function adodb_dow($year, $month, $day)
575 Pope Gregory removed 10 days - October 5 to October 14 - from the year 1582 and
576 proclaimed that from that time onwards 3 days would be dropped from the calendar
579 Thursday, October 4, 1582 (Julian) was followed immediately by Friday, October 15, 1582 (Gregorian).
583 ($year == 1582 && ($month < 10 ||
($month == 10 && $day < 15)))) $greg_correction = 3;
585 $greg_correction = 0;
587 $greg_correction = 0;
596 $day = floor((13 * $month - 1) / 5) +
597 $day +
($year %
100) +
598 floor(($year %
100) / 4) +
599 floor(($year / 100) / 4) - 2 *
600 floor($year / 100) +
77 +
$greg_correction;
602 return $day - 7 * floor($day / 7);
607 Checks for leap year, returns true if it is. No 2-digit year check. Also
608 handles julian calendar correctly.
610 function _adodb_is_leap_year($year)
612 if ($year %
4 != 0) return false;
614 if ($year %
400 == 0) {
616 // if gregorian calendar (>1582), century not-divisible by 400 is not leap
617 } else if ($year > 1582 && $year %
100 == 0 ) {
626 checks for leap year, returns true if it is. Has 2-digit year check
628 function adodb_is_leap_year($year)
630 return _adodb_is_leap_year(adodb_year_digit_check($year));
634 Fix 2-digit years. Works for any century.
635 Assumes that if 2-digit is more than 30 years in future, then previous century.
637 function adodb_year_digit_check($y)
641 $yr = (integer) date("Y");
642 $century = (integer) ($yr /100);
652 // if 2-digit year is less than 30 years in future, set it to this century
653 // otherwise if more than 30 years in future, then we set 2-digit year to the prev century.
654 if (($y +
$c1) < $yr+
30) $y = $y +
$c1;
655 else $y = $y +
$c0*100;
661 get local time zone offset from GMT
663 function adodb_get_gmt_diff()
666 if (isset($TZ)) return $TZ;
668 $TZ = mktime(0,0,0,1,2,1970,0) - gmmktime(0,0,0,1,2,1970,0);
673 Returns an array with date info.
675 function adodb_getdate($d=false,$fast=false)
677 if ($d === false) return getdate();
678 if (!defined('ADODB_TEST_DATES')) {
679 if ((abs($d) <= 0x7FFFFFFF)) { // check if number in 32-bit signed range
680 if (!defined('ADODB_NO_NEGATIVE_TS') ||
$d >= 0) // if windows, must be +ve integer
684 return _adodb_getdate($d);
688 // generate $YRS table for _adodb_getdate()
689 function adodb_date_gentable($out=true)
692 for ($i=1970; $i >= 1600; $i-=10) {
693 $s = adodb_gmmktime(0,0,0,1,1,$i);
694 echo "$i => $s,<br>";
697 adodb_date_gentable();
699 for ($i=1970; $i > 1500; $i--) {
702 adodb_date_test_date($i,1,1);
708 $_month_table_normal = array("",31,28,31,30,31,30,31,31,30,31,30,31);
709 $_month_table_leaf = array("",31,29,31,30,31,30,31,31,30,31,30,31);
711 function adodb_validdate($y,$m,$d)
713 global $_month_table_normal,$_month_table_leaf;
715 if (_adodb_is_leap_year($y)) $marr =& $_month_table_leaf;
716 else $marr =& $_month_table_normal;
718 if ($m > 12 ||
$m < 1) return false;
720 if ($d > 31 ||
$d < 1) return false;
722 if ($marr[$m] < $d) return false;
724 if ($y < 1000 && $y > 3000) return false;
730 Low-level function that returns the getdate() array. We have a special
731 $fast flag, which if set to true, will return fewer array values,
732 and is much faster as it does not calculate dow, etc.
734 function _adodb_getdate($origd=false,$fast=false,$is_gmt=false)
737 global $_month_table_normal,$_month_table_leaf;
739 $d = $origd - ($is_gmt ?
0 : adodb_get_gmt_diff());
745 if ($d < -12219321600) $d -= 86400*10; // if 15 Oct 1582 or earlier, gregorian correction
747 $_month_table_normal = array("",31,28,31,30,31,30,31,31,30,31,30,31);
748 $_month_table_leaf = array("",31,29,31,30,31,30,31,31,30,31,30,31);
750 $d366 = $_day_power * 366;
751 $d365 = $_day_power * 365;
755 if (empty($YRS)) $YRS = array(
788 1650 => -10098172800,
789 1640 => -10413792000,
790 1630 => -10729324800,
791 1620 => -11044944000,
792 1610 => -11360476800,
793 1600 => -11676096000);
795 if ($is_gmt) $origd = $d;
796 // The valid range of a 32bit signed timestamp is typically from
797 // Fri, 13 Dec 1901 20:45:54 GMT to Tue, 19 Jan 2038 03:14:07 GMT
800 # old algorithm iterates through all years. new algorithm does it in
805 for ($a = 1970 ; --$a >= 0;) {
808 if ($leaf = _adodb_is_leap_year($a)) $d += $d366;
820 foreach($YRS as $year => $secs) {
830 if (!isset($a)) $a = $lastyear;
832 //echo ' yr=',$a,' ', $d,'.';
837 if ($leaf = _adodb_is_leap_year($a)) $d +
= $d366;
847 $secsInYear = 86400 * ($leaf ?
366 : 365) +
$lastd;
850 $mtab = ($leaf) ?
$_month_table_leaf : $_month_table_normal;
851 for ($a = 13 ; --$a > 0;) {
853 $d +
= $mtab[$a] * $_day_power;
862 $day = $ndays +
ceil(($d+
1) / ($_day_power));
864 $d +
= ($ndays - $day+
1)* $_day_power;
865 $hour = floor($d/$_hour_power);
868 for ($a = 1970 ;; $a++
) {
871 if ($leaf = _adodb_is_leap_year($a)) $d -= $d366;
878 $secsInYear = $lastd;
880 $mtab = ($leaf) ?
$_month_table_leaf : $_month_table_normal;
881 for ($a = 1 ; $a <= 12; $a++
) {
883 $d -= $mtab[$a] * $_day_power;
891 $day = ceil(($d+
1) / $_day_power);
892 $d = $d - ($day-1) * $_day_power;
893 $hour = floor($d /$_hour_power);
896 $d -= $hour * $_hour_power;
897 $min = floor($d/$_min_power);
898 $secs = $d - $min * $_min_power;
907 'yday' => floor($secsInYear/$_day_power),
914 $dow = adodb_dow($year,$month,$day);
924 'yday' => floor($secsInYear/$_day_power),
925 'weekday' => gmdate('l',$_day_power*(3+
$dow)),
926 'month' => gmdate('F',mktime(0,0,0,$month,2,1971)),
931 function adodb_gmdate($fmt,$d=false)
933 return adodb_date($fmt,$d,true);
936 // accepts unix timestamp and iso date format in $d
937 function adodb_date2($fmt, $d=false, $is_gmt=false)
941 "|^([0-9]{4})[-/\.]?([0-9]{1,2})[-/\.]?([0-9]{1,2})[ -]?(([0-9]{1,2}):?([0-9]{1,2}):?([0-9\.]{1,4}))?|",
942 ($d), $rr)) return adodb_date($fmt,false,$is_gmt);
944 if ($rr[1] <= 100 && $rr[2]<= 1) return adodb_date($fmt,false,$is_gmt);
947 if (!isset($rr[5])) $d = adodb_mktime(0,0,0,$rr[2],$rr[3],$rr[1],false,$is_gmt);
948 else $d = @adodb_mktime
($rr[5],$rr[6],$rr[7],$rr[2],$rr[3],$rr[1],false,$is_gmt);
951 return adodb_date($fmt,$d,$is_gmt);
956 Return formatted date based on timestamp $d
958 function adodb_date($fmt,$d=false,$is_gmt=false)
962 if ($d === false) return ($is_gmt)? @gmdate
($fmt): @date
($fmt);
963 if (!defined('ADODB_TEST_DATES')) {
964 if ((abs($d) <= 0x7FFFFFFF)) { // check if number in 32-bit signed range
965 if (!defined('ADODB_NO_NEGATIVE_TS') ||
$d >= 0) // if windows, must be +ve integer
966 return ($is_gmt)? @gmdate
($fmt,$d): @date
($fmt,$d);
972 $arr = _adodb_getdate($d,true,$is_gmt);
974 if (!isset($daylight)) $daylight = function_exists('adodb_daylight_sv');
975 if ($daylight) adodb_daylight_sv($arr, $is_gmt);
977 $year = $arr['year'];
978 $month = $arr['mon'];
980 $hour = $arr['hours'];
981 $min = $arr['minutes'];
982 $secs = $arr['seconds'];
987 $isphp5 = PHP_VERSION
>= 5;
990 at this point, we have the following integer vars to manipulate:
991 $year, $month, $day, $hour, $min, $secs
993 for ($i=0; $i < $max; $i++
) {
995 case 'T': $dates .= date('T');break;
997 case 'L': $dates .= $arr['leap'] ?
'1' : '0'; break;
998 case 'r': // Thu, 21 Dec 2000 16:01:07 +0200
1000 // 4.3.11 uses '04 Jun 2004'
1001 // 4.3.8 uses ' 4 Jun 2004'
1002 $dates .= gmdate('D',$_day_power*(3+
adodb_dow($year,$month,$day))).', '
1003 . ($day<10?
'0'.$day:$day) . ' '.date('M',mktime(0,0,0,$month,2,1971)).' '.$year.' ';
1005 if ($hour < 10) $dates .= '0'.$hour; else $dates .= $hour;
1007 if ($min < 10) $dates .= ':0'.$min; else $dates .= ':'.$min;
1009 if ($secs < 10) $dates .= ':0'.$secs; else $dates .= ':'.$secs;
1011 $gmt = adodb_get_gmt_diff();
1013 $dates .= sprintf(' %s%04d',($gmt<=0)?
'+':'-',abs($gmt)/36);
1015 $dates .= sprintf(' %s%04d',($gmt<0)?
'+':'-',abs($gmt)/36);
1018 case 'Y': $dates .= $year; break;
1019 case 'y': $dates .= substr($year,strlen($year)-2,2); break;
1021 case 'm': if ($month<10) $dates .= '0'.$month; else $dates .= $month; break;
1022 case 'Q': $dates .= ($month+
3)>>2; break;
1023 case 'n': $dates .= $month; break;
1024 case 'M': $dates .= date('M',mktime(0,0,0,$month,2,1971)); break;
1025 case 'F': $dates .= date('F',mktime(0,0,0,$month,2,1971)); break;
1027 case 't': $dates .= $arr['ndays']; break;
1028 case 'z': $dates .= $arr['yday']; break;
1029 case 'w': $dates .= adodb_dow($year,$month,$day); break;
1030 case 'l': $dates .= gmdate('l',$_day_power*(3+
adodb_dow($year,$month,$day))); break;
1031 case 'D': $dates .= gmdate('D',$_day_power*(3+
adodb_dow($year,$month,$day))); break;
1032 case 'j': $dates .= $day; break;
1033 case 'd': if ($day<10) $dates .= '0'.$day; else $dates .= $day; break;
1036 if ($d10 == 1) $dates .= 'st';
1037 else if ($d10 == 2 && $day != 12) $dates .= 'nd';
1038 else if ($d10 == 3) $dates .= 'rd';
1039 else $dates .= 'th';
1044 $dates .= ($is_gmt) ?
0 : -adodb_get_gmt_diff(); break;
1046 $gmt = ($is_gmt) ?
0 : adodb_get_gmt_diff();
1049 $dates .= sprintf('%s%04d',($gmt<=0)?
'+':'-',abs($gmt)/36);
1051 $dates .= sprintf('%s%04d',($gmt<0)?
'+':'-',abs($gmt)/36);
1055 if ($hour < 10) $dates .= '0'.$hour;
1056 else $dates .= $hour;
1059 if ($hour > 12) $hh = $hour - 12;
1061 if ($hour == 0) $hh = '12';
1065 if ($hh < 10) $dates .= '0'.$hh;
1074 if ($hour > 12) $hh = $hour - 12;
1076 if ($hour == 0) $hh = '12';
1082 case 'i': if ($min < 10) $dates .= '0'.$min; else $dates .= $min; break;
1084 case 'U': $dates .= $d; break;
1085 case 's': if ($secs < 10) $dates .= '0'.$secs; else $dates .= $secs; break;
1087 // Note 00:00 to 11:59 is AM, while 12:00 to 23:59 is PM
1089 if ($hour>=12) $dates .= 'pm';
1090 else $dates .= 'am';
1093 if ($hour>=12) $dates .= 'PM';
1094 else $dates .= 'AM';
1097 $dates .= $fmt[$i]; break;
1101 if ($i < $max) $dates .= $fmt[$i];
1109 Returns a timestamp given a GMT/UTC time.
1110 Note that $is_dst is not implemented and is ignored.
1112 function adodb_gmmktime($hr,$min,$sec,$mon=false,$day=false,$year=false,$is_dst=false)
1114 return adodb_mktime($hr,$min,$sec,$mon,$day,$year,$is_dst,true);
1118 Return a timestamp given a local time. Originally by jackbbs.
1119 Note that $is_dst is not implemented and is ignored.
1121 Not a very fast algorithm - O(n) operation. Could be optimized to O(1).
1123 function adodb_mktime($hr,$min,$sec,$mon=false,$day=false,$year=false,$is_dst=false,$is_gmt=false)
1125 if (!defined('ADODB_TEST_DATES')) {
1127 if ($mon === false) {
1128 return $is_gmt? @gmmktime
($hr,$min,$sec): @mktime
($hr,$min,$sec);
1131 // for windows, we don't check 1970 because with timezone differences,
1132 // 1 Jan 1970 could generate negative timestamp, which is illegal
1133 if (1971 < $year && $year < 2038
1134 ||
!defined('ADODB_NO_NEGATIVE_TS') && (1901 < $year && $year < 2038)
1137 @gmmktime
($hr,$min,$sec,$mon,$day,$year):
1138 @mktime
($hr,$min,$sec,$mon,$day,$year);
1142 $gmt_different = ($is_gmt) ?
0 : adodb_get_gmt_diff();
1145 # disabled because some people place large values in $sec.
1146 # however we need it for $mon because we use an array...
1148 $min = intval($min);
1149 $sec = intval($sec);
1151 $mon = intval($mon);
1152 $day = intval($day);
1153 $year = intval($year);
1156 $year = adodb_year_digit_check($year);
1159 $y = floor($mon / 12);
1162 } else if ($mon < 1) {
1163 $y = ceil((1-$mon) / 12);
1168 $_day_power = 86400;
1169 $_hour_power = 3600;
1172 $_month_table_normal = array("",31,28,31,30,31,30,31,31,30,31,30,31);
1173 $_month_table_leaf = array("",31,29,31,30,31,30,31,31,30,31,30,31);
1176 if ($year >= 1970) {
1177 for ($a = 1970 ; $a <= $year; $a++
) {
1178 $leaf = _adodb_is_leap_year($a);
1179 if ($leaf == true) {
1180 $loop_table = $_month_table_leaf;
1183 $loop_table = $_month_table_normal;
1187 $_total_date +
= $_add_date;
1189 for($b=1;$b<$mon;$b++
) {
1190 $_total_date +
= $loop_table[$b];
1194 $_total_date +
=$day-1;
1195 $ret = $_total_date * $_day_power +
$hr * $_hour_power +
$min * $_min_power +
$sec +
$gmt_different;
1198 for ($a = 1969 ; $a >= $year; $a--) {
1199 $leaf = _adodb_is_leap_year($a);
1200 if ($leaf == true) {
1201 $loop_table = $_month_table_leaf;
1204 $loop_table = $_month_table_normal;
1207 if ($a > $year) { $_total_date +
= $_add_date;
1209 for($b=12;$b>$mon;$b--) {
1210 $_total_date +
= $loop_table[$b];
1214 $_total_date +
= $loop_table[$mon] - $day;
1216 $_day_time = $hr * $_hour_power +
$min * $_min_power +
$sec;
1217 $_day_time = $_day_power - $_day_time;
1218 $ret = -( $_total_date * $_day_power +
$_day_time - $gmt_different);
1219 if ($ret < -12220185600) $ret +
= 10*86400; // if earlier than 5 Oct 1582 - gregorian correction
1220 else if ($ret < -12219321600) $ret = -12219321600; // if in limbo, reset to 15 Oct 1582.
1222 //print " dmy=$day/$mon/$year $hr:$min:$sec => " .$ret;
1226 function adodb_gmstrftime($fmt, $ts=false)
1228 return adodb_strftime($fmt,$ts,true);
1231 // hack - convert to adodb_date
1232 function adodb_strftime($fmt, $ts=false,$is_gmt=false)
1234 global $ADODB_DATE_LOCALE;
1236 if (!defined('ADODB_TEST_DATES')) {
1237 if ((abs($ts) <= 0x7FFFFFFF)) { // check if number in 32-bit signed range
1238 if (!defined('ADODB_NO_NEGATIVE_TS') ||
$ts >= 0) // if windows, must be +ve integer
1239 return ($is_gmt)? @gmstrftime
($fmt,$ts): @strftime
($fmt,$ts);
1244 if (empty($ADODB_DATE_LOCALE)) {
1246 $tstr = strtoupper(gmstrftime('%c',31366800)); // 30 Dec 1970, 1 am
1247 $sep = substr($tstr,2,1);
1248 $hasAM = strrpos($tstr,'M') !== false;
1250 # see http://phplens.com/lens/lensforum/msgs.php?id=14865 for reasoning, and changelog for version 0.24
1251 $dstr = gmstrftime('%x',31366800); // 30 Dec 1970, 1 am
1252 $sep = substr($dstr,2,1);
1253 $tstr = strtoupper(gmstrftime('%X',31366800)); // 30 Dec 1970, 1 am
1254 $hasAM = strrpos($tstr,'M') !== false;
1256 $ADODB_DATE_LOCALE = array();
1257 $ADODB_DATE_LOCALE[] = strncmp($tstr,'30',2) == 0 ?
'd'.$sep.'m'.$sep.'y' : 'm'.$sep.'d'.$sep.'y';
1258 $ADODB_DATE_LOCALE[] = ($hasAM) ?
'h:i:s a' : 'H:i:s';
1263 for ($i=0,$max = strlen($fmt); $i < $max; $i++
) {
1271 } else if ($inpct) {
1287 /* ignore format modifiers */
1291 case 'a': $fmtdate .= 'D'; break;
1292 case 'A': $fmtdate .= 'l'; break;
1294 case 'b': $fmtdate .= 'M'; break;
1295 case 'B': $fmtdate .= 'F'; break;
1296 case 'c': $fmtdate .= $ADODB_DATE_LOCALE[0].$ADODB_DATE_LOCALE[1]; break;
1297 case 'C': $fmtdate .= '\C?'; break; // century
1298 case 'd': $fmtdate .= 'd'; break;
1299 case 'D': $fmtdate .= 'm/d/y'; break;
1300 case 'e': $fmtdate .= 'j'; break;
1301 case 'g': $fmtdate .= '\g?'; break; //?
1302 case 'G': $fmtdate .= '\G?'; break; //?
1303 case 'H': $fmtdate .= 'H'; break;
1304 case 'I': $fmtdate .= 'h'; break;
1305 case 'j': $fmtdate .= '?z'; $parsej = true; break; // wrong as j=1-based, z=0-basd
1306 case 'm': $fmtdate .= 'm'; break;
1307 case 'M': $fmtdate .= 'i'; break;
1308 case 'n': $fmtdate .= "\n"; break;
1309 case 'p': $fmtdate .= 'a'; break;
1310 case 'r': $fmtdate .= 'h:i:s a'; break;
1311 case 'R': $fmtdate .= 'H:i:s'; break;
1312 case 'S': $fmtdate .= 's'; break;
1313 case 't': $fmtdate .= "\t"; break;
1314 case 'T': $fmtdate .= 'H:i:s'; break;
1315 case 'u': $fmtdate .= '?u'; $parseu = true; break; // wrong strftime=1-based, date=0-based
1316 case 'U': $fmtdate .= '?U'; $parseU = true; break;// wrong strftime=1-based, date=0-based
1317 case 'x': $fmtdate .= $ADODB_DATE_LOCALE[0]; break;
1318 case 'X': $fmtdate .= $ADODB_DATE_LOCALE[1]; break;
1319 case 'w': $fmtdate .= '?w'; $parseu = true; break; // wrong strftime=1-based, date=0-based
1320 case 'W': $fmtdate .= '?W'; $parseU = true; break;// wrong strftime=1-based, date=0-based
1321 case 'y': $fmtdate .= 'y'; break;
1322 case 'Y': $fmtdate .= 'Y'; break;
1323 case 'Z': $fmtdate .= 'T'; break;
1325 } else if (('A' <= ($ch) && ($ch) <= 'Z' ) ||
('a' <= ($ch) && ($ch) <= 'z' ))
1326 $fmtdate .= "\\".$ch;
1330 //echo "fmt=",$fmtdate,"<br>";
1331 if ($ts === false) $ts = time();
1332 $ret = adodb_date($fmtdate, $ts, $is_gmt);