| 1 | 1 <html> | 
|  | 2 <head> | 
|  | 3 <title>MayaChemTools:Code:TimeUtil.pm</title> | 
|  | 4 <meta http-equiv="content-type" content="text/html;charset=utf-8"> | 
|  | 5 <link rel="stylesheet" type="text/css" href="../../../css/MayaChemToolsCode.css"> | 
|  | 6 </head> | 
|  | 7 <body leftmargin="20" rightmargin="20" topmargin="10" bottommargin="10"> | 
|  | 8 <br/> | 
|  | 9 <center> | 
|  | 10 <a href="http://www.mayachemtools.org" title="MayaChemTools Home"><img src="../../../images/MayaChemToolsLogo.gif" border="0" alt="MayaChemTools"></a> | 
|  | 11 </center> | 
|  | 12 <br/> | 
|  | 13 <pre> | 
|  | 14 <a name="package-TimeUtil-"></a>   1 <span class="k">package </span><span class="i">TimeUtil</span><span class="sc">;</span> | 
|  | 15    2 <span class="c">#</span> | 
|  | 16    3 <span class="c"># $RCSfile: TimeUtil.pm,v $</span> | 
|  | 17    4 <span class="c"># $Date: 2015/02/28 20:47:30 $</span> | 
|  | 18    5 <span class="c"># $Revision: 1.9 $</span> | 
|  | 19    6 <span class="c">#</span> | 
|  | 20    7 <span class="c"># Author: Manish Sud <msud@san.rr.com></span> | 
|  | 21    8 <span class="c">#</span> | 
|  | 22    9 <span class="c"># Copyright (C) 2015 Manish Sud. All rights reserved.</span> | 
|  | 23   10 <span class="c">#</span> | 
|  | 24   11 <span class="c"># This file is part of MayaChemTools.</span> | 
|  | 25   12 <span class="c">#</span> | 
|  | 26   13 <span class="c"># MayaChemTools is free software; you can redistribute it and/or modify it under</span> | 
|  | 27   14 <span class="c"># the terms of the GNU Lesser General Public License as published by the Free</span> | 
|  | 28   15 <span class="c"># Software Foundation; either version 3 of the License, or (at your option) any</span> | 
|  | 29   16 <span class="c"># later version.</span> | 
|  | 30   17 <span class="c">#</span> | 
|  | 31   18 <span class="c"># MayaChemTools is distributed in the hope that it will be useful, but without</span> | 
|  | 32   19 <span class="c"># any warranty; without even the implied warranty of merchantability of fitness</span> | 
|  | 33   20 <span class="c"># for a particular purpose.  See the GNU Lesser General Public License for more</span> | 
|  | 34   21 <span class="c"># details.</span> | 
|  | 35   22 <span class="c">#</span> | 
|  | 36   23 <span class="c"># You should have received a copy of the GNU Lesser General Public License</span> | 
|  | 37   24 <span class="c"># along with MayaChemTools; if not, see <http://www.gnu.org/licenses/> or</span> | 
|  | 38   25 <span class="c"># write to the Free Software Foundation Inc., 59 Temple Place, Suite 330,</span> | 
|  | 39   26 <span class="c"># Boston, MA, 02111-1307, USA.</span> | 
|  | 40   27 <span class="c">#</span> | 
|  | 41   28 | 
|  | 42   29 <span class="k">use</span> <span class="w">strict</span><span class="sc">;</span> | 
|  | 43   30 <span class="k">use</span> <span class="w">Exporter</span><span class="sc">;</span> | 
|  | 44   31 <span class="k">use</span> <span class="w">Time::localtime</span> <span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 45   32 | 
|  | 46   33 <span class="k">use</span> <span class="w">vars</span> <span class="q">qw(@ISA @EXPORT @EXPORT_OK %EXPORT_TAGS)</span><span class="sc">;</span> | 
|  | 47   34 | 
|  | 48   35 <span class="i">@ISA</span> = <span class="q">qw(Exporter)</span><span class="sc">;</span> | 
|  | 49   36 <span class="i">@EXPORT</span> = <span class="q">qw(CTimeStamp FPFileTimeStamp ISO8601Date ISO8601Time ISO8601TimeStamp PDBFileTimeStamp SDFileTimeStamp TimeStamp MonthNameToNumber MonthNumberToFullName MonthNumberToAbbreviatedName WeekDayNameToNumber WeekDayNumberToFullName WeekDayNumberToAbbreviatedName)</span><span class="sc">;</span> | 
|  | 50   37 <span class="i">@EXPORT_OK</span> = <span class="q">qw()</span><span class="sc">;</span> | 
|  | 51   38 <span class="i">%EXPORT_TAGS</span> = <span class="s">(</span><span class="w">all</span>  <span class="cm">=></span> <span class="s">[</span><span class="i">@EXPORT</span><span class="cm">,</span> <span class="i">@EXPORT_OK</span><span class="s">]</span><span class="s">)</span><span class="sc">;</span> | 
|  | 52   39 | 
|  | 53   40 <span class="c">#</span> | 
|  | 54   41 <span class="c"># Initialize package data...</span> | 
|  | 55   42 <span class="c">#</span> | 
|  | 56   43 <span class="k">my</span><span class="s">(</span><span class="i">%MonthNameToNumber</span><span class="cm">,</span> <span class="i">%MonthNumberToFullNameName</span><span class="cm">,</span> <span class="i">%MonthNumberToAbbreviatedName</span><span class="cm">,</span> <span class="i">%WeekDayNameToNumber</span><span class="cm">,</span> <span class="i">%WeekDayNumberToFullName</span><span class="cm">,</span> <span class="i">%WeekDayNumberToAbbreviatedName</span><span class="s">)</span><span class="sc">;</span> | 
|  | 57   44 <span class="i">_InitializeData</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 58   45 | 
|  | 59   46 <span class="c"># Return CTime as default time stamp for MayaChemTools...</span> | 
|  | 60   47 <span class="c">#</span> | 
|  | 61 <a name="TimeStamp-"></a>  48 <span class="k">sub </span><span class="m">TimeStamp</span> <span class="s">{</span> | 
|  | 62   49   <span class="k">return</span> <span class="i">CTimeStamp</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 63   50 <span class="s">}</span> | 
|  | 64   51 | 
|  | 65   52 <span class="c"># Generate ctime time stamp...</span> | 
|  | 66   53 <span class="c">#</span> | 
|  | 67   54 <span class="c"># Format: WDay Mon MDay HH:MM:SS YYYY</span> | 
|  | 68   55 <span class="c">#</span> | 
|  | 69 <a name="CTimeStamp-"></a>  56 <span class="k">sub </span><span class="m">CTimeStamp</span> <span class="s">{</span> | 
|  | 70   57   <span class="k">my</span><span class="s">(</span><span class="i">$CTimeStamp</span><span class="s">)</span><span class="sc">;</span> | 
|  | 71   58 | 
|  | 72   59   <span class="c"># Take out an extra space inserted between month name and day by ctime...</span> | 
|  | 73   60   <span class="i">$CTimeStamp</span> = <span class="i">Time::localtime::ctime</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 74   61   <span class="i">$CTimeStamp</span> =~ <span class="q">s/[ ]+/ /g</span><span class="sc">;</span> | 
|  | 75   62 | 
|  | 76   63   <span class="k">return</span> <span class="i">$CTimeStamp</span><span class="sc">;</span> | 
|  | 77   64 <span class="s">}</span> | 
|  | 78   65 | 
|  | 79   66 <span class="c"># Generate ISO 8601 timestamp in extended format...</span> | 
|  | 80   67 <span class="c">#</span> | 
|  | 81   68 <span class="c"># Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss]</span> | 
|  | 82   69 <span class="c">#</span> | 
|  | 83 <a name="ISO8601TimeStamp-"></a>  70 <span class="k">sub </span><span class="m">ISO8601TimeStamp</span> <span class="s">{</span> | 
|  | 84   71   <span class="k">my</span><span class="s">(</span><span class="i">$TimeStamp</span><span class="cm">,</span> <span class="i">$Sec</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Hour</span><span class="cm">,</span> <span class="i">$MDay</span><span class="cm">,</span> <span class="i">$Mon</span><span class="cm">,</span> <span class="i">$Year</span><span class="cm">,</span> <span class="i">$WDay</span><span class="cm">,</span> <span class="i">$YDay</span><span class="cm">,</span> <span class="i">$IsDst</span><span class="s">)</span><span class="sc">;</span> | 
|  | 85   72 | 
|  | 86   73   <span class="s">(</span><span class="i">$Sec</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Hour</span><span class="cm">,</span> <span class="i">$MDay</span><span class="cm">,</span> <span class="i">$Mon</span><span class="cm">,</span> <span class="i">$Year</span><span class="cm">,</span> <span class="i">$WDay</span><span class="cm">,</span> <span class="i">$YDay</span><span class="cm">,</span> <span class="i">$IsDst</span><span class="s">)</span> = <span class="i">_LocalTime</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 87   74 | 
|  | 88   75   <span class="i">$TimeStamp</span> = <span class="k">sprintf</span> <span class="q">"%4i-%02i-%02iT%02i:%02i:%02i"</span><span class="cm">,</span> <span class="i">$Year</span><span class="cm">,</span> <span class="i">$Mon</span><span class="cm">,</span> <span class="i">$MDay</span><span class="cm">,</span> <span class="i">$Hour</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Sec</span><span class="sc">;</span> | 
|  | 89   76 | 
|  | 90   77   <span class="k">return</span> <span class="i">$TimeStamp</span><span class="sc">;</span> | 
|  | 91   78 <span class="s">}</span> | 
|  | 92   79 | 
|  | 93   80 <span class="c"># Generate ISO 8601 date...</span> | 
|  | 94   81 <span class="c">#</span> | 
|  | 95   82 <span class="c"># Format: [YYYY]-[MM]-[DD]</span> | 
|  | 96   83 <span class="c">#</span> | 
|  | 97 <a name="ISO8601Date-"></a>  84 <span class="k">sub </span><span class="m">ISO8601Date</span> <span class="s">{</span> | 
|  | 98   85   <span class="k">my</span><span class="s">(</span><span class="i">$Date</span><span class="cm">,</span> <span class="i">$Sec</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Hour</span><span class="cm">,</span> <span class="i">$MDay</span><span class="cm">,</span> <span class="i">$Mon</span><span class="cm">,</span> <span class="i">$Year</span><span class="cm">,</span> <span class="i">$WDay</span><span class="cm">,</span> <span class="i">$YDay</span><span class="cm">,</span> <span class="i">$IsDst</span><span class="s">)</span><span class="sc">;</span> | 
|  | 99   86 | 
|  | 100   87   <span class="s">(</span><span class="i">$Sec</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Hour</span><span class="cm">,</span> <span class="i">$MDay</span><span class="cm">,</span> <span class="i">$Mon</span><span class="cm">,</span> <span class="i">$Year</span><span class="cm">,</span> <span class="i">$WDay</span><span class="cm">,</span> <span class="i">$YDay</span><span class="cm">,</span> <span class="i">$IsDst</span><span class="s">)</span> = <span class="i">_LocalTime</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 101   88 | 
|  | 102   89   <span class="i">$Date</span> = <span class="k">sprintf</span> <span class="q">"%4i-%02i-%02i"</span><span class="cm">,</span> <span class="i">$Year</span><span class="cm">,</span> <span class="i">$Mon</span><span class="cm">,</span> <span class="i">$MDay</span><span class="sc">;</span> | 
|  | 103   90 | 
|  | 104   91   <span class="k">return</span> <span class="i">$Date</span><span class="sc">;</span> | 
|  | 105   92 <span class="s">}</span> | 
|  | 106   93 | 
|  | 107   94 <span class="c"># Generate ISO 8601 time in extended format...</span> | 
|  | 108   95 <span class="c">#</span> | 
|  | 109   96 <span class="c"># Format: [hh]:[mm]:[ss]</span> | 
|  | 110   97 <span class="c">#</span> | 
|  | 111 <a name="ISO8601Time-"></a>  98 <span class="k">sub </span><span class="m">ISO8601Time</span> <span class="s">{</span> | 
|  | 112   99   <span class="k">my</span><span class="s">(</span><span class="i">$Time</span><span class="cm">,</span> <span class="i">$Sec</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Hour</span><span class="s">)</span><span class="sc">;</span> | 
|  | 113  100 | 
|  | 114  101   <span class="s">(</span><span class="i">$Sec</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Hour</span><span class="s">)</span> = <span class="i">_LocalTime</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 115  102 | 
|  | 116  103   <span class="i">$Time</span> = <span class="k">sprintf</span> <span class="q">"%02i:%02i:%02i"</span><span class="cm">,</span> <span class="i">$Hour</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Sec</span><span class="sc">;</span> | 
|  | 117  104 | 
|  | 118  105   <span class="k">return</span> <span class="i">$Time</span><span class="sc">;</span> | 
|  | 119  106 <span class="s">}</span> | 
|  | 120  107 | 
|  | 121  108 <span class="c"># Generate MayaChemTools' FP file timestamp...</span> | 
|  | 122  109 <span class="c">#</span> | 
|  | 123 <a name="FPFileTimeStamp-"></a> 110 <span class="k">sub </span><span class="m">FPFileTimeStamp</span> <span class="s">{</span> | 
|  | 124  111   <span class="k">return</span> <span class="i">CTimeStamp</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 125  112 <span class="s">}</span> | 
|  | 126  113 | 
|  | 127  114 <span class="c"># Generate PDB file timestamp...</span> | 
|  | 128  115 <span class="c">#</span> | 
|  | 129 <a name="PDBFileTimeStamp-"></a> 116 <span class="k">sub </span><span class="m">PDBFileTimeStamp</span> <span class="s">{</span> | 
|  | 130  117   <span class="k">my</span><span class="s">(</span><span class="i">$TimeStamp</span><span class="cm">,</span> <span class="i">$Sec</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Hour</span><span class="cm">,</span> <span class="i">$MDay</span><span class="cm">,</span> <span class="i">$Mon</span><span class="cm">,</span> <span class="i">$Year</span><span class="cm">,</span> <span class="i">$WDay</span><span class="cm">,</span> <span class="i">$YDay</span><span class="cm">,</span> <span class="i">$IsDst</span><span class="cm">,</span> <span class="i">$MonthName</span><span class="s">)</span><span class="sc">;</span> | 
|  | 131  118 | 
|  | 132  119   <span class="s">(</span><span class="i">$Sec</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Hour</span><span class="cm">,</span> <span class="i">$MDay</span><span class="cm">,</span> <span class="i">$Mon</span><span class="cm">,</span> <span class="i">$Year</span><span class="cm">,</span> <span class="i">$WDay</span><span class="cm">,</span> <span class="i">$YDay</span><span class="cm">,</span> <span class="i">$IsDst</span><span class="s">)</span> = <span class="i">_LocalTime</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 133  120 | 
|  | 134  121   <span class="i">$MonthName</span> = <span class="k">uc</span> <span class="i">MonthNumberToAbbreviatedName</span><span class="s">(</span><span class="i">$Mon</span><span class="s">)</span><span class="sc">;</span> | 
|  | 135  122   <span class="i">$Year</span> = <span class="k">substr</span><span class="s">(</span><span class="i">$Year</span><span class="cm">,</span> <span class="n">-2</span><span class="cm">,</span> <span class="n">2</span><span class="s">)</span><span class="sc">;</span> | 
|  | 136  123 | 
|  | 137  124   <span class="i">$TimeStamp</span> = <span class="k">sprintf</span> <span class="q">"%02i-%3s-%2i"</span><span class="cm">,</span> <span class="i">$MDay</span><span class="cm">,</span> <span class="i">$MonthName</span><span class="cm">,</span> <span class="i">$Year</span><span class="sc">;</span> | 
|  | 138  125 | 
|  | 139  126   <span class="k">return</span> <span class="i">$TimeStamp</span><span class="sc">;</span> | 
|  | 140  127 <span class="s">}</span> | 
|  | 141  128 | 
|  | 142  129 <span class="c"># Generate SD file timestamp...</span> | 
|  | 143  130 <span class="c">#</span> | 
|  | 144 <a name="SDFileTimeStamp-"></a> 131 <span class="k">sub </span><span class="m">SDFileTimeStamp</span> <span class="s">{</span> | 
|  | 145  132   <span class="k">my</span><span class="s">(</span><span class="i">$TimeStamp</span><span class="cm">,</span> <span class="i">$Sec</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Hour</span><span class="cm">,</span> <span class="i">$MDay</span><span class="cm">,</span> <span class="i">$Mon</span><span class="cm">,</span> <span class="i">$Year</span><span class="cm">,</span> <span class="i">$WDay</span><span class="cm">,</span> <span class="i">$YDay</span><span class="cm">,</span> <span class="i">$IsDst</span><span class="s">)</span><span class="sc">;</span> | 
|  | 146  133 | 
|  | 147  134   <span class="s">(</span><span class="i">$Sec</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Hour</span><span class="cm">,</span> <span class="i">$MDay</span><span class="cm">,</span> <span class="i">$Mon</span><span class="cm">,</span> <span class="i">$Year</span><span class="cm">,</span> <span class="i">$WDay</span><span class="cm">,</span> <span class="i">$YDay</span><span class="cm">,</span> <span class="i">$IsDst</span><span class="s">)</span> = <span class="i">_LocalTime</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 148  135 | 
|  | 149  136   <span class="i">$Year</span> = <span class="k">substr</span><span class="s">(</span><span class="i">$Year</span><span class="cm">,</span> <span class="n">-2</span><span class="cm">,</span> <span class="n">2</span><span class="s">)</span><span class="sc">;</span> | 
|  | 150  137 | 
|  | 151  138   <span class="i">$TimeStamp</span> = <span class="k">sprintf</span> <span class="q">"%02i%02i%02i%02i%02i"</span><span class="cm">,</span> <span class="i">$Mon</span><span class="cm">,</span> <span class="i">$MDay</span><span class="cm">,</span> <span class="i">$Year</span><span class="cm">,</span> <span class="i">$Hour</span><span class="cm">,</span> <span class="i">$Min</span><span class="sc">;</span> | 
|  | 152  139 | 
|  | 153  140   <span class="k">return</span> <span class="i">$TimeStamp</span><span class="sc">;</span> | 
|  | 154  141 <span class="s">}</span> | 
|  | 155  142 | 
|  | 156  143 <span class="c"># Get local time with modifications to data returned by native localtime function...</span> | 
|  | 157  144 <span class="c">#</span> | 
|  | 158 <a name="_LocalTime-"></a> 145 <span class="k">sub </span><span class="m">_LocalTime</span> <span class="s">{</span> | 
|  | 159  146   <span class="k">my</span><span class="s">(</span><span class="i">$Sec</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Hour</span><span class="cm">,</span> <span class="i">$MDay</span><span class="cm">,</span> <span class="i">$Mon</span><span class="cm">,</span> <span class="i">$Year</span><span class="cm">,</span> <span class="i">$WDay</span><span class="cm">,</span> <span class="i">$YDay</span><span class="cm">,</span> <span class="i">$IsDst</span><span class="s">)</span><span class="sc">;</span> | 
|  | 160  147 | 
|  | 161  148   <span class="s">(</span><span class="i">$Sec</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Hour</span><span class="cm">,</span> <span class="i">$MDay</span><span class="cm">,</span> <span class="i">$Mon</span><span class="cm">,</span> <span class="i">$Year</span><span class="cm">,</span> <span class="i">$WDay</span><span class="cm">,</span> <span class="i">$YDay</span><span class="cm">,</span> <span class="i">$IsDst</span><span class="s">)</span> = <span class="k">localtime</span><span class="sc">;</span> | 
|  | 162  149 | 
|  | 163  150   <span class="i">$Mon</span> += <span class="n">1</span><span class="sc">;</span> | 
|  | 164  151   <span class="i">$Year</span> += <span class="n">1900</span><span class="sc">;</span> | 
|  | 165  152 | 
|  | 166  153   <span class="k">return</span> <span class="s">(</span><span class="i">$Sec</span><span class="cm">,</span> <span class="i">$Min</span><span class="cm">,</span> <span class="i">$Hour</span><span class="cm">,</span> <span class="i">$MDay</span><span class="cm">,</span> <span class="i">$Mon</span><span class="cm">,</span> <span class="i">$Year</span><span class="cm">,</span> <span class="i">$WDay</span><span class="cm">,</span> <span class="i">$YDay</span><span class="cm">,</span> <span class="i">$IsDst</span><span class="s">)</span><span class="sc">;</span> | 
|  | 167  154 <span class="s">}</span> | 
|  | 168  155 | 
|  | 169  156 <span class="c"># Return month number from full or three letter abbreviated month name...</span> | 
|  | 170 <a name="MonthNameToNumber-"></a> 157 <span class="k">sub </span><span class="m">MonthNameToNumber</span> <span class="s">{</span> | 
|  | 171  158   <span class="k">my</span><span class="s">(</span><span class="i">$Name</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 172  159 | 
|  | 173  160   <span class="k">return</span> <span class="s">(</span><span class="k">exists</span> <span class="i">$MonthNameToNumber</span>{<span class="k">lc</span> <span class="i">$Name</span>}<span class="s">)</span> ? <span class="i">$MonthNameToNumber</span>{<span class="k">lc</span> <span class="i">$Name</span>} <span class="co">:</span> <span class="q">''</span><span class="sc">;</span> | 
|  | 174  161 <span class="s">}</span> | 
|  | 175  162 | 
|  | 176  163 <span class="c"># Return full month name from month number...</span> | 
|  | 177 <a name="MonthNumberToFullName-"></a> 164 <span class="k">sub </span><span class="m">MonthNumberToFullName</span> <span class="s">{</span> | 
|  | 178  165   <span class="k">my</span><span class="s">(</span><span class="i">$Number</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 179  166 | 
|  | 180  167   <span class="k">return</span> <span class="s">(</span><span class="k">exists</span> <span class="i">$MonthNumberToFullNameName</span>{<span class="i">$Number</span>}<span class="s">)</span> ? <span class="i">$MonthNumberToFullNameName</span>{<span class="i">$Number</span>} <span class="co">:</span> <span class="q">''</span><span class="sc">;</span> | 
|  | 181  168 <span class="s">}</span> | 
|  | 182  169 | 
|  | 183  170 <span class="c"># Return three letter abbreviated month name from month number...</span> | 
|  | 184 <a name="MonthNumberToAbbreviatedName-"></a> 171 <span class="k">sub </span><span class="m">MonthNumberToAbbreviatedName</span> <span class="s">{</span> | 
|  | 185  172   <span class="k">my</span><span class="s">(</span><span class="i">$Number</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 186  173 | 
|  | 187  174   <span class="k">return</span> <span class="s">(</span><span class="k">exists</span> <span class="i">$MonthNumberToAbbreviatedName</span>{<span class="i">$Number</span>}<span class="s">)</span> ? <span class="i">$MonthNumberToAbbreviatedName</span>{<span class="i">$Number</span>} <span class="co">:</span> <span class="q">''</span><span class="sc">;</span> | 
|  | 188  175 <span class="s">}</span> | 
|  | 189  176 | 
|  | 190  177 <span class="c"># Return week daty number from full or three letter abbreviated week day name...</span> | 
|  | 191 <a name="WeekDayNameToNumber-"></a> 178 <span class="k">sub </span><span class="m">WeekDayNameToNumber</span> <span class="s">{</span> | 
|  | 192  179   <span class="k">my</span><span class="s">(</span><span class="i">$Name</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 193  180 | 
|  | 194  181   <span class="k">return</span> <span class="s">(</span><span class="k">exists</span> <span class="i">$WeekDayNameToNumber</span>{<span class="k">lc</span> <span class="i">$Name</span>}<span class="s">)</span> ? <span class="i">$WeekDayNameToNumber</span>{<span class="k">lc</span> <span class="i">$Name</span>} <span class="co">:</span> <span class="q">''</span><span class="sc">;</span> | 
|  | 195  182 <span class="s">}</span> | 
|  | 196  183 | 
|  | 197  184 <span class="c"># Return full week day name from week day number...</span> | 
|  | 198 <a name="WeekDayNumberToFullName-"></a> 185 <span class="k">sub </span><span class="m">WeekDayNumberToFullName</span> <span class="s">{</span> | 
|  | 199  186   <span class="k">my</span><span class="s">(</span><span class="i">$Number</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 200  187 | 
|  | 201  188   <span class="k">return</span> <span class="s">(</span><span class="k">exists</span> <span class="i">$WeekDayNumberToFullName</span>{<span class="i">$Number</span>}<span class="s">)</span> ? <span class="i">$WeekDayNumberToFullName</span>{<span class="i">$Number</span>} <span class="co">:</span> <span class="q">''</span><span class="sc">;</span> | 
|  | 202  189 <span class="s">}</span> | 
|  | 203  190 | 
|  | 204  191 <span class="c"># Return three letter abbreviated week day name from week day number...</span> | 
|  | 205 <a name="WeekDayNumberToAbbreviatedName-"></a> 192 <span class="k">sub </span><span class="m">WeekDayNumberToAbbreviatedName</span> <span class="s">{</span> | 
|  | 206  193   <span class="k">my</span><span class="s">(</span><span class="i">$Number</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 207  194 | 
|  | 208  195   <span class="k">return</span> <span class="s">(</span><span class="k">exists</span> <span class="i">$WeekDayNumberToAbbreviatedName</span>{<span class="i">$Number</span>}<span class="s">)</span> ? <span class="i">$WeekDayNumberToAbbreviatedName</span>{<span class="i">$Number</span>} <span class="co">:</span> <span class="q">''</span><span class="sc">;</span> | 
|  | 209  196 <span class="s">}</span> | 
|  | 210  197 | 
|  | 211  198 <span class="c"># Initialize week/month day/name data...</span> | 
|  | 212  199 <span class="c">#</span> | 
|  | 213 <a name="_InitializeData-"></a> 200 <span class="k">sub </span><span class="m">_InitializeData</span> <span class="s">{</span> | 
|  | 214  201 | 
|  | 215  202   <span class="i">%MonthNameToNumber</span> = <span class="s">(</span><span class="q">'january'</span> <span class="cm">=></span> <span class="n">1</span><span class="cm">,</span> <span class="q">'february'</span> <span class="cm">=></span> <span class="n">2</span><span class="cm">,</span> <span class="q">'march'</span> <span class="cm">=></span> <span class="n">3</span><span class="cm">,</span> <span class="q">'april'</span> <span class="cm">=></span> <span class="n">4</span><span class="cm">,</span> | 
|  | 216  203                         <span class="q">'may'</span> <span class="cm">=></span> <span class="n">5</span><span class="cm">,</span> <span class="q">'june'</span> <span class="cm">=></span> <span class="n">6</span><span class="cm">,</span> <span class="q">'july'</span> <span class="cm">=></span> <span class="n">7</span><span class="cm">,</span> <span class="q">'august'</span> <span class="cm">=></span> <span class="n">8</span><span class="cm">,</span> | 
|  | 217  204                         <span class="q">'september'</span> <span class="cm">=></span> <span class="n">9</span><span class="cm">,</span> <span class="q">'october'</span> <span class="cm">=></span> <span class="n">10</span><span class="cm">,</span> <span class="q">'november'</span> <span class="cm">=></span> <span class="n">11</span><span class="cm">,</span> <span class="q">'december'</span> <span class="cm">=></span> <span class="n">12</span><span class="cm">,</span> | 
|  | 218  205                         <span class="q">'jan'</span> <span class="cm">=></span> <span class="n">1</span><span class="cm">,</span> <span class="q">'feb'</span> <span class="cm">=></span> <span class="n">2</span><span class="cm">,</span> <span class="q">'mar'</span> <span class="cm">=></span> <span class="n">3</span><span class="cm">,</span> <span class="q">'apr'</span> <span class="cm">=></span> <span class="n">4</span><span class="cm">,</span> | 
|  | 219  206                         <span class="q">'may'</span> <span class="cm">=></span> <span class="n">5</span><span class="cm">,</span> <span class="q">'jun'</span> <span class="cm">=></span> <span class="n">6</span><span class="cm">,</span> <span class="q">'jul'</span> <span class="cm">=></span> <span class="n">7</span><span class="cm">,</span> <span class="q">'aug'</span> <span class="cm">=></span> <span class="n">8</span><span class="cm">,</span> | 
|  | 220  207                         <span class="q">'sep'</span> <span class="cm">=></span> <span class="n">9</span><span class="cm">,</span> <span class="q">'oct'</span> <span class="cm">=></span> <span class="n">10</span><span class="cm">,</span> <span class="q">'nov'</span> <span class="cm">=></span> <span class="n">11</span><span class="cm">,</span> <span class="q">'dec'</span> <span class="cm">=></span> <span class="n">12</span><span class="s">)</span><span class="sc">;</span> | 
|  | 221  208 | 
|  | 222  209   <span class="i">%MonthNumberToFullNameName</span> = <span class="s">(</span><span class="n">1</span> <span class="cm">=></span> <span class="q">'January'</span><span class="cm">,</span> <span class="n">2</span> <span class="cm">=></span> <span class="q">'February'</span><span class="cm">,</span> <span class="n">3</span> <span class="cm">=></span> <span class="q">'March'</span><span class="cm">,</span> <span class="n">4</span> <span class="cm">=></span> <span class="q">'April'</span><span class="cm">,</span> | 
|  | 223  210                                 <span class="n">5</span> <span class="cm">=></span> <span class="q">'May'</span><span class="cm">,</span> <span class="n">6</span> <span class="cm">=></span> <span class="q">'June'</span><span class="cm">,</span> <span class="n">7</span> <span class="cm">=></span> <span class="q">'July'</span><span class="cm">,</span> <span class="n">8</span> <span class="cm">=></span> <span class="q">'August'</span><span class="cm">,</span> | 
|  | 224  211                                 <span class="n">9</span> <span class="cm">=></span> <span class="q">'September'</span><span class="cm">,</span> <span class="n">10</span> <span class="cm">=></span> <span class="q">'October'</span><span class="cm">,</span> <span class="n">11</span> <span class="cm">=></span> <span class="q">'November'</span><span class="cm">,</span> <span class="n">12</span> <span class="cm">=></span> <span class="q">'December'</span><span class="s">)</span><span class="sc">;</span> | 
|  | 225  212 | 
|  | 226  213   <span class="i">%MonthNumberToAbbreviatedName</span> = <span class="s">(</span><span class="n">1</span> <span class="cm">=></span> <span class="q">'Jan'</span><span class="cm">,</span> <span class="n">2</span> <span class="cm">=></span> <span class="q">'Feb'</span><span class="cm">,</span> <span class="n">3</span> <span class="cm">=></span> <span class="q">'Mar'</span><span class="cm">,</span> <span class="n">4</span> <span class="cm">=></span> <span class="q">'Apr'</span><span class="cm">,</span> | 
|  | 227  214                                    <span class="n">5</span> <span class="cm">=></span> <span class="q">'May'</span><span class="cm">,</span> <span class="n">6</span> <span class="cm">=></span> <span class="q">'Jun'</span><span class="cm">,</span> <span class="n">7</span> <span class="cm">=></span> <span class="q">'Jul'</span><span class="cm">,</span> <span class="n">8</span> <span class="cm">=></span> <span class="q">'Aug'</span><span class="cm">,</span> | 
|  | 228  215                                    <span class="n">9</span> <span class="cm">=></span> <span class="q">'Sep'</span><span class="cm">,</span> <span class="n">10</span> <span class="cm">=></span> <span class="q">'Oct'</span><span class="cm">,</span> <span class="n">11</span> <span class="cm">=></span> <span class="q">'Nov'</span><span class="cm">,</span> <span class="n">12</span> <span class="cm">=></span> <span class="q">'Dec'</span><span class="s">)</span><span class="sc">;</span> | 
|  | 229  216 | 
|  | 230  217   <span class="i">%WeekDayNameToNumber</span> = <span class="s">(</span><span class="q">'sunday'</span> <span class="cm">=></span> <span class="n">1</span><span class="cm">,</span> <span class="q">'monday'</span> <span class="cm">=></span> <span class="n">2</span><span class="cm">,</span> <span class="q">'tuesday'</span> <span class="cm">=></span> <span class="n">3</span><span class="cm">,</span> <span class="q">'wednesday'</span> <span class="cm">=></span> <span class="n">4</span><span class="cm">,</span> | 
|  | 231  218                           <span class="q">'thursday'</span> <span class="cm">=></span> <span class="n">5</span><span class="cm">,</span> <span class="q">'friday'</span> <span class="cm">=></span> <span class="n">6</span><span class="cm">,</span> <span class="q">'saturday'</span> <span class="cm">=></span> <span class="n">7</span><span class="cm">,</span> | 
|  | 232  219                           <span class="q">'sun'</span> <span class="cm">=></span> <span class="n">1</span><span class="cm">,</span> <span class="q">'mon'</span> <span class="cm">=></span> <span class="n">2</span><span class="cm">,</span> <span class="q">'tue'</span> <span class="cm">=></span> <span class="n">3</span><span class="cm">,</span> <span class="q">'wed'</span> <span class="cm">=></span> <span class="n">4</span><span class="cm">,</span> | 
|  | 233  220                           <span class="q">'thu'</span> <span class="cm">=></span> <span class="n">5</span><span class="cm">,</span> <span class="q">'fri'</span> <span class="cm">=></span> <span class="n">6</span><span class="cm">,</span> <span class="q">'sat'</span> <span class="cm">=></span> <span class="n">7</span><span class="s">)</span><span class="sc">;</span> | 
|  | 234  221 | 
|  | 235  222   <span class="i">%WeekDayNumberToFullName</span> = <span class="s">(</span><span class="n">1</span> <span class="cm">=></span> <span class="q">'Sunday'</span><span class="cm">,</span> <span class="n">2</span> <span class="cm">=></span> <span class="q">'Monday'</span><span class="cm">,</span> <span class="n">3</span> <span class="cm">=></span> <span class="q">'Tuesday'</span><span class="cm">,</span> | 
|  | 236  223                               <span class="n">4</span> <span class="cm">=></span> <span class="q">'Wednesday'</span><span class="cm">,</span> <span class="n">5</span> <span class="cm">=></span> <span class="q">'Thursday'</span><span class="cm">,</span> <span class="n">6</span> <span class="cm">=></span> <span class="q">'Friday'</span><span class="cm">,</span> <span class="n">7</span> <span class="cm">=></span> <span class="q">'Saturday'</span><span class="s">)</span><span class="sc">;</span> | 
|  | 237  224 | 
|  | 238  225   <span class="i">%WeekDayNumberToAbbreviatedName</span> = <span class="s">(</span><span class="n">1</span> <span class="cm">=></span> <span class="q">'Sun'</span><span class="cm">,</span> <span class="n">2</span> <span class="cm">=></span> <span class="q">'Mon'</span><span class="cm">,</span> <span class="n">3</span> <span class="cm">=></span> <span class="q">'Tue'</span><span class="cm">,</span> | 
|  | 239  226                                      <span class="n">4</span> <span class="cm">=></span> <span class="q">'Wed'</span><span class="cm">,</span> <span class="n">5</span> <span class="cm">=></span> <span class="q">'Thu'</span><span class="cm">,</span> <span class="n">6</span> <span class="cm">=></span> <span class="q">'Fri'</span><span class="cm">,</span> <span class="n">7</span> <span class="cm">=></span> <span class="q">'Sat'</span><span class="s">)</span><span class="sc">;</span> | 
|  | 240  227 <span class="s">}</span> | 
|  | 241  228 | 
|  | 242 <a name="EOF-"></a></pre> | 
|  | 243 <p> </p> | 
|  | 244 <br /> | 
|  | 245 <center> | 
|  | 246 <img src="../../../images/h2o2.png"> | 
|  | 247 </center> | 
|  | 248 </body> | 
|  | 249 </html> |