Source for file DBMS_FIELD_TIMESTAMP.phpclass

Documentation is available at DBMS_FIELD_TIMESTAMP.phpclass

  1. <?php
  2. /**
  3.   * Class file DBMS_FIELD_TIMESTAMP.phpclass
  4.   *
  5.   * @project    Open CSP-Management
  6.   * @package    dbms_field
  7.   * @category   timestamp
  8.   *
  9.   * @author     Peter Krebs <p.krebs@lvus.at>
  10.   * @copyright  (c) 2002-2005 by LVUS <http://www.lvus.at>
  11.   * @license    http://opensource.org/licenses/gpl-license.php GNU Public License
  12.   *
  13.   ***/
  14.  
  15. /**
  16.   * requirements
  17.   */
  18. pcf_require_class('DBMS_FIELD_DATE',"db/frmClasses/");
  19.  
  20. /**
  21.   * Class DBMS_FIELD_TIMESTAMP
  22.   *
  23.   * Handles mySQL Timestamps Columns
  24.   *
  25.   * @project    Open CSP-Management
  26.   * @package    dbms_field
  27.   * @category   timestamp
  28.   *
  29.   * @author     Peter Krebs <p.krebs@lvus.at>
  30.   * @copyright  (c) 2002-2005 by LVUS <http://www.lvus.at>
  31.   * @license    http://opensource.org/licenses/gpl-license.php GNU Public License
  32.   *
  33.   ***/
  34. class DBMS_FIELD_TIMESTAMP extends DBMS_FIELD_DATE {
  35.     var $className     = "Timestamp";
  36.  
  37.     /**
  38.       * source file of the class
  39.       *
  40.       * @var string $classSrcFile 
  41.       * @since pk-05-01-20
  42.       ***/
  43.     var $classSrcFile=__FILE__;
  44.  
  45.     /**
  46.       * returns an array of field to bie shown in the edit form
  47.       * by using editTbl_echoForm
  48.       *
  49.       * the array is in the form:
  50.       *
  51.       * <code>
  52.       * [_sectionName_]
  53.       *      [TITLE] -> string
  54.       *      [_rowName_]
  55.       *         [FLDLAB]  (complete html code with <td></td>)
  56.       *         [FLDVAL] (complete html code with <td></td>)
  57.       * </code>
  58.       *
  59.       * NOTE as this is not implemented in the whole classTree at the moment ensure all parents use
  60.       * editTbl_echoForm() in theire editTblForm otherwise you'll get a mismatch of field order
  61.       *
  62.       * @param boolean $debug 
  63.       *
  64.       * @returns array
  65.       *
  66.       * @since pk-06-07-16
  67.       *
  68.       ***/
  69.     function editTbl_getFieldEditArr($debug=FALSE) {
  70.         if ($debug) echoDebugMethod(__FILE__,get_class($this),"DBMS_FIELD_DATE::editTbl_getFieldEditArr","",0);
  71.         $a_ret=parent::editTbl_getFieldEditArr($debug);
  72.  
  73.         $a_ret['SHOW']['SHOWDATE']=array(
  74.             'FLDLAB'=>"Datum/Zeit anzeigen:",
  75.             'FLDVAL'=>"
  76.                     <input name=\"SHOWDATE\" type=\"checkbox\" ".($this->showDate ? "checked=\"checked\"" : "")." value=\"1\" /> Datum anzeigen
  77.                     <input name=\"SHOWTIME\" type=\"checkbox\" ".($this->showTime ? "checked=\"checked\"" : "")." value=\"1\" /> Zeit anzeigen"
  78.         );
  79.  
  80.         $a_ret['LAYOUT']['FLD_DATEFORMAT']=array(
  81.             'FLDLAB'=>"Datumsformat: <a href=\"http://at.php.net/manual/en/function.date.php\">?</a>",
  82.             'FLDVAL'=>"
  83.                         <input name=\"fldDateformat\" value=\"".$this->lstDateformat."\" size=\"25\" />
  84.                         <input name=\"hideCalendarBtn\" type=\"checkbox\" value=\"1\" ".($this->hideCalendarBtn ? "checked=\"checked\"" : "")." /> KalenderPopup ausblenden\n
  85.                 "
  86.         );
  87.         $a_ret['LAYOUT']['FLD_TIMEFORMAT']=array(
  88.             'FLDLAB'=>"Zeitformat: <a href=\"http://at.php.net/manual/en/function.date.php\">?</a>",
  89.             'FLDVAL'=>"<input name=\"fldTimeformat\" value=\"".$this->fldTimeformat."\" size=\"25\" />"
  90.         );
  91.  
  92.         $a_ret['LIST']['LST_DATEFORMAT']=array(
  93.             'FLDLAB'=>"Datumsformat: <a href=\"http://at.php.net/manual/en/function.date.php\">?</a>",
  94.             'FLDVAL'=>"<input name=\"lstDateformat\" value=\"".$this->lstDateformat."\" size=\"25\" />"
  95.         );
  96.         $a_ret['LIST']['LST_TIMEFORMAT']=array(
  97.             'FLDLAB'=>"Zeitformat: <a href=\"http://at.php.net/manual/en/function.date.php\">?</a>",
  98.             'FLDVAL'=>"<input name=\"lstTimeformat\" value=\"".$this->lstTimeformat."\" size=\"25\" />"
  99.         );
  100.  
  101.         return $a_ret;
  102.     }
  103.  
  104.  
  105.  
  106.     /**
  107.       * converts a timestamp into a date object
  108.       *
  109.       * if $aValue is an array pcf_Date::setFromArray() is called to transform to a date
  110.       * if $aValue is doubleval pcf_Date::setMySqlTimeStamp() is called
  111.       *
  112.       * @param mixed $aValue 
  113.       * @param boolean $debug 
  114.       *
  115.       * @returns pcf_Date
  116.       *
  117.       ***/
  118.     function getTSDate($aValue,$debug=FALSE) {
  119.         $debug=($debug || $this->fldDebug);
  120.         if ($debug) echo "<p><b>DBMS_FIELD_TIMESTAMP::getTSDate($aValue,....)</b> (".get_class($this).")</p><blockquote>";
  121.  
  122.         $dateObj=new OCSP_DATE();
  123.         if (is_array($aValue)) {
  124.             if ($debug) echo "<b>setFromArray</b><br />";
  125.             $dateObj->setFromArray($aValue);
  126.         } else if (preg_match('/^([0-9]{4})-([0-9]{2})-([0-9]{2}) ([0-9]{2}):([0-9]{2}):([0-9]{2})/',$aValue)) {
  127.             if ($debug) echo "<b>setDateStr</b><br />";
  128.             $dateObj->setDateStr($aValue,$debug);
  129.         } else if (doubleval($aValue)) {
  130.             if ($debug) echo "<b>setMySqlTimeStamp</b><br />";
  131.             $dateObj->setMySqlTimeStamp($aValue); /* <pk-04-12-29 /> */
  132.         } else {
  133.             if ($debug) echo "<b>setDateStr</b><br />";
  134.             $dateObj->setNULL();
  135.         }
  136.  
  137.         if ($debug) echo "<pre>".pcf_object_info($dateObj)."</pre></blockquote>";
  138.  
  139.         return $dateObj;
  140.     }
  141.  
  142.  
  143.     /**
  144.       * returns the html code for the field value input / show
  145.       * adds $this->myName to ${$this->myDataArrName}['_DBMS_FIELDS']
  146.       *
  147.       * @param int $mode 
  148.       * @param mixed $aValue 
  149.       * @param boolean $debug 
  150.       *
  151.       * @returns string
  152.       *
  153.       * @since pk-04-12-29
  154.       *
  155.       * @version pk-05-09-05
  156.       * @version pk-06-01-09
  157.       *
  158.       ***/
  159.     function getFieldTag($mode,$aValue=NULL,$debug=FALSE) {
  160.         $debug=($debug || $this->fldDebug);
  161.         if ($debug) echo "<p><b>DBMS_FIELD_TIMESTAMP::getFieldTag($mode,$aValue,...)</b> (".get_class($this).")</p>";
  162.  
  163.         if (!empty($aValue)) { // <pk-06-08-18>
  164.             $o_dateObj=$this->getTSDate($aValue,$debug);
  165.             if ($o_dateObj->isNULL()) {
  166.                 $aValue=NULL;
  167.             } else {
  168.                 $aValue=$o_dateObj->dateStr("Y-m-d H:i:s");
  169.             }
  170.         }
  171.         switch($mode) {
  172.             case FRM_MODE_NEW:
  173.                 $ret=parent::getFieldTag(FRM_MODE_READONLY,$aValue,$debug);
  174.                 if ($this->enableNew) {
  175.                     $ret.=$this->getFieldTag(FRM_MODE_HIDDEN,$aValue,$debug);
  176.                 }
  177.                 return $ret;
  178.             case FRM_MODE_COPY: // <pk-05-09-05>
  179.                 $ret=parent::getFieldTag(FRM_MODE_READONLY,$aValue,$debug);
  180.                 if ($this->enableCopy) {
  181.                     $ret.=$this->getFieldTag(FRM_MODE_HIDDEN,$aValue,$debug);
  182.                 }
  183.                 return $ret;
  184.             case FRM_MODE_EDIT:
  185.                 $ret=parent::getFieldTag(FRM_MODE_READONLY,$aValue,$debug);
  186.                 if ($this->enableEdit) {
  187.                     $ret.=$this->getFieldTag(FRM_MODE_HIDDEN,$aValue,$debug);
  188.                 }
  189.                 return $ret;
  190.             default:
  191.                 if (!empty($aValue)) { // <pk-06-01-09>
  192.                     return parent::getFieldTag($mode,$aValue,$debug);
  193.                 } else {
  194.                     return "&nbsp;";
  195.                 }  // </pk-06-01-09>
  196.         }
  197.     }
  198.  
  199.     /**
  200.       * returns the field default value
  201.       *
  202.       * if $defaultValue !empty it is returned
  203.       * else getDbDefault is return
  204.       *
  205.       * @return mixed 
  206.       *
  207.       * @version pk-04-08-17
  208.       *
  209.       ***/
  210.     function getDefaultValue($debug=FALSE){
  211.         $debug=($debug || $this->fldDebug);
  212.         if ($debug) echo "<p><b>DBMS_FIELD_TIMESTAMP::getDefaultValue(...)</b> (".get_class($this).")</p>";
  213.         if ((trim(strtoupper($this->defaultValue)) == "NOW()") || (trim(strtoupper($this->defaultValue))=="CURRENT_TIMESTAMP")) {
  214.             $aDate=new OCSP_DATE(FALSE);
  215.             return $aDate->getMySQLTimestamp();
  216.         } else {
  217.             return parent::getDefaultValue($debug);
  218.         }
  219.     }
  220.  
  221.     /**
  222.       * returns the field value
  223.       *
  224.       * @param  string  $aValue     the value
  225.       * @param  array   $err        error array
  226.       * @param  string  $arrName    name of the array to access fieldsarray  gloabl ${$arrName}
  227.       * @param  bool    $debug 
  228.       *
  229.       * @return string 
  230.       *
  231.       * @since   pk-03-12-13
  232.       * @version pk-03-12-13
  233.       * @version pk-06-08-18
  234.       *
  235.       * @todo DBMS_FIELD_TIMESTAMP::getValue() returns MySQL Timestamp format
  236.       ***/
  237.     function getValue($aValue,&$err,$arrName="DBVAL",$debug=FALSE) {
  238.         if ($debug) echo "<hr><p><b>DBMS_FIELD_TIMESTAMP::getValue($aValue,$err,$arrName,$debug)</b> (".get_class($this)."/".$this->myName.")</p>";
  239.         $o_dateObj=$this->getTSDate($aValue,$debug); // <pk-06-08-18 />
  240.         if ($debug) {echo "<pre>";print_r($o_dateObj);echo "</pre>";}
  241.         return $o_dateObj->getMySQLTimestamp();
  242.     }
  243.  
  244.     /**
  245.       * add slashes to the value to add it to a sql command
  246.       *
  247.       * NOTE allways returns DB Now statement
  248.       *
  249.       * @param  string  $aValue     the value
  250.       * @param  array   $err        error array
  251.       * @param  string  $arrName    name of the global array to access field gloabl ${$arrName}
  252.       * @param  bool    $debug 
  253.       *
  254.       * @return string 
  255.       *
  256.       * @version pk-03-12-13
  257.       *
  258.       ***/
  259.     function slashedValue($aValue,&$err,$arrName="DBVAL",$debug=FALSE) {
  260.         if ($debug) echo "<hr><p><b>DBMS_FIELD_TIMESTAMP::slashedValue($aValue,$err,$arrName,$debug)</b> (".get_class($this)."/".$this->myName.")</p>";
  261.         return $GLOBALS[$this->getGlobalDBObjIdx()]->qs_getNowStmt();
  262.     }
  263.  
  264.     /**
  265.       * get a where clause for the search settings
  266.       *
  267.       * $aArr array post values of the serach form
  268.       * return string where clause
  269.       **/
  270.  
  271.     function searchWhere($aArr,$debug=FALSE) {
  272.         if ($debug) echo "<p><b>DMBS_FIELD_TIMESTAMP::searchWhere($aArr,$debug)</b> (".get_class($this).")</p>";
  273.  
  274.         if (!is_array($aArr)) return "";
  275.         if ($debug) {echo "<blockquote><pre>";print_r($aArr);echo "</pre></blockquote>";}
  276.  
  277.         $err="";
  278.         if ($debug) { echo "<pre>"; print_r($aArr); echo "</pre>"; }
  279.  
  280.         if (!empty($aArr['ANDOR']))  {
  281.             $ret=($aArr['ANDOR'] == "OR" ? " OR " : " AND ");
  282.  
  283.             switch($aArr['COMPTYPE']) { // only to verify input
  284.                 case "<":
  285.                 case ">":
  286.                 case "=":
  287.                     $ret.=$this->myTable.".".$this->myName;
  288.                     $ret.=$aArr['COMPTYPE'];
  289.                     global $TEMPDBVAL;$TEMPDBVAL=$aArr;
  290.                     $ret.=parent::slashedValue($TEMPDBVAL,$err,"TEMPDBVAL",$debug);
  291.                     unset($TEMPDBVAL);
  292.                     break;
  293.                 default:
  294.                     echo "COMPTYPE NOT FOUND";
  295.                     return "";
  296.             }
  297.             return $ret;
  298.         } else return "";
  299.     }
  300. } // end class DBMS_FIELD_INT
  301. ?>

Documentation generated on Thu, 08 Jan 2009 17:43:07 +0100 by phpDocumentor 1.4.0a2