<?xml version="1.0"?><phpdoc><class name="Date_Calc" extends="" undoc="false" access="public"><file>c:/www/apache/doc2//pear/Date/Calc.php</file><doc><author email="monte@ispi.net">Monte Ohrt</author><description>manipulate calendar dates and retrieve dates in a calendarformat. It does not rely on 32-bit system date stamps, soyou can display calendars and compare dates that datepre 1970 and post 2038.This source file is subject to version 2.02 of the PHP license,that is bundled with this package in the file LICENSE, and isavailable at through the world-wide-web athttp://www.php.net/license/2_02.txt.If you did not receive a copy of the PHP license and are unable toobtain it through the world-wide-web, please send a note tolicense@php.net so we can mail you a copy immediately.Copyright (c) 1999, 2000 ispi</description><shortdescription>Date_Calc is a calendar class used to calculate and</shortdescription><version>1.2.2</version></doc><function name="dateNow" undoc="false" access="public"><doc><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">strftime() format to return the date</parameter><return name="" type="string">the current date in specified format</return><description>retrieves the local date using strftime(), which mayor may not be 32-bit safe on your system.</description><shortdescription>Returns the current local date. NOTE: This function</shortdescription></doc></function><function name="isValidDate" undoc="false" access="public"><doc><parameter name="$day" type="string">in format CCYY</parameter><parameter name="$month" type="string">in format MM</parameter><parameter name="$year" type="string">in format DD</parameter><return name="" type="boolean">true /false</return><description/><shortdescription>Returns true for valid date, false for invalid date.</shortdescription></doc></function><function name="isFutureDate" undoc="false" access="public"><doc><parameter name="$day" type="string">in format CCYY</parameter><parameter name="$month" type="string">in format MM</parameter><parameter name="$year" type="string">in format DD</parameter><return name="" type="boolean">true /false</return><description/><shortdescription>Determines if given date is a future date from now.</shortdescription></doc></function><function name="isPastDate" undoc="false" access="public"><doc><parameter name="$day" type="string">in format CCYY</parameter><parameter name="$month" type="string">in format MM</parameter><parameter name="$year" type="string">in format DD</parameter><return name="" type="boolean">true /false</return><description/><shortdescription>Determines if given date is a past date from now.</shortdescription></doc></function><function name="dayOfWeek" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default is current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default is current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default is current local day</parameter><return name="$weekday_number" type="int"/><description/><shortdescription>Returns day of week for given date, 0=Sunday</shortdescription></doc></function><function name="weekOfYear" undoc="false" access="public"><doc><parameter name="$day" type="string">in format CCYY</parameter><parameter name="$month" type="string">in format MM</parameter><parameter name="$year" type="string">in format DD</parameter><return name="$week_number" type="integer"/><description/><shortdescription>Returns week of the year, first Sunday is first day of first week</shortdescription></doc></function><function name="julianDate" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default is current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default is current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default is current local day</parameter><return name="$julian" type="int"/><description/><shortdescription>Returns number of days since 31 December of year before given date.</shortdescription></doc></function><function name="quarterOfYear" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><return name="$year_quarter" type="int"/><description/><shortdescription>Returns quarter of the year for given date</shortdescription></doc></function><function name="beginOfNextMonth" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description/><shortdescription>Returns date of begin of next month of given date.</shortdescription></doc></function><function name="endOfNextMonth" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description/><shortdescription>Returns date of the last day of next month of given date.</shortdescription></doc></function><function name="beginOfPrevMonth" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description/><shortdescription>Returns date of the first day of previous month of given date.</shortdescription></doc></function><function name="endOfPrevMonth" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description/><shortdescription>Returns date of the last day of previous month for given date.</shortdescription></doc></function><function name="nextWeekday" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description>skipping from Friday to Monday.</description><shortdescription>Returns date of the next weekday of given date,</shortdescription></doc></function><function name="prevWeekday" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description>skipping from Monday to Friday.</description><shortdescription>Returns date of the previous weekday,</shortdescription></doc></function><function name="nextDayOfWeek" undoc="false" access="public"><doc><parameter name="$dow" type="int">of week, 0=Sunday</parameter><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">if true and days are same, returns current day</parameter><parameter name="$onOrAfter" default="false" type="boolean">for returned date</parameter><return name="" type="string">date in given format</return><description>from the given date.</description><shortdescription>Returns date of the next specific day of the week</shortdescription></doc></function><function name="prevDayOfWeek" undoc="false" access="public"><doc><parameter name="$dow" type="int">of week, 0=Sunday</parameter><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">if true and days are same, returns current day</parameter><parameter name="$onOrBefore" default="false" type="boolean">for returned date</parameter><return name="" type="string">date in given format</return><description>from the given date.</description><shortdescription>Returns date of the previous specific day of the week</shortdescription></doc></function><function name="nextDayOfWeekOnOrAfter" undoc="false" access="public"><doc><parameter name="$dow" type="int">of week, 0=Sunday</parameter><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description>on or before the given date.</description><shortdescription>Returns date of the next specific day of the week</shortdescription></doc></function><function name="prevDayOfWeekOnOrBefore" undoc="false" access="public"><doc><parameter name="$dow" type="int">of week, 0=Sunday</parameter><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description>on or before the given date.</description><shortdescription>Returns date of the previous specific day of the week</shortdescription></doc></function><function name="nextDay" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description/><shortdescription>Returns date of day after given date.</shortdescription></doc></function><function name="prevDay" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description/><shortdescription>Returns date of day before given date.</shortdescription></doc></function><function name="defaultCentury" undoc="false" access="public"><doc><parameter name="$year" type="string">2 digit year</parameter><return name="" type="string"> 4 digit year</return><description>51-99 is 19, else 20</description><shortdescription>Sets century for 2 digit year.</shortdescription></doc></function><function name="dateDiff" undoc="false" access="public"><doc><parameter name="$day1" type="string">in format CCYY</parameter><parameter name="$month1" type="string">in format MM</parameter><parameter name="$year1" type="string">in format DD</parameter><parameter name="$day2" type="string">in format CCYY</parameter><parameter name="$month2" type="string">in format MM</parameter><parameter name="$year2" type="string">in format DD</parameter><return name="" type="int">absolute number of days between dates,&#x0a;-1 if there is an error.</return><description/><shortdescription>Returns number of days between two given dates.</shortdescription></doc></function><function name="daysInMonth" undoc="false" access="public"><doc><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" type="string" undoc="true"/><return name="" type="int">number of days</return><description/><shortdescription>Find the number of days in the given month.</shortdescription></doc></function><function name="weeksInMonth" undoc="false" access="public"><doc><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format YYCC, default current local year</parameter><return name="" type="int">number of weeks</return><description>determining the number of rows when displaying a typicalmonth calendar.</description><shortdescription>Returns the number of rows on a calendar month. Useful for</shortdescription></doc></function><function name="firstOfMonthWeekday" undoc="false" access="public"><doc><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default to current local year</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format MM, default to current local month</parameter><return name="" type="int">number of weekday for the first day, 0=Sunday</return><description/><shortdescription>Find the day of the week for the first of the month of given date.</shortdescription></doc></function><function name="beginOfMonth" undoc="false" access="public"><doc><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description/><shortdescription>Return date of first day of month of given date.</shortdescription></doc></function><function name="beginOfWeek" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description>using DATE_CALC_BEGIN_WEEKDAY. (can return weekday of prev month.)</description><shortdescription>Find the month day of the beginning of week for given date,</shortdescription></doc></function><function name="endOfWeek" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description>using DATE_CALC_BEGIN_WEEKDAY. (can return weekdayof following month.)</description><shortdescription>Find the month day of the end of week for given date,</shortdescription></doc></function><function name="beginOfNextWeek" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description>using DATE_CALC_BEGIN_WEEKDAY. (can return weekday of prev month.)</description><shortdescription>Find the month day of the beginning of week after given date,</shortdescription></doc></function><function name="beginOfPrevWeek" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description>using DATE_CALC_BEGIN_WEEKDAY. (can return weekday of prev month.)</description><shortdescription>Find the month day of the beginning of week before given date,</shortdescription></doc></function><function name="getCalendarWeek" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="$week" type="array"> [$weekday]</return><description/><shortdescription>Return an array with days in week</shortdescription></doc></function><function name="getCalendarMonth" undoc="false" access="public"><doc><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="$month" type="array"> [$row][$col]</return><description>the given date.</description><shortdescription>Return a set of arrays to construct a calendar month for</shortdescription></doc></function><function name="getCalendarYear" undoc="false" access="public"><doc><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="$year" type="array"> [$month][$row][$col]</return><description>the given date.</description><shortdescription>Return a set of arrays to construct a calendar year for</shortdescription></doc></function><function name="dateToDays" undoc="false" access="public"><doc><parameter name="$day" type="string">in format CCYY</parameter><parameter name="$month" type="string">in format MM</parameter><parameter name="$year" type="string">in format DD</parameter><return name="" type="integer">number of days</return><description>distant unspecified epoch.</description><shortdescription>Converts a date to number of days since a</shortdescription></doc></function><function name="daysToDate" undoc="false" access="public"><doc><parameter name="$days" type="int">of days</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in specified format</return><description/><shortdescription>Converts number of days to a distant unspecified epoch.</shortdescription></doc></function><function name="NWeekdayOfMonth" undoc="false" access="public"><doc><parameter name="$occurance" type="string">: 1=first, 2=second, 3=third, etc.</parameter><parameter name="$dayOfWeek" type="string">: 0=Sunday, 1=Monday, etc.</parameter><parameter name="$month" type="string">in format CCYY</parameter><parameter name="$year" type="string">in format MM</parameter><parameter name="$format" default="&amp;quot;%Y%m%d&amp;quot;" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description>such as the second Saturday of January 2000.</description><shortdescription>Calculates the date of the Nth weekday of the month,</shortdescription></doc></function><function name="dateFormat" undoc="false" access="public"><doc><parameter name="$day" type="string">in format CCYY</parameter><parameter name="$month" type="string">in format MM</parameter><parameter name="$year" type="string">in format DD</parameter><parameter name="$format" type="string">for returned date</parameter><return name="" type="string">date in given format</return><description>strfmt(). This function is used to alleviate theproblem with 32-bit numbers for dates pre 1970or post 2038, as strfmt() has on most systems.Most of the formatting options are compatible.formatting options:%a        abbreviated weekday name (Sun, Mon, Tue)%A        full weekday name (Sunday, Monday, Tuesday)%b        abbreviated month name (Jan, Feb, Mar)%B        full month name (January, February, March)%d        day of month (range 00 to 31)%e        day of month, single digit (range 0 to 31)%E        number of days since unspecified epoch (integer)(%E is useful for passing a date in a URL asan integer value. Then simply usedaysToDate() to convert back to a date.)%j        day of year (range 001 to 366)%m        month as decimal number (range 1 to 12)%n        newline character (\n)%t        tab character (\t)%w        weekday as decimal (0 = Sunday)%U        week number of current year, first sunday as first week%y        year as decimal (range 00 to 99)%Y        year as decimal including century (range 0000 to 9999)%%        literal &amp;apos;%&amp;apos;</description><shortdescription>Formats the date in the given format, much like</shortdescription></doc></function><function name="getYear" undoc="false" access="public"><doc><return name="" type="string">year in format CCYY</return><description/><shortdescription>Returns the current local year in format CCYY</shortdescription></doc></function><function name="getMonth" undoc="false" access="public"><doc><return name="" type="string">month in format MM</return><description/><shortdescription>Returns the current local month in format MM</shortdescription></doc></function><function name="getDay" undoc="false" access="public"><doc><return name="" type="string">day in format DD</return><description/><shortdescription>Returns the current local day in format DD</shortdescription></doc></function><function name="getMonthFullname" undoc="false" access="public"><doc><parameter name="$month" type="string">in format MM</parameter><return name="" type="string">full month name</return><description/><shortdescription>Returns the full month name for the given month</shortdescription></doc></function><function name="getMonthAbbrname" undoc="false" access="public"><doc><parameter name="$month" type="string">in format MM</parameter><parameter name="$length" default="3" type="integer">length of abbreviation, default is 3</parameter><return name="" type="string">abbreviated month name</return><description/><shortdescription>Returns the abbreviated month name for the given month</shortdescription></doc></function><function name="getWeekdayFullname" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><return name="" type="string">full month name</return><description/><shortdescription>Returns the full weekday name for the given date</shortdescription></doc></function><function name="getWeekdayAbbrname" undoc="false" access="public"><doc><parameter name="$day" default="&amp;quot;&amp;quot;" type="string">in format CCYY, default current local year</parameter><parameter name="$month" default="&amp;quot;&amp;quot;" type="string">in format MM, default current local month</parameter><parameter name="$year" default="&amp;quot;&amp;quot;" type="string">in format DD, default current local day</parameter><parameter name="$length" default="3" type="integer">length of abbreviation, default is 3</parameter><return name="" type="string">full month name</return><description/><shortdescription>Returns the abbreviated weekday name for the given date</shortdescription></doc></function><function name="isLeapYear" undoc="true" access="private"><doc><parameter name="$year" type="string" undoc="true"/><return type="void"/></doc></function><constant name="DATE_CALC_BEGIN_WEEKDAY" undoc="true" access="private" case="default: case sensitive">1<doc></doc></constant></class></phpdoc>