aboutsummaryrefslogtreecommitdiffstats
path: root/include
diff options
context:
space:
mode:
Diffstat (limited to 'include')
-rw-r--r--include/functions.inc.php217
1 files changed, 138 insertions, 79 deletions
diff --git a/include/functions.inc.php b/include/functions.inc.php
index 32417cfd9..9703a51aa 100644
--- a/include/functions.inc.php
+++ b/include/functions.inc.php
@@ -457,122 +457,181 @@ INSERT INTO '.HISTORY_TABLE.'
return true;
}
-// format_date returns a formatted date for display. The date given in
-// argument must be an american format (2003-09-15). By option, you can show the time.
-// The output is internationalized.
-//
-// format_date( "2003-09-15", true ) -> "Monday 15 September 2003 21:52"
-function format_date($date, $show_time = false, $show_day_name = true)
+/**
+ * converts a string into a DateTime object
+ * @param: mixed, datetime string or timestamp int
+ * @param: string, input format
+ * @return: DateTime or false
+ */
+function str2DateTime($original, $format=null)
{
- global $lang;
-
- if (strpos($date, '0') == 0)
+ if (!empty($format))// from known date format
{
- return l10n('N/A');
+ return DateTime::createFromFormat('!'.$format, $original); // ! char to reset fields to UNIX epoch
}
-
- $ymdhms = array();
- $tok = strtok( $date, '- :');
- while ($tok !== false)
+ else
{
- $ymdhms[] = $tok;
- $tok = strtok('- :');
+ $date = new DateTime();
+
+ $t = trim($original, '0123456789');
+ if (empty($t)) // from timestamp
+ {
+ $date->setTimestamp($original);
+ }
+ else // from unknown date format (assuming something like Y-m-d H:i:s)
+ {
+ $ymdhms = array();
+ $tok = strtok($original, '- :/');
+ while ($tok !== false)
+ {
+ $ymdhms[] = $tok;
+ $tok = strtok('- :/');
+ }
+
+ if (count($ymdhms)<3) return false;
+ if (!isset($ymdhms[3])) $ymdhms[3] = 0;
+ if (!isset($ymdhms[4])) $ymdhms[4] = 0;
+ if (!isset($ymdhms[5])) $ymdhms[5] = 0;
+
+ $date->setDate($ymdhms[0], $ymdhms[1], $ymdhms[2]);
+ $date->setTime($ymdhms[3], $ymdhms[4], $ymdhms[5]);
+ }
+
+ return $date;
}
+}
- if ( count($ymdhms)<3 )
- {
- return false;
- }
+/**
+ * returns a formatted date for display
+ * @param: mixed, datetime string or timestamp int
+ * @param: bool, show time
+ * @param: bool, show day name
+ * @param: string, input format
+ * @return: string
+ */
+function format_date($original, $show_time=false, $show_day_name=true, $format=null)
+{
+ global $lang;
+
+ $date = str2DateTime($original, $format);
- $formated_date = '';
- // before 1970, Microsoft Windows can't mktime
- if ($ymdhms[0] >= 1970 and $ymdhms[1] != 0 and $ymdhms[2] != 0)
+ if (!$date)
{
- // we ask midday because Windows think it's prior to midnight with a
- // zero and refuse to work
- $formated_date.= $lang['day'][date('w', mktime(12,0,0,$ymdhms[1],$ymdhms[2],$ymdhms[0]))];
+ return l10n('N/A');
}
- if ($ymdhms[2] != 0)
+ $print = '';
+ if ($show_day_name)
{
- $formated_date.= ' '.$ymdhms[2];
+ $print.= $lang['day'][ $date->format('w') ];
}
-
- if ($ymdhms[1] != 0)
+
+ $print.= ' '.$date->format('d');
+ $print.= ' '.$lang['month'][ $date->format('n') ];
+ $print.= ' '.$date->format('Y');
+
+ if ($show_time)
{
- $formated_date.= ' '.$lang['month'][(int)$ymdhms[1]];
+ $temp = $date->format('H:i');
+ if ($temp != '00:00')
+ {
+ $print.= ' '.$temp;
+ }
}
- $formated_date.= ' '.$ymdhms[0];
- if ($show_time and count($ymdhms)>=5 )
- {
- $formated_date.= ' '.$ymdhms[3].':'.$ymdhms[4];
- }
- return $formated_date;
+ return trim($print);
}
/**
- * Works out the time since the entry post, takes a an argument in unix time or datetime
+ * Works out the time since the given date
+ * @param: mixed, datetime string or timestamp int
+ * @param: string, stop (year,month,week,day,hour,minute,second)
+ * @param: string, input format
+ * @param: bool, append text ("ago" or "in the future")
+ * @param: bool, display weeks
+ * @return: string
*/
-function time_since($original, $stop = 'minute')
+function time_since($original, $stop='minute', $format=null, $with_text=true, $with_week=true)
{
- if (!is_int($original))
- {
- $ymdhms = array();
- $tok = strtok($original, '- :');
- while ($tok !== false)
- {
- $ymdhms[] = $tok;
- $tok = strtok('- :');
- }
+ $date = str2DateTime($original, $format);
- if ($ymdhms[0] < 1970) return false;
- if (!isset($ymdhms[3])) $ymdhms[3] = 12;
- if (!isset($ymdhms[4])) $ymdhms[4] = 0;
- if (!isset($ymdhms[5])) $ymdhms[5] = 0;
- $original = mktime($ymdhms[3],$ymdhms[4],$ymdhms[5],$ymdhms[1],$ymdhms[2],$ymdhms[0]);
+ if (!$date)
+ {
+ return l10n('N/A');
}
-
- // array of time period chunks
+
+ $now = new DateTime();
+ $diff = $now->diff($date);
+
+ if ($with_week)
+ {
+ // DateInterval does not compute the number of weeks
+ $diff->w = (int)floor($diff->d/7);
+ $diff->d = $diff->d - $diff->w*7;
+ }
+ else
+ {
+ $diff->w = 0;
+ }
+
$chunks = array(
- 'year' => 60 * 60 * 24 * 365,
- 'month' => 60 * 60 * 24 * 30,
- 'week' => 60 * 60 * 24 * 7,
- 'day' => 60 * 60 * 24,
- 'hour' => 60 * 60,
- 'minute' => 60,
- 'second' => 1,
+ 'year' => 'y',
+ 'month' => 'm',
+ 'week' => 'w',
+ 'day' => 'd',
+ 'hour' => 'h',
+ 'minute' => 'i',
+ 'second' => 's',
);
-
- $today = time(); /* Current unix time */
- $since = abs($today - $original);
-
- $print = null;
- foreach ($chunks as $name => $seconds)
+
+ $j = array_search($stop, array_keys($chunks));
+
+ $print = ''; $i=0;
+ foreach ($chunks as $name => $var)
{
- if (($count = floor($since / $seconds)) != 0)
+ if ($diff->{$var} != 0)
{
- $print.= l10n_dec('%d '.$name, '%d '.$name.'s', $count);
- $since-= $count*$seconds;
+ $print.= ' '.l10n_dec('%d '.$name, '%d '.$name.'s', $diff->{$var});
}
- if (!empty($print) and $chunks[$name] <= $chunks[$stop])
+ if (!empty($print) && $i >= $j)
{
break;
}
+ $i++;
}
-
- if ($today > $original)
- {
- $print = sprintf(l10n('%s ago'), $print);
- }
- else
+
+ $print = trim($print);
+
+ if ($with_text)
{
- $print = sprintf(l10n('%s in the future'), $print);
+ if ($diff->invert)
+ {
+ $print = sprintf(l10n('%s ago'), $print);
+ }
+ else
+ {
+ $print = sprintf(l10n('%s in the future'), $print);
+ }
}
return $print;
}
+/**
+ * transform a date string from a format to another (MySQL to d/M/Y for instance)
+ * @param: string, date
+ * @param: string, input format
+ * @param: string, output format
+ * @param: string, default value if inout is empty
+ * @return: string
+ */
+function transform_date($original, $format_in, $format_out, $default=null)
+{
+ if (empty($original)) return $default;
+ $date = str2DateTime($original, $format_in);
+ return $date->format($format_out);
+}
+
function pwg_debug( $string )
{
global $debug,$t2,$page;