]> git.mxchange.org Git - friendica.git/blobdiff - include/datetime.php
Merge branch 'master' of git://github.com/friendika/friendika
[friendica.git] / include / datetime.php
index d241f779e4510d4c0736b732ade229a464b2c31c..a5b388e767794326ee44aa894fc13561d627cbbf 100644 (file)
@@ -1,10 +1,12 @@
 <?php
 
+// two-level sort for timezones.
+
 if(! function_exists('timezone_cmp')) {
 function timezone_cmp($a, $b) {
        if(strstr($a,'/') && strstr($b,'/')) {
-               if ($a == $b) return 0;
-               return ($a < $b) ? -1 : 1;
+               if ( t($a) == t($b)) return 0;
+               return ( t($a) < t($b)) ? -1 : 1;
        }
        if(strstr($a,'/')) return -1;
        if(strstr($b,'/')) return  1;
@@ -12,6 +14,7 @@ function timezone_cmp($a, $b) {
        return ( t($a) < t($b)) ? -1 : 1;
 }}
 
+// emit a timezone selector grouped (primarily) by continent
 
 if(! function_exists('select_timezone')) {
 function select_timezone($current = 'America/Los_Angeles') {
@@ -38,9 +41,9 @@ function select_timezone($current = 'America/Los_Angeles') {
                }
                else {
                        $city = $ex[0];
-                       if($continent != 'Miscellaneous') {
+                       if($continent != t('Miscellaneous')) {
                                $o .= '</optgroup>';
-                               $continent = 'Miscellaneous';
+                               $continent = t('Miscellaneous');
                                $o .= '<optgroup label="' . t($continent) . '">';       
                        }
                }
@@ -52,6 +55,11 @@ function select_timezone($current = 'America/Los_Angeles') {
        return $o;
 }}
 
+// General purpose date parse/convert function.
+// $from = source timezone
+// $to   = dest timezone
+// $s    = some parseable date/time string
+// $fmt  = output format
 
 if(! function_exists('datetime_convert')) {
 function datetime_convert($from = 'UTC', $to = 'UTC', $s = 'now', $fmt = "Y-m-d H:i:s") {
@@ -71,6 +79,8 @@ function datetime_convert($from = 'UTC', $to = 'UTC', $s = 'now', $fmt = "Y-m-d
        return($d->format($fmt));
 }}
 
+// wrapper for date selector, tailored for use in birthday fields
+
 function dob($dob) {
        list($year,$month,$day) = sscanf($dob,'%4d-%2d-%2d');
        $y = datetime_convert('UTC',date_default_timezone_get(),'now','Y');
@@ -78,6 +88,16 @@ function dob($dob) {
        return $o;
 }
 
+
+// returns a date selector.
+// $pre         = prefix (if needed) for HTML name and class fields
+// $ymin        = first year shown in selector dropdown
+// $ymax        = last year shown in selector dropdown
+// $allow_blank = allow an empty response on any field
+// $y           = already selected year
+// $m           = already selected month
+// $d           = already selected day
+
 if(! function_exists('datesel')) {
 function datesel($pre,$ymin,$ymax,$allow_blank,$y,$m,$d) {
 
@@ -88,20 +108,28 @@ function datesel($pre,$ymin,$ymax,$allow_blank,$y,$m,$d) {
                $o .= "<option value=\"0000\" $sel ></option>";
        }
 
-       for($x = $ymax; $x >= $ymin; $x --) {
-               $sel = (($x == $y) ? " selected=\"selected\" " : "");
-               $o .= "<option value=\"$x\" $sel>$x</option>";
+       if($ymax > $ymin) {
+               for($x = $ymax; $x >= $ymin; $x --) {
+                       $sel = (($x == $y) ? " selected=\"selected\" " : "");
+                       $o .= "<option value=\"$x\" $sel>$x</option>";
+               }
+       }
+       else {
+               for($x = $ymax; $x <= $ymin; $x ++) {
+                       $sel = (($x == $y) ? " selected=\"selected\" " : "");
+                       $o .= "<option value=\"$x\" $sel>$x</option>";
+               }
        }
   
        $o .= "</select> <select name=\"{$pre}month\" class=\"{$pre}month\" size=\"1\">";
-       for($x = 0; $x <= 12; $x ++) {
+       for($x = (($allow_blank) ? 0 : 1); $x <= 12; $x ++) {
                $sel = (($x == $m) ? " selected=\"selected\" " : "");
                $y = (($x) ? $x : '');
                $o .= "<option value=\"$x\" $sel>$y</option>";
        }
 
        $o .= "</select> <select name=\"{$pre}day\" class=\"{$pre}day\" size=\"1\">";
-       for($x = 0; $x <= 31; $x ++) {
+       for($x = (($allow_blank) ? 0 : 1); $x <= 31; $x ++) {
                $sel = (($x == $d) ? " selected=\"selected\" " : "");
                $y = (($x) ? $x : '');
                $o .= "<option value=\"$x\" $sel>$y</option>";
@@ -111,6 +139,36 @@ function datesel($pre,$ymin,$ymax,$allow_blank,$y,$m,$d) {
        return $o;
 }}
 
+if(! function_exists('timesel')) {
+function timesel($pre,$h,$m) {
+
+       $o = '';
+       $o .= "<select name=\"{$pre}hour\" class=\"{$pre}hour\" size=\"1\">";
+       for($x = 0; $x < 24; $x ++) {
+               $sel = (($x == $h) ? " selected=\"selected\" " : "");
+               $o .= "<option value=\"$x\" $sel>$x</option>";
+       }
+       $o .= "</select> : <select name=\"{$pre}minute\" class=\"{$pre}minute\" size=\"1\">";
+       for($x = 0; $x < 60; $x ++) {
+               $sel = (($x == $m) ? " selected=\"selected\" " : "");
+               $o .= "<option value=\"$x\" $sel>$x</option>";
+       }
+
+       $o .= "</select>";
+       return $o;
+}}
+
+
+
+
+
+
+
+
+// implements "3 seconds ago" etc.
+// based on $posted_date, (UTC).
+// Results relative to current timezone
+// Limited to range of timestamps
 
 if(! function_exists('relative_date')) {
 function relative_date($posted_date) {
@@ -143,6 +201,17 @@ function relative_date($posted_date) {
 }}
 
 
+
+// Returns age in years, given a date of birth,
+// the timezone of the person whose date of birth is provided,
+// and the timezone of the person viewing the result.
+// Why? Bear with me. Let's say I live in Mittagong, Australia, and my 
+// birthday is on New Year's. You live in San Bruno, California.
+// When exactly are you going to see my age increase?
+// A: 5:00 AM Dec 31 San Bruno time. That's precisely when I start 
+// celebrating and become a year older. If you wish me happy birthday 
+// on January 1 (San Bruno time), you'll be a day late. 
+   
 function age($dob,$owner_tz = '',$viewer_tz = '') {
        if(! intval($dob))
                return 0;
@@ -161,3 +230,114 @@ function age($dob,$owner_tz = '',$viewer_tz = '') {
                $year_diff--;
        return $year_diff;
 }
+
+
+
+// Get days in month
+// get_dim($year, $month);
+// returns number of days.
+// $month[1] = 'January'; 
+//   to match human usage.
+
+if(! function_exists('get_dim')) {
+function get_dim($y,$m) {
+
+  $dim = array( 0,
+    31, 28, 31, 30, 31, 30,
+    31, 31, 30, 31, 30, 31);
+  if($m != 2)
+    return $dim[$m];
+  if(((($y % 4) == 0) && (($y % 100) != 0)) || (($y % 400) == 0))
+    return 29;
+  return $dim[2];
+}}
+
+
+// Returns the first day in month for a given month, year
+// get_first_dim($year,$month)
+// returns 0 = Sunday through 6 = Saturday
+// Months start at 1.
+
+if(! function_exists('get_first_dim')) {
+function get_first_dim($y,$m) {
+  $d = sprintf('%04d-%02d-01 00:00', intval($y), intval($m));
+  return datetime_convert('UTC','UTC',$d,'w');
+}}
+
+// output a calendar for the given month, year.
+// if $links are provided (array), e.g. $links[12] => 'http://mylink' , 
+// date 12 will be linked appropriately. Today's date is also noted by 
+// altering td class.
+// Months count from 1.
+
+
+// TODO: provide (prev,next) links, define class variations for different size calendars
+
+
+if(! function_exists('cal')) {
+function cal($y = 0,$m = 0, $links = false, $class='') {
+
+
+       // month table - start at 1 to match human usage.
+
+       $mtab = array(' ',
+         'January','February','March',
+         'April','May','June',
+         'July','August','September',
+         'October','November','December'
+       ); 
+
+       $thisyear = datetime_convert('UTC',date_default_timezone_get(),'now','Y');
+       $thismonth = datetime_convert('UTC',date_default_timezone_get(),'now','m');
+       if(! $y)
+               $y = $thisyear;
+       if(! $m)
+               $m = intval($thismonth);
+
+  $dn = array('Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday');
+  $f = get_first_dim($y,$m);
+  $l = get_dim($y,$m);
+  $d = 1;
+  $dow = 0;
+  $started = false;
+
+  if(($y == $thisyear) && ($m == $thismonth))
+    $tddate = intval(datetime_convert('UTC',date_default_timezone_get(),'now','j'));
+
+       $str_month = day_translate($mtab[$m]);
+  $o = '<table class="calendar' . $class . '">';
+  $o .= "<caption>$str_month $y</caption><tr>";
+  for($a = 0; $a < 7; $a ++)
+     $o .= '<th>' . mb_substr(day_translate($dn[$a]),0,3,'UTF-8') . '</th>';
+  $o .= '</tr><tr>';
+
+  while($d <= $l) {
+    if(($dow == $f) && (! $started))
+      $started = true;
+    $today = (((isset($tddate)) && ($tddate == $d)) ? "class=\"today\" " : '');
+    $o .= "<td $today>";
+       $day = str_replace(' ','&nbsp;',sprintf('%2.2d', $d));
+    if($started) {
+      if(is_array($links) && isset($links[$d]))
+        $o .=  "<a href=\"{$links[$d]}\">$day</a>";
+      else
+        $o .= $day;
+      $d ++;
+    }
+    else
+      $o .= '&nbsp;';
+    $o .= '</td>';
+    $dow ++;
+    if(($dow == 7) && ($d <= $l)) {
+      $dow = 0;
+      $o .= '</tr><tr>';
+    }
+  }
+  if($dow)
+    for($a = $dow; $a < 7; $a ++)
+       $o .= '<td>&nbsp;</td>';
+  $o .= '</tr></table>'."\r\n";  
+  
+  return $o;
+}}