php_library/fboprime/utimex.inc

<?php
//$Header: /hl/cvsroots/gpl01/gpl01/webprojs/fboprime/sw/phplib/utimex.inc,v 1.3 2006/09/25 21:11:28 dashley Exp $
//
//utimex.inc--UTIME-related functions that are not needed by the dayview
//            scheduler.
//********************************************************************************
//Copyright (C)2006 David T. Ashley
//********************************************************************************
//This program or source file is free software; you can redistribute it and/or 
//modify it under the terms of the GNU General Public License as published by
//the Free Software Foundation; either version 2 of the License, or (at your 
//option) any later version.
//
//This program or source file is distributed in the hope that it will 
//be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
//MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//GNU General Public License for more details.
//
//You may have received a copy of the GNU General Public License
//along with this program; if not, write to the Free Software
//Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//********************************************************************************
//Dave Ashley, 05/06
//
//This source file contains Unix time functions.
//
require_once("strfunc.inc");           //Necessary to left-zero pad string representations of integers
require_once("timeraw.inc");           //Raw time acquisition.
//
//--------------------------------------------------------------------------------
//Returns a UTIME corresponding to the time (in a coarse sense, meaning that
//fractional seconds are ignored) a certain integer number of seconds offset from
//The minimum and maximum values of the UTIME are used as the floor and ceiling
//limits of the result.
//
function UTIME_time_offset_coarse($ut_in, $offset_in)
   {
   //Extract the integer seconds string.
   $int_secs_string = SubStr($ut_in, 2, 11);

   //Strip off any leading zeros.
   while ((strlen($int_secs_string) > 1) && (SubStr($int_secs_string, 0, 1) == "0"))
      $int_secs_string = SubStr($int_secs_string, 1);

   //Form an integer result that is offset from this integer by the passed
   //value.
   $offset_time = bcadd($int_secs_string, (string)$offset_in);

   //Apply the floor and ceiling.
   if (bccomp($offset_time, "0") == -1)
      {
      //Result is below the Unix epoch.  Apply floor.
      //
      return("UT00000000000000000000");
      }
   else if (bccomp($offset_time, "99999999999") == 1)
      {
      //Result is above the max value that can be represented.  Apply ceiling.
      //
      return("UT99999999999000000000");
      }
   else
      {
      //Result is valid.  Format the string and return.
      $offset_time = (string)$offset_time;
      //
      $offset_time = STRFUNC_pad_left_zero($offset_time, 11);
      return("UT" . $offset_time . "000000000");
      }
   }
//
//--------------------------------------------------------------------------------
//Reformats an UTIME string to include dots at strategic places for more
//human-friendly display.
//
function UTIME_dotted_display_string_a($utime_in)
   {
   if (! is_string($utime_in))
      {
      //Don't know what this is ... it isn't an utime.  Just send it back.
      return($utime_in);
      }
   else if (strlen($utime_in) != 22)
      {
      //This doesn't seem to be the right length for an utime.  Give it back.
      return($utime_in);
      }
   else
      {
      //Seems right.
      return(
            SubStr($utime_in, 0, 2)
            .
            "."
            .
            SubStr($utime_in, 2, 11)
            .
            "."
            .
            SubStr($utime_in, 13, 9)
            );
      }
   }
//
//--------------------------------------------------------------------------------
//End of $RCSfile: utimex.inc,v $.
//--------------------------------------------------------------------------------
?>
1	dashley	35	<?php
2			//$Header: /hl/cvsroots/gpl01/gpl01/webprojs/fboprime/sw/phplib/utimex.inc,v 1.3 2006/09/25 21:11:28 dashley Exp $
3			//
4			//utimex.inc--UTIME-related functions that are not needed by the dayview
5			// scheduler.
6			//********************************************************************************
7			//Copyright (C)2006 David T. Ashley
8			//********************************************************************************
9			//This program or source file is free software; you can redistribute it and/or
10			//modify it under the terms of the GNU General Public License as published by
11			//the Free Software Foundation; either version 2 of the License, or (at your
12			//option) any later version.
13			//
14			//This program or source file is distributed in the hope that it will
15			//be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
16			//MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17			//GNU General Public License for more details.
18			//
19			//You may have received a copy of the GNU General Public License
20			//along with this program; if not, write to the Free Software
21			//Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22			//********************************************************************************
23			//Dave Ashley, 05/06
24			//
25			//This source file contains Unix time functions.
26			//
27			require_once("strfunc.inc"); //Necessary to left-zero pad string representations of integers
28			require_once("timeraw.inc"); //Raw time acquisition.
29			//
30			//--------------------------------------------------------------------------------
31			//Returns a UTIME corresponding to the time (in a coarse sense, meaning that
32			//fractional seconds are ignored) a certain integer number of seconds offset from
33			//The minimum and maximum values of the UTIME are used as the floor and ceiling
34			//limits of the result.
35			//
36			function UTIME_time_offset_coarse($ut_in, $offset_in)
37			{
38			//Extract the integer seconds string.
39			$int_secs_string = SubStr($ut_in, 2, 11);
40
41			//Strip off any leading zeros.
42			while ((strlen($int_secs_string) > 1) && (SubStr($int_secs_string, 0, 1) == "0"))
43			$int_secs_string = SubStr($int_secs_string, 1);
44
45			//Form an integer result that is offset from this integer by the passed
46			//value.
47			$offset_time = bcadd($int_secs_string, (string)$offset_in);
48
49			//Apply the floor and ceiling.
50			if (bccomp($offset_time, "0") == -1)
51			{
52			//Result is below the Unix epoch. Apply floor.
53			//
54			return("UT00000000000000000000");
55			}
56			else if (bccomp($offset_time, "99999999999") == 1)
57			{
58			//Result is above the max value that can be represented. Apply ceiling.
59			//
60			return("UT99999999999000000000");
61			}
62			else
63			{
64			//Result is valid. Format the string and return.
65			$offset_time = (string)$offset_time;
66			//
67			$offset_time = STRFUNC_pad_left_zero($offset_time, 11);
68			return("UT" . $offset_time . "000000000");
69			}
70			}
71			//
72			//--------------------------------------------------------------------------------
73			//Reformats an UTIME string to include dots at strategic places for more
74			//human-friendly display.
75			//
76			function UTIME_dotted_display_string_a($utime_in)
77			{
78			if (! is_string($utime_in))
79			{
80			//Don't know what this is ... it isn't an utime. Just send it back.
81			return($utime_in);
82			}
83			else if (strlen($utime_in) != 22)
84			{
85			//This doesn't seem to be the right length for an utime. Give it back.
86			return($utime_in);
87			}
88			else
89			{
90			//Seems right.
91			return(
92			SubStr($utime_in, 0, 2)
93			.
94			"."
95			.
96			SubStr($utime_in, 2, 11)
97			.
98			"."
99			.
100			SubStr($utime_in, 13, 9)
101			);
102			}
103			}
104			//
105			//--------------------------------------------------------------------------------
106			//End of $RCSfile: utimex.inc,v $.
107			//--------------------------------------------------------------------------------
108			?>