<?php
/*------------------------------*/
/*
Titre : Date Class
Auteur : freemh
Date édition : 06 Jan 2009
*/
/*------------------------------*/
//===========================================================================
// DateClass
//
// Author: Steve Powell info@scrimpnet.com
// Licensing: GNU Lesser General Public License
// Date: Copyright (c) 2004 scrimpnet.com
//
// Please feel free to email me with any questions, suggestions, or problems.
//
// Public member functions. See member function comments for more complete
// documentation.
//
// SetDate() DateClass set class to a specific date/time
// DatePart() mixed return specific part of the date class
// Add() adjust date by months, days, years, hours, minutes, seconds
// Year() integer return class year
// Month() integer return class month (1-12)
// Day() integer return class day of month (1-31)
// Hours() integer return class hour (0-23)
// Minutes() integer return class minutes (0-59)
// Seconds() integer return class seconds (0-59)
// TimeStamp() integer return PHP base timestamp for class
// BOW() DateClass return first day of week in new DateClass
// EOW() DateClass return last day of week in new DateClass
// BOM() DateClass return first day of month in new DateClass
// EOM() DateClass return last day of month in new DateClass
// Quarter() Integer return quarter (1-4) for class
// BOQ() DateClass return beginning of quarter in new DateClass
// EOQ() DateClass return end of quarter in new DateClass
// BOY() DateClass return beginning of year in new DateClass
// EOY() DateClass return end of year in new DateClass
// ToString() DateClass return a formatted date/time string
// UTC() DateClass return UTC date/time in new DateClass
//
// Most functions take an optional <$dateTime> parameter. If this parameter is
// used it will adjust the class value to <$dateTime> before performing the
// requested action. <$dateTime> can be:
// string 14-JAN-2004 any format that can be parsed by PHP.strtotime()
// 5/15/2004 using the GNU date syntax. These are only
// 2004-03-12 17:35 examples
// integer 1072879687 PHP timestamp
// object (DateClass) existing date class
//
// CUSTOMIZATION HINTS/IDEAS
// (1) The _parseDate() function is responsible for taking input and converting
// it into a PHP timestamp value. Modify this routine to allow class to
// be able to handle more date formats
// (2) Expand class to have better UTC or timezone awareness
// (3) Allow class to handle years that begin on different months
// i.e. Fiscal year starting 4/1/xxxx or 10/1/xxxx
//
// NOTES
// (1) This source code contains many functions you may not need and it
// contains thorough comments. You are free to remove any you
// don't need but you may not remove the licensing or copyright information.
//
// LICENSING
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
//
// This library 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
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
//
//=============================================================================
class DateClass
{
//----------------------------
// private member variables
//----------------------------
var $_Date; //base timestamp value for this class
var $_datePart; // array of returned by getdate($_Date)
var $_format; // last format passed to ToString()
//========================================================
// constructor
//========================================================
function DateClass($dateTime="")
{
$this->_format = "Y-m-d H:i:s";
if (!$dateTime)
else
$this->SetDate($dateTime);
} //constructor()
//========================================================
//$this->SetDate
//
// Take <$dateTime> and attempt to convert it into a
// timestamp variable. If a string then string must
// be in standard format. If an integer it must be
// a valid timestamp variable. If nothing is passed
// defaults to current time.
//
// NOTE: the entire class depends on parsing $dateTime
// correctly. This is the only place where the
// private timestamp $_Date is directly modified.
//========================================================
function SetDate($dateTime="")
{
$oldStamp = $this->TimeStamp();
//---------------------------------------------------
// try to convert $dateTime to a time stamp
//---------------------------------------------------
if ($dateTime=="")
else
$this->_Date = $this->_parseDate($dateTime);
//---------------------------------------------------
// parse out date/time components if new timestamp
// is different than previous timestamp. This is
// done only once per value so that repeated calls
// to member functions do no have to repeatedly
// reparse the timestamp
//---------------------------------------------------
if ($oldStamp != $this->TimeStamp())
{
$this->_datePart = getdate($this->TimeStamp());
}
return $this;
} //SetDate()
//========================================================
// _parseDate (private)
//
// Convert $dateTime into a timestamp.
//
// Return: timestamp value of <$dateTime>
//
// NOTE: This is the only place where a date is parsed
// into a timestamp. Modify this routine to
// accept other types of date/time formats
//========================================================
function _parseDate($dateTime="")
{
$ts = ; // timestamp of parsed date
{
case "string": // <== modify to accomodate more date formats
$ts=strtotime($dateTime);
break;
case "integer":
$ts=$dateTime;
break;
case "object":
{
$ts = $dateTime->TimeStamp();
}
} //switch
return $ts;
} //_parseDate()
//=========================================================
// DatePart
//
// Returns specific part of current date/time of class.
// If $dateTime is passed then $dateTime replaces value
// of class.
//
// $datePart must conform to valid parameters of getdate()
// seconds mday year yday
// minutes wday month
// hours weekday mon timestamp
//=========================================================
function DatePart($datePart="",$dateTime="")
{
if ($dateTime) $this->SetDate($dateTime);
if ($datePart=="timestamp") $datePart = ;
return $this->_datePart[$datePart];
} //DatePart()
//=========================================================
// Retrieve parts of date structure
//=========================================================
function Year($dateTime="")
{
if ($dateTime) $this->SetDate($dateTime);
return $this->DatePart("year");
}
function Month($dateTime="")
{
if ($dateTime) $this->SetDate($dateTime);
return $this->DatePart("mon");
}
function Day($dateTime="")
{
if ($dateTime) $this->SetDate($dateTime);
return $this->DatePart("mday");
}
function Hours($dateTime="")
{
if ($dateTime) $this->SetDate($dateTime);
return $this->DatePart("hours");
}
function Minutes($dateTime="")
{
if ($dateTime) $this->SetDate($dateTime);
return $this->DatePart("minutes");
}
function Seconds($dateTime="")
{
if ($dateTime) $this->SetDate($dateTime);
return $this->DatePart("seconds");
}
//===========================================================
// Add()
//
// Adjusts <$adjustPart> of class date by <$adustValue>.
//
// Return a reference to this class that contains adjusted
// timestamp.
//
// <$datePart> string part of date to adjust. The parameter
// can use any class defined variables
// and most of corresponding keys from
// the date() and getdate() functions.
//
// "year" | "years" | "y"
// "months" | "month" | "mon"
// "days" | "day" | "mday" | "d"
// "hours" | "hour" | "g" |
// "minutes" | "minute" | "i"
// "seconds" | "second" | "s"
// <$adjustValue> int Amount to adjust date by. Use negative
// to move backwards in time.
//===========================================================
function Add($datePart,$adjustValue,$dateTime="")
{
if ($dateTime) $this->SetDate($dateTime);
if (!
is_int($adjustValue)) $adjustValue = ;
$year = $this->Year();
$month = $this->Month();
$day = $this->Day();
$hour = $this->Hours();
$min = $this->Minutes();
$sec = $this->Seconds();
{
case "months":
case "month": // month
case "mon":
$this->SetDate(mktime($hour,$min,$sec,$month+$adjustValue,$day,
$year));
break;
case "day": // day
case "days":
case "d":
case "mday":
$this->SetDate(mktime($hour,$min,$sec,$month,$day+$adjustValue,
$year));
break;
case "year": // year
case "years":
case "y":
$this->SetDate(mktime($hour,$min,$sec,$month,$day, $year+
$adjustValue));
break;
case "hours": // hour
case "hour":
case "g": case "G": case "H": case "h":
$this->SetDate(mktime($hour+$adjustValue,$min,$sec,$month,$day,
$year));
break;
case "minutes": // minute
case "minute":
case "i":
$this->SetDate(mktime($hour,$min+$adjustValue,$sec,$month,$day,
$year));
break;
case "seconds": // seconds
case "second":
case "s":
$this->SetDate(mktime($hour,$min,$sec+$adjustValue,$month,$day,
$year));
break;
} //switch
return $this;
} //Add()
//===========================================================
// TimeStamp()
//
// Return timestamp value this class represents.
//
// NOTE: This is the only place the class reads _Date directly
//===========================================================
function TimeStamp($dateTime="")
{
if ($dateTime) $this->SetDate($DateTime);
return $this->_Date;
} //TimeStamp()
//===========================================================
// BOW() - Beginning of Week
//
// Return date for first day of week. If class
// has time component that remains the same except it is
// now the first day of the week
//
// Returned value is in a new DateClass instance and does
// not modify existing class value
//===========================================================
function BOW($dateTime="")
{
if ($dateTime) $this->SetDate($DateTime);
$dt = new DateClass($this->TimeStamp());
$wday = $dt->DatePart("wday");
$wday = $wday*-1;
$dt->Add("mday",$wday);
return $dt;
} //BOW()
//===========================================================
// EOW() - End of Week
//
// Return date for last day of the week. If class
// has time component that remains the same except it is
// now the last day of the week
//
// Returned value is in a new DateClass instance and does
// not modify existing class value
//===========================================================
function EOW($dateTime="")
{
if ($dateTime) $this->SetDate($DateTime);
$dt = new DateClass($this->TimeStamp());
return $dt->Add("day",6-$dt->DatePart("wday"));
}
//===========================================================
// BOM() - Beginning of Month
//
// Return first day of month for the class date. If class
// has time component that remains the same except it is
// now the first day of the month
//
// Returned value is in a new DateClass instance and does
// not modify existing class value
//===========================================================
function BOM($dateTime="")
{
if ($dateTime) $this->SetDate($DateTime);
$dt = new DateClass($this->TimeStamp());
$dt->Add("day",-1*($dt->Day()));
return $dt;
} //BOM()
//===========================================================
// EOM() - End of Month
//
// Return last day of month for the class date. If class
// has time component that remains the same except it is
// now the last day of the month
//
// Returned value is in a new DateClass instance and does
// not modify existing class value
//===========================================================
function EOM($dateTime="")
{
if ($dateTime) $this->SetDate($DateTime);
$dt = new DateClass($this->TimeStamp());
$dt->Add("month",1);
$dtBOM=$dt->BOM();
$dtBOM->Add("day",-1);
return $dtBOM;
} //EOM()
//===========================================================
// BOY() - Beginning of Year
//
// Return first day of year. If class
// has time component that remains the same except it is
// now the first day of the year
//
// Returned value is in a new DateClass instance and does
// not modify existing class value
//===========================================================
function BOY($dateTime="")
{
if ($dateTime) $this->SetDate($DateTime);
$dt = new DateClass($this->TimeStamp());
$dt->Add("month",-1*($dt->Month()-1));
return $dt->BOM();
} //BOY()
//===========================================================
// EOY() - End of Year
//
// Return last day of year. If class
// has time component that remains the same except it is
// now the last day of the year
//
// Returned value is in a new DateClass instance and does
// not modify existing class value
//===========================================================
function EOY($dateTime="")
{
if ($dateTime) $this->SetDate($dateTime);
$dt = new DateClass($this->TimeStamp());
$dt->Add("year",1);
$dtEOY = $dt->BOY();
$dtEOY->Add("day",-1);
return $dtEOY;
} //EOY()
//===========================================================
// Quarter()
//
// Return the quarter (1-4) for current value of the class
//===========================================================
function Quarter($qDate="",$dateTime="")
{
if ($dateTime) $this->SetDate($dateTime);
switch($this->Month())
{
case 1: case 2: case 3: return 1;break;
case 4: case 5: case 6: return 2; break;
case 7: case 8: case 9: return 3; break;
case 10: case 11: case 12: return 4;break;
}
} //Quarter()
//===========================================================
// BOQ() - Beginning of Quarter
//
// Return first day of <$quarter> or the quarter of the current
// value of the class. If class
// has time component that remains the same except it is
// now the first day of the quarter.
//
// <$quarter> integer (1-4)
//
// Returned value is in a new DateClass instance and does
// not modify existing class value
//===========================================================
function BOQ($quarter=,$dateTime="")
{
if ($dateTime) $this->SetDate($DateTime);
if (!$quarter) $quarter = $this->Quarter();
switch($quarter)
{
case 1: $month = 1;break;
case 2: $month = 4; break;
case 3: $month = 7; break;
case 4: $month = 10;break;
}
$dt = new DateClass(mktime($this->Hours(),$this->Minutes(),$this->
Seconds(),$month,1,$this->Year()));
return $dt;
} //BOQ()
//===========================================================
// EOQ() - End of Quarter
//
// Return last day of <$quarter> or the quarter of the current
// value of the class. If class
// has time component that remains the same except it is
// now the last day of the quarter.
//
// <$quarter> integer (1-4)
//
// Returned value is in a new DateClass instance and does
// not modify existing class value
//===========================================================
function EOQ($quarter=,$dateTime="")
{
if ($dateTime) $this->SetDate($DateTime);
if (!$quarter) $quarter = $this->Quarter();
$month = $quarter*3;
$dt = new DateClass(mktime($this->Hours(),$this->Minutes(),$this->
Seconds(),$month,1,$this->Year()));
$month = $dt->EOM();
return $month;
} //EOQ()
//===========================================================
// ToString()
//
// Return a formated string of the current date. Use
// <$format> if provided otherwise use
// the format last passed to this function or use default.
//
// You can pass the following for commonly predefined <$format> types:
// RFC822 Mon, 17 May 2004 20:55:42 -0400
// RSS_1.0 2004-05-17T20:55:42-0400
// HTTP Mon, 17 May 2004 20:55:42 GMT
//
// Note: <$format> must be compatible with the PHP.date() function
//===========================================================
function ToString($format="",$dateTime="")
{
if ($dateTime) $this->SetDate($dateTime);
if($format!="") $this->_format = $format;
{
case
"RFC822": return date("r",$this->TimeStamp());
case "RSS_1.0": case "dc:date":
return date("Y-m-d\TH:i:sO",$this->TimeStamp());
case "HTTP": case "RFC1123":
return date('D, d M Y H:i:s \G\M\T',$this->TimeStamp());
}
return date($this->_format,$this->TimeStamp());
} //ToString()
//===========================================================
// UTC()
//
// Return UTC equivelent time for class date value.
//
// Returned value is in a new DateClass instance and does
// not modify existing class value
//============================================================
function UTC($dateTime="")
{
if ($dateTime) $this->SetDate($dateTime);
$dt->Add("minutes",date("Z",$this->TimeStamp()));
return $dt;
} // UTC()
} //class DateClass
//===========================================================================
// DateSpan Class
//
// Author: Steve Powell info@scrimpnet.com
// Licensing: GNU Lesser General Public License
// Date: (c) 2004 ScrimpNet.com
//
// Please feel free to email me with any questions, suggestions, or problems.
//
// This class determines the span of time between two different date/times.
//
// Functions return positive value when StartDate < StopDate. Functions
// return negative values when StartDate > StopDate.
//
// Generally date parameters can take the form of:
// string "3/14/2004" any GNC compatible strtotime() format
// integer 173218828 PHP time stamp
// object object DateClass
//
// Prerequisites: requires DateClass
//
// Public member functions. See member function comments for more complete
// complete descriptions:
// DateSpanClass() constructor
//
// StartDate (property) return DateClass of starting date in span
// StopDate (property) return DateClass of stopping date in span
//
// Years() return number of years covered in span
// Quarters() return number of quarters covered in span
// Months() return number of months covered in span
// Weeks() return number of weeks covered in span
// WeekDays() return number of week days (M-F) in span
// Days() return number of days covered in span
// Hours() return number of hours covered in span
// Minutes() return number of minutes covered in span
// Seconds() return number of seconds covered in span
// Span() return number of periods between two dates
// ToString() return formatted string representing span
// TimeStamp() return PHP timestamp for span (same of Seconds())
//
// NOTES:
// (1) This source code contains many functions you may not need and it
// contains thorough comments. You are free to remove any you
// don't need but you may not remove the licensing or copyright information.
// (2) For performance reasons, multiple calls to the class with the same
// span-start/span-stop dates (and/or times) are not recalculated.
//
// CUSTOMIZATION IDEAS
// (1) Expand class to be able to handle UTC and spans between time zones
// (2) Add capability to handle fiscal years that do not correlate
// to calendar years. i.e. years that begin on 4/1 or 10/1 etc.
//
// LICENSING
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
//
// This library 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
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
//
//===========================================================================
class DateSpanClass
{
//------------------------------------------------------
// public member variables (READ ONLY)
//------------------------------------------------------
var $StartDate;
var $StopDate;
//-------------------------------------------------------
// private member variables
//-------------------------------------------------------
var $_months;
var $_days;
var $_weekdays;
var $_hours;
var $_minutes;
var $_seconds;
var $_weeks;
var $_quarters;
var $_format;
var $_years;
var $_spandir; // 1 = positive span, -1 = negative span
//=========================================================
// constructor()
//
// Normally class is instantiated without any parameters.
// Span dates are usually supplied via Span() or property
// accessor functions.
//=========================================================
function DateSpanClass($dateStart="",$dateStop="")
{
$this->_reset();
if (!$dateStart) $dateStart = new DateClass();
if (!$dateStop) $dateStop = new DateClass();
$this->Span("seconds",$dateStart,$dateStop);
} //constructor()
//==========================================================
// _reset (private)
//
// Set class member variables to known state
//==========================================================
function _reset()
{
$this->_format = "m-d-y h:i:s";
$this->_years=;
$this->_months=;
$this->_days=;
$this->_hours=;
$this->_minutes=;
$this->_seconds=;
$this->_weeks=;
$this->_quarters=;
$this->_weekdays=;
$this->_spandir=1;
} //_reset()
//==========================================================
// property accessor functions
//
// optional parameters will calculate
// span between <$dateStart> and <$dateStop>. The span of the
// class will change based on these parameters. Existing
// class values are used if parameters
// are not set.
//
// $dateX parameter can be:
// string "4/13/2004" or any other GNC compatible format
// integer PHP timestamp
// object DateClass
//==========================================================
function Years($dateStart="",$dateStop="")
{
if ($dateStart || $dateStop || $this->_years==) $this->Span("years",
$dateStart,$dateStop);
return $this->_years;
}
function Months($dateStart="",$dateStop="")
{
if ($dateStart || $dateStop || $this->_months==) $this->Span("months",
$dateStart,$dateStop);
return $this->_months;
}
function WeekDays($dateStart="",$dateStop="")
{
if ($dateStart || $dateStop || $this->_weekdays==) $this->Span(
"weekdays",$dateStart,$dateStop);
return $this->_weekdays;
}
function Days($dateStart="",$dateStop="")
{
if ($dateStart || $dateStop || $this->_days==) $this->Span("days",
$dateStart,$dateStop);
return $this->_days;
}
function Weeks($dateStart="",$dateStop="")
{
if ($dateStart || $dateStop || $this->_weeks==) $this->Span("weeks",
$dateStart,$dateStop);
return $this->_weeks;
}
function Quarters($dateStart="",$dateStop="")
{
if ($dateStart || $dateStop || $this->_quarters==) $this->Span(
"quarters",$dateStart,$dateStop);
return $this->_quarters;
}
function Hours($dateStart="",$dateStop="")
{
if ($dateStart || $dateStop || $this->_hours==) $this->Span("hours",
$dateStart,$dateStop);
return $this->_seconds();
}
function Minutes($dateStart="",$dateStop="")
{
if ($dateStart || $dateStop || $this->_minutes==) $this->Span("minutes",
$dateStart,$dateStop);
return $this->_minutes();
}
function Seconds($dateStart="",$dateStop="")
{
if ($dateStart || $dateStop || $this->_seconds==) $this->Span("seconds",
$dateStart,$dateStop);
return $this->_seconds;
}
//=========================================================
// Span()
//
// Calculate span between two dates. Returned value is
// determined by <$datePart>. Numbers could be integer
// or float depending on span result.
//
// <$datePart> string part of date to adjust. The parameter
// can use any the class defined variables
// and most of corresponding keys from
// the date() and getdate() functions.
// "year" | "years" | "y"
// "quarters" | "q"
// "months" | "month" | "mon"
// "weeks" | "w"
// "days" | "day" | "mday" | "d"
// "hours" | "hour" | "g" |
// "minutes" | "minute" | "i"
// "seconds" | "second" | "s"
//
// <$dateStart>,<$dateStop> begin/end dates for time span
// string "5/23/2004" formated GNC date
// integer 393922923 timestamp
// object DateClass
//=========================================================
function Span($period,$dateStart="",$dateStop="")
{
//--------------------------------------------------
// create new span if parameters provided
//--------------------------------------------------
if ($dateStart)
$this->StartDate = new DateClass($dateStart);
if ($dateStop)
$this->StopDate = new DateClass($dateStop);
//--------------------------------------------------
// check to see if we are going to be using a
// negative span (stop date is before start date)
//--------------------------------------------------
$this->_spandir = 1;
if ($this->StartDate->TimeStamp() > $this->StopDate->TimeStamp())
{
$this->_spandir = -1;
}
//--------------------------------------------------
// calculate fixed length intervals
//--------------------------------------------------
$this->_seconds = $this->StopDate->TimeStamp()-$this->StartDate->
TimeStamp();
$this->_minutes = $this->_seconds/60;
$this->_hours = $this->_minutes/60;
$this->_days = $this->_hours/24;
$this->_years = $this->_days/365.25;
//--------------------------------------------------
// return user requested period
//--------------------------------------------------
{
case "years": case "year": case "y":
return $this->_years;break;
case "quarters": case "q":
return $this->_calcQuarters();break;
case "months": case "mon": case "m": case "month":
return $this->_calcMonths();break;
case "weeks": case "w":
return $this->_calcWeeks();break;
case "weekdays": case "wdays":
return $this->_calcWeekDays();break;
case "days": case "d": case "day":
return $this->_days;break;
case "hours": case "hour": case "h": case "g":
return $this->_hours;break;
case "minutes": case "minute": case "i":
return $this->_minutes;break;
case "seconds": case "second": case "s":
return $this->_seconds;break;
}
return ; // invalid period parameter
} //span()
//========================================================
// _calcQuarters (private)
//
// Return number of quarter boundries crossed in the
// span. This is a private function and should only
// be called from within the class. Use other accessor
// functions to access the information returned from
// here.
//========================================================
function _calcQuarters()
{
if ($this->_spandir==1) // start is before stop (positive span)
{
$dtStart = new DateClass($this->StartDate);
$dtStart = $dtStart->BOQ();
$dtStop = $this->StopDate;
}
else
{
$dtStart = new DateClass($this->StopDate);
$dtStart = $dtStart->BOQ();
$dtStop = $this->StartDate;
}
//--------------------------------------------------
// count times crossing period boundries
//--------------------------------------------------
$counter =;
while ($dtStart->TimeStamp() < $dtStop->TimeStamp())
{
$counter++;
$dtStart->Add("month",3);
}
$this->_quarters = ($counter-1*$this->_spandir);
return $this->_quarters;
} //_calcQuarters()
//===========================================================
// _calcMonths()
//
// Return number of month boundries crossed in the span. This
// is a private function and should only be called from within
// the class. Use other accessor functions to access the
// information returned from this function.
//===========================================================
function _calcMonths()
{
if ($this->_spandir==1) // start is before stop (positive span)
{
$dtStart = new DateClass($this->StartDate);
$dtStart = $dtStart->BOM();
$dtStop = $this->StopDate;
}
else
{
$dtStart = new DateClass($this->StopDate);
$dtStart = $dtStart->BOM();
$dtStop = $this->StartDate;
}
//--------------------------------------------------
// count times crossing period boundries
//--------------------------------------------------
$counter =;
while ($dtStart->TimeStamp() < $dtStop->TimeStamp())
{
$counter++;
$dtStart->Add("month",1);
}
$this->_months = ($counter-1)*$this->_spandir;
return $this->_months;
} //_calcMonths()
//===========================================================
// _calcWeeks()
//
// Return number of week boundries crossed in the span. This
// means the number of Sunday's between span dates.
//
// This is a private function and should only be called from within
// the class. Use other accessor functions to access the
// information returned from this function.
//===========================================================
function _calcWeeks()
{
if ($this->_spandir==1) // start is before stop (positive span)
{
$dtStart = new DateClass($this->StartDate);
$dtStart = $dtStart->BOW();
$dtStop = $this->StopDate;
}
else
{
$dtStart = new DateClass($this->StopDate);
$dtStart = $dtStart->BOW();
$dtStop = $this->StartDate;
}
//--------------------------------------------------
// count times crossing period boundries
//--------------------------------------------------
$counter=;
while ($dtStart->TimeStamp() < $dtStop->TimeStamp())
{
$counter++;
$dtStart->Add("day",7);
}
$this->_weeks = $counter-1;
$this->_weeks *= $this->_spandir;
return ($this->_weeks);
} //_calcWeeks()
//===========================================================
// _calcWeekDays()
//
// Return number of week boundries crossed in the span. This
// means the number of business days between span dates.
//
// This is a private function and should only be called from within
// the class. Use other accessor functions to access the
// information returned from this function.
//===========================================================
function _calcWeekDays()
{
if ($this->_spandir==1) // start is before stop (positive span)
{
$dtStart = new DateClass($this->StartDate);
$dtStop = $this->StopDate;
}
else
{
$dtStart = new DateClass($this->StopDate);
$dtStop = $this->StartDate;
}
//--------------------------------------------------
// count times crossing period boundries
//--------------------------------------------------
$counter=;
while ($dtStart->TimeStamp() < $dtStop->TimeStamp())
{
if ($dtStart->DatePart("wday") > && $dtStart->DatePart("wday") < 5)
$counter++;
$dtStart->Add("day",1);
}
$this->_weekdays = $counter;
$this->_weekdays *= $this->_spandir;
return ($this->_weekdays);
} //_calcWeekDays()
//===========================================================
// TimeStamp()
//
// Return timestamp value this class represents.
//
// This class uses the PHP timestamp for all calculations.
//===========================================================
function TimeStamp()
{
return $this->Seconds();
}
//=========================================================
// ToString()
// Return a formated string of the current timestamp.
// Function uses <$format> if provided otherwise it uses
// the format last passed to this function or use $_format.
//
// Note: <$format> must be compatible with the PHP.date() function
//=========================================================
function ToString($format="")
{
if ($format) $this->_format = $format;
return date($this->_format,$this->TimeStamp());
} //ToString()
} //class DateSpan
?>
