Source for file class.TIME.php

Documentation is available at class.TIME.php

  1. <?php
  2.  
  3. error_reporting(E_ALL);
  4.  
  5. /**
  6.  * Stellt verschiedene Funktionen zum Umrechen der SQL-Zeit zur Verfügung
  7.  *
  8.  * @author kay koch
  9.  * @package src
  10.  * @since 04.2005
  11.  * @subpackage tools
  12.  * @version 1.0
  13.  */
  14.  
  15. if (0 > version_compare(PHP_VERSION, '5')) {
  16.     die('This file was generated for PHP 5');
  17. }
  18.  
  19. /* user defined includes */
  20. // section -64--88-122--2-7e76ee3:1035fed717c:-7ff5-includes begin
  21. // section -64--88-122--2-7e76ee3:1035fed717c:-7ff5-includes end
  22.  
  23. /* user defined constants */
  24. // section -64--88-122--2-7e76ee3:1035fed717c:-7ff5-constants begin
  25. // section -64--88-122--2-7e76ee3:1035fed717c:-7ff5-constants end
  26.  
  27. /**
  28.  * Stellt verschiedene Funktionen zum Umrechen der SQL-Zeit zur Verfügung
  29.  *
  30.  * @access public
  31.  * @author kay koch
  32.  * @package src
  33.  * @since 04.2005
  34.  * @subpackage tools
  35.  * @version 1.0
  36.  */
  37. class src_tools_TIME
  38. {
  39.     // --- ATTRIBUTES ---
  40.  
  41.     
  42.     /**
  43.      * Array mit deutschen Wochentagen
  44.      *
  45.      * [1] = Montag
  46.      * [2]=Dienstag
  47.      * .
  48.      * .
  49.      * [7]:Sonntag
  50.      *
  51.      * @access private
  52.      * @var array 
  53.      */
  54.     private static $arrWeekdays = array("1"=>"Montag", "2"=>"Dienstag", "3"=>"Mittwoch", "4"=>"Donnerstag", "5"=>"Freitag", "6"=>"Samstag", "7"=>"Sonntag");
  55.     private static $arrMonths = array("1"=>"Januar","2"=>"Februar","3"=>"März","4"=>"April","5"=>"Mai","6"=>"Juni","7"=>"Juli","8"=>"August","9"=>"September","10"=>"Oktober","11"=>"November","12"=>"Dezember");
  56.     // --- OPERATIONS ---
  57.  
  58.     
  59.     /**
  60.      * Wandelt SQL-Zeitangaben in gewünschte Formatierungen um
  61.      *
  62.      * @access public
  63.      * @author Kay Koch, <kay.koch@gmx.de>
  64.      * @param string 
  65.      * @param string 
  66.      * @return string 
  67.      */
  68.     public static function sqlT2realT($sqlTime, $format="%a, %d. %B %Y")
  69.     {
  70.         $returnValue = (string) '';
  71.  
  72.         // section -64--88-122--2-7e76ee3:1035fed717c:-7ff4 begin
  73.         // SQL-Zeit in Jahr, Monat und Tag umwandeln
  74.         list($y, $m, $d) = split("-", $sqlTime);
  75.         // Formatierung durchführen
  76.         $returnValue = strftime($format, mktime(0, 0, 0, $m, $d, $y));
  77.         // Sonntag wird an das Ende der Woche verschoben wenn der Wochentag verlangt war
  78.         if (($format == "%w") AND ($returnValue == 0))
  79.             $returnValue = 7;
  80.         // section -64--88-122--2-7e76ee3:1035fed717c:-7ff4 end
  81.  
  82.         return (string) $returnValue;
  83.     }
  84.  
  85.     /**
  86.      * liefert aus einem dem laufenden Tag im Jahr:
  87.      *
  88.      * [0]: Tag im SQL-Format
  89.      * [1]: Wochentag (Mo=1,Di=2...So=7)
  90.      *
  91.      * @access public
  92.      * @author Kay Koch, <kay.koch@gmx.de>
  93.      * @param void 
  94.      * @return array 
  95.      */
  96.     public static function yearDay2SQL($dayInYear)
  97.     {
  98.         $returnValue = array();
  99.  
  100.         // section -64--88-122--2-2ea88049:103eaafb81d:-7fd4 begin
  101.         $timestamp = mktime(0, 0, 0, 1, $dayInYear); // Unix-Timestamp
  102.         $weekday = strftime("%w", $timestamp); // Wochentag
  103.         $returnValue[0] = strftime("%Y-%m-%d", $timestamp); // Timestamp in SQL-Format
  104.         $returnValue[1] = ($weekday == 0) ? 7:$weekday; // Mo=1, Di=2 ... So=7;
  105.         // section -64--88-122--2-2ea88049:103eaafb81d:-7fd4 end
  106.  
  107.         return (array) $returnValue;
  108.     }
  109.  
  110.     /**
  111.      * startet einen Timer zur überprüfung der Laufzeit
  112.      *
  113.      * @access public
  114.      * @author Kay Koch, <kay.koch@gmx.de>
  115.      * @param string 
  116.      * @return int 
  117.      */
  118.     public static function start_timer($event)
  119.     {
  120.         $returnValue = (int) 0;
  121.  
  122.         // section -64--88-122--2-5c2c8d5:103f4c97e55:-7fdb begin
  123.         list($low, $high) = explode(" ", microtime());
  124.         $returnValue = $high + $low;
  125.         // flush();
  126.         // $t = src_tools_TIME::start_timer("");
  127.         // section -64--88-122--2-5c2c8d5:103f4c97e55:-7fdb end
  128.  
  129.         return (int) $returnValue;
  130.     }
  131.  
  132.     /**
  133.      * gibt die Laufzeit seit start_timer, bzw. sich selbst  aus
  134.      *
  135.      * @access public
  136.      * @author Kay Koch, <kay.koch@gmx.de>
  137.      * @param int 
  138.      * @param string 
  139.      * @return float 
  140.      */
  141.     public static function next_timer($start, $event)
  142.     {
  143.         $returnValue = (float) 0.0;
  144.  
  145.         // section -64--88-122--2-5c2c8d5:103f4c97e55:-7fd8 begin
  146.         list($low, $high) = explode(" ", microtime());
  147.         $returnValue = $high + $low;
  148.         $used = $returnValue - $start;
  149.         printf("<br>$event: %8.4f Sekunden<br>\n", $used);
  150.         $f = substr($_SERVER["SCRIPT_NAME"], 1);
  151.         Print "letzte Änderung: " . strftime("%A, %d.%m %Y - %H:%Mh", filemtime(basename($_SERVER["SCRIPT_NAME"])));
  152.         // flush();
  153.         //$t = src_tools_TIME::next_timer ($t, "benötigte Zeit für den Seitenaufbau");
  154.         // section -64--88-122--2-5c2c8d5:103f4c97e55:-7fd8 end
  155.  
  156.         return (float) $returnValue;
  157.     }
  158.  
  159.     /**
  160.      * wandelt den Wochentag (zahl) in einen Wochentag (Name) um
  161.      *
  162.      * @access public
  163.      * @author Kay Koch, <kay.koch@gmx.de>
  164.      * @param int 
  165.      * @return string 
  166.      */
  167.     public static function dayNr2dayName($weekday)
  168.     {
  169.         $returnValue = (string) '';
  170.  
  171.         // section -64--88-122--2-556c3468:1044bd6a64b:-7fc0 begin
  172.         $returnValue = self::$arrWeekdays[$weekday];
  173.         // section -64--88-122--2-556c3468:1044bd6a64b:-7fc0 end
  174.  
  175.         return (string) $returnValue;
  176.     }
  177.  
  178.     /**
  179.      * liefert ein OptionList mit den Wochentagen aus
  180.      *
  181.      * @access public
  182.      * @author Kay Koch, <kay.koch@gmx.de>
  183.      * @param int 
  184.      * @return string 
  185.      */
  186.     public static function getWeekOL($weekday="")
  187.     {
  188.         $returnValue = (string) '';
  189.  
  190.         // section -64--88-122--2--5ee49331:10456be0103:-7fbc begin
  191.  
  192.         foreach(self::$arrWeekdays as $key=>$dayName) {
  193.             $selected = ($weekday == $key) ? "SELECTED" : "";
  194.             $returnValue .= "<option $selected value='$key'>$dayName</option>\n";
  195.         }
  196.         // section -64--88-122--2--5ee49331:10456be0103:-7fbc end
  197.  
  198.         return (string) $returnValue;
  199.     }
  200.  
  201.     /**
  202.      * liefert ein OptionList mit den Monaten aus
  203.      *
  204.      * @access public
  205.      * @author Kay Koch, <kay.koch@gmx.de>
  206.      * @param int 
  207.      * @return string 
  208.      */
  209.     public static function getMonthOL($month="")
  210.     {
  211.         $returnValue = (string) '';
  212.  
  213.         // section -64--88-122--2--5ee49331:10456be0103:-7fbc begin
  214.  
  215.         foreach(self::$arrMonths as $key=>$monthName) {
  216.             $selected = ($month == $key) ? "SELECTED" : "";
  217.             $returnValue .= "<option $selected value='$key'>$monthName</option>\n";
  218.         }
  219.         // section -64--88-122--2--5ee49331:10456be0103:-7fbc end
  220.  
  221.         return (string) $returnValue;
  222.     }
  223.     /**
  224.      * liefert ein OptionList mit den Tagen eines Monats aus
  225.      *
  226.      * @access public
  227.      * @author Kay Koch, <kay.koch@gmx.de>
  228.      * @param int 
  229.      * @return string 
  230.      */
  231.     public static function getDayOL($vDay="",$maxDay=31)
  232.     {
  233.         $returnValue = (string) '';
  234.  
  235.         // section -64--88-122--2--5ee49331:10456be0103:-7fbc begin
  236.  
  237.         for( $day = 1; $day<=$maxDay; $day++) {
  238.             $selected = ($day == $vDay) ? "SELECTED" : "";
  239.             $returnValue .= "<option $selected value='$day'>$day</option>\n";
  240.         }
  241.         // section -64--88-122--2--5ee49331:10456be0103:-7fbc end
  242.  
  243.         return (string) $returnValue;
  244.     }
  245.     /**
  246.      * liefert ein OptionList mit den Zeiten eines Tages aus
  247.      *
  248.      * @access public
  249.      * @author Kay Koch, <kay.koch@gmx.de>
  250.      * @param int 
  251.      * @return string 
  252.      */
  253.     public static function getHourOL($hour="",$startHour="01:00",$endHour="24:00")
  254.     {
  255.         $returnValue = (string) '';
  256.  
  257.         try
  258.         {
  259.             if($startHour> $endHour)
  260.                 throw new Exception ();
  261.             $startHour = (int)substr($startHour,0,3);
  262.             $endHour = (int)substr($endHour,0,3);
  263.             $hour = (int)substr($hour,0,3);
  264.              for ($actHour = $startHour; $actHour<= $endHour; $actHour++){
  265.                  $longHour = ($actHour < 10)? "0".$actHour.":00" : $actHour.":00";
  266.                  $selected = ($hour == $actHour) ? "SELECTED" : "";
  267.                  $returnValue .= "<option $selected value='$longHour'>$longHour h</option>\n";
  268.              }
  269.         } catch (Exception $e)
  270.         {
  271.             src_tools_ERROR :: setError($e, __METHOD__);
  272.         }
  273.  
  274.         return (string) $returnValue;
  275.     }
  276.  
  277.     /**
  278.      * addiert zu einem SQL-Datum Tage hinzu und liefert das Ergebnis zurück
  279.      *
  280.      * @access public
  281.      * @author Kay Koch, <kay.koch@gmx.de>
  282.      * @param date 
  283.      * @param int 
  284.      * @return date 
  285.      */
  286.     public static function addDays2SQL($sqlTime, $days = 0)
  287.     {
  288.         $returnValue = null;
  289.  
  290.         // section -64--88-60-100--6299d47e:109acba51de:-7ff5 begin
  291.         list($y, $m, $d) = split("-", $sqlTime);
  292.         $returnValue = strftime("%Y-%m-%d", mktime(0,0,0, $m, $d+$days, $y));
  293.         // section -64--88-60-100--6299d47e:109acba51de:-7ff5 end
  294.  
  295.         return $returnValue;
  296.     }
  297.     public static function time2longTime($stunde){
  298.         $returnValue = (string) '';
  299.         //
  300.         if (strlen($stunde) == 5)
  301.             $stunde.=":00";
  302.         $returnValue =  $stunde;
  303.         //
  304.         return (string) $returnValue;
  305.     }
  306.     public static function time2shortTime($stunde){
  307.         return (string) substr($stunde,0,5);
  308.     }
  309.     public static function formatDate ($d, $m, $y) {
  310.         return $y . "-" . sprintf('%02d',$m) . "-" . sprintf('%02d',$d);
  311.     }
  312.     public static function formatHour ($h,$add=0) {
  313.         $h +=$add;
  314.         return sprintf('%02d', $h) . ":00";
  315.     }
  316.    /**
  317.     *
  318.     * getFeiertage
  319.     * Karfreitag (beweglicher Feiertag; 2 Tage vor Ostern)
  320.     * Ostersonntag
  321.     * Ostermontag (beweglicher Feiertag; 1 Tag nach Ostern)
  322.     * Maifeiertag (fester Feiertag am 1. Mai)
  323.     * Christi Himmelfahrt (beweglicher Feiertag; 39 Tage nach Ostern)
  324.     * Pfingstsonntag (beweglicher Feiertag; 49 Tage nach Ostern)
  325.     * Pfingstmontag (beweglicher Feiertag; 50 Tage nach Ostern)
  326.     * Fronleichnam (beweglicher Feiertag; 60 Tage nach Ostern)
  327.     * Mariä Himmelfahrt (fester Feiertag am 15. August)
  328.     * Tag der deutschen Einheit(fester Feiertag am 3. Oktober)
  329.    *
  330.    * @ author kaykoch
  331.    * @ access public
  332.    * @ since 1.0 - 20.03 .2007
  333.    * @ return array Feld mit Feiertagen
  334.    */
  335.    public static function getFeiertage() {
  336.       $returnValue = array ();
  337.       $year = date("Y");
  338.       $easterday = date("Y-m-d", easter_date($year));
  339.       $returnValue['karfreitag'] = src_tools_TIME :: addDays2SQL($easterday, -2);
  340.       #$returnValue['ostersonntag'] = $easterday;
  341.       $returnValue['ostermontag'] = src_tools_TIME :: addDays2SQL($easterday, 1);
  342.       $returnValue['erstermai'] = $year . "-05-01";
  343.       $returnValue['christihimmelfahrt'] = src_tools_TIME :: addDays2SQL($easterday, 39);
  344.       #$returnValue['pfingstsonntag'] = src_tools_TIME::addDays2SQL($easterday,49);
  345.       $returnValue['pfingstmontag'] = src_tools_TIME :: addDays2SQL($easterday, 50);
  346.       $returnValue['fronleichnam'] = src_tools_TIME :: addDays2SQL($easterday, 60);
  347.       #$returnValue['mariahimmelfahrt'] = $year . "-08-15";
  348.       $returnValue['deutscheeinheit'] = $year . "-10-03";
  349.  
  350.       return $returnValue;
  351.    }
  352. } /* end of class src_tools_TIME */
  353.  
  354. ?>

Documentation generated on Sat, 24 Mar 2007 10:00:10 +0100 by phpDocumentor 1.3.1