Differences

This shows you the differences between two versions of the page.

--- datetime:adodb_getdate [2015/11/26 15:07] – mnewnham
+++ v5:datetime:adodb_getdate [2023/05/18 18:54] (current) – Deprecated dregad
@@ Line 5: / Line 5: @@
 [[http://php.net/manual/en/function.getdate.php|PHP Function getdate()]]
 == Syntax ==
-  int adodb_getdate(
+  array adodb_getdate(
-     optional mixed $date=false
+     optional mixed $timestamp=time()
   )
 </WRAP>
+<WRAP important>
+[[datetime_index#deprecated|Deprecated]] since ADOdb 5.22.6, and [[https://github.com/ADOdb/ADOdb/issues/970|removed in 5.23.0]].
+Use 64-bit native PHP functions instead.
+</WRAP>
 ===== Description =====
-Returns an array containing date information, as getdate(), but supports dates greater than 1901 to 2038. The local date/time format is derived from a heuristic the first time adodb_getdate is called..
+Returns an array containing date information, the same as the PHP function ''getDate()'', but supporting dates less than 1901 and greater than 2038. The local date/time format is derived from a heuristic the first time adodb_getdate() is called.
+--------------------------------
+===== Usage =====
+<code php>
+/*
+* Gets information from now
+*/
+$d = adodb_getdate();
+print_r($d);
+/*
+* Returns
+Array
+(
+    [seconds] => 28
+    [minutes] => 51
+    [hours] => 14
+    [mday] => 3
+    [wday] => 4
+    [mon] => 12
+    [year] => 2015
+    [yday] => 336
+    [weekday] => Thursday
+    [month] => December
+    [0] => 1449179488
+)
+*/
+/*
+* What happened a thousand years ago?
+*/
+$d = adodb_getdate(time() - (365 * 24 * 60 * 60 * 1000));
+/*
+* Returns
+Array
+(
+    [seconds] => 46
+    [minutes] => 54
+    [hours] => 14
+    [mday] => 27
+    [wday] => 2
+    [mon] => 7
+    [year] => 1016
+    [yday] => 208
+    [weekday] => Tuesday
+    [month] => July
+    [0] => -30086820314
+)
+*/
+</code>
+Note that in the example above, the number of seconds in array index 0, is negative. This is because we are setting a date prior to the epoch value of 0 at 01/01/1970.