| // +----------------------------------------------------------------------+ // // $Id$ // /** * @package Calendar * @version $Id$ */ /** * Performs calendar calculations based on the PHP date() function and * Unix timestamps (using PHP's mktime() function). * @package Calendar * @access protected */ class Calendar_Engine_UnixTS /* implements Calendar_Engine_Interface */ { /** * Makes sure a given timestamp is only ever parsed once * 
     * array (
     *  [0] => year (e.g 2003),
     *  [1] => month (e.g 9),
     *  [2] => day (e.g 6),
     *  [3] => hour (e.g 14),
     *  [4] => minute (e.g 34),
     *  [5] => second (e.g 45),
     *  [6] => num days in month (e.g. 31),
     *  [7] => week in year (e.g. 50),
     *  [8] => day in week (e.g. 0 for Sunday)
     * )
     *
* Uses a static variable to prevent date() being used twice * for a date which is already known * @param int Unix timestamp * @return array * @access protected */ function stampCollection($stamp) { static $stamps = array(); if ( !isset($stamps[$stamp]) ) { $date = @date('Y n j H i s t W w',$stamp); $stamps[$stamp] = sscanf($date, "%d %d %d %d %d %d %d %d %d"); } return $stamps[$stamp]; } /** * Returns a numeric year given a timestamp * @param int Unix timestamp * @return int year (e.g. 2003) * @access protected */ function stampToYear($stamp) { $date = Calendar_Engine_UnixTS::stampCollection($stamp); return (int)$date[0]; } /** * Returns a numeric month given a timestamp * @param int Unix timestamp * @return int month (e.g. 9) * @access protected */ function stampToMonth($stamp) { $date = Calendar_Engine_UnixTS::stampCollection($stamp); return (int)$date[1]; } /** * Returns a numeric day given a timestamp * @param int Unix timestamp * @return int day (e.g. 15) * @access protected */ function stampToDay($stamp) { $date = Calendar_Engine_UnixTS::stampCollection($stamp); return (int)$date[2]; } /** * Returns a numeric hour given a timestamp * @param int Unix timestamp * @return int hour (e.g. 13) * @access protected */ function stampToHour($stamp) { $date = Calendar_Engine_UnixTS::stampCollection($stamp); return (int)$date[3]; } /** * Returns a numeric minute given a timestamp * @param int Unix timestamp * @return int minute (e.g. 34) * @access protected */ function stampToMinute($stamp) { $date = Calendar_Engine_UnixTS::stampCollection($stamp); return (int)$date[4]; } /** * Returns a numeric second given a timestamp * @param int Unix timestamp * @return int second (e.g. 51) * @access protected */ function stampToSecond($stamp) { $date = Calendar_Engine_UnixTS::stampCollection($stamp); return (int)$date[5]; } /** * Returns a timestamp * @param int year (2003) * @param int month (9) * @param int day (13) * @param int hour (13) * @param int minute (34) * @param int second (53) * @return int Unix timestamp * @access protected */ function dateToStamp($y, $m, $d, $h=0, $i=0, $s=0) { static $dates = array(); if ( !isset($dates[$y][$m][$d][$h][$i][$s]) ) { $dates[$y][$m][$d][$h][$i][$s] = @mktime($h, $i, $s, $m, $d, $y); } return $dates[$y][$m][$d][$h][$i][$s]; } /** * The upper limit on years that the Calendar Engine can work with * @return int (2037) * @access protected */ function getMaxYears() { return 2037; } /** * The lower limit on years that the Calendar Engine can work with * @return int (1970 if it's Windows and 1902 for all other OSs) * @access protected */ function getMinYears() { return $min = strpos(PHP_OS, 'WIN') === false ? 1902 : 1970; } /** * Returns the number of months in a year * @return int (12) * @access protected */ function getMonthsInYear($y=null) { return 12; } /** * Returns the number of days in a month, given year and month * @param int year (2003) * @param int month (9) * @return int days in month * @access protected */ function getDaysInMonth($y, $m) { $stamp = Calendar_Engine_UnixTS::dateToStamp($y,$m,1); $date = Calendar_Engine_UnixTS::stampCollection($stamp); return $date[6]; } /** * Returns numeric representation of the day of the week in a month, * given year and month * @param int year (2003) * @param int month (9) * @return int from 0 to 6 * @access protected */ function getFirstDayInMonth($y, $m) { $stamp = Calendar_Engine_UnixTS::dateToStamp($y,$m,1); $date = Calendar_Engine_UnixTS::stampCollection($stamp); return $date[8]; } /** * Returns the number of days in a week * @param int year (2003) * @param int month (9) * @param int day (4) * @return int (7) * @access protected */ function getDaysInWeek($y=NULL, $m=NULL, $d=NULL) { return 7; } /** * Returns the number of the week in the year (ISO-8601), given a date * @param int year (2003) * @param int month (9) * @param int day (4) * @return int week number * @access protected */ function getWeekNInYear($y, $m, $d) { $stamp = Calendar_Engine_UnixTS::dateToStamp($y,$m,$d); $date = Calendar_Engine_UnixTS::stampCollection($stamp); return $date[7]; } /** * Returns the number of the week in the month, given a date * @param int year (2003) * @param int month (9) * @param int day (4) * @param int first day of the week (default: monday) * @return int week number * @access protected */ function getWeekNInMonth($y, $m, $d, $firstDay=1) { $weekEnd = ($firstDay == 0) ? $this->getDaysInWeek()-1 : $firstDay-1; $end_of_week = 1; while (@date('w', @mktime(0, 0, 0, $m, $end_of_week, $y)) != $weekEnd) { ++$end_of_week; //find first weekend of the month } $w = 1; while ($d > $end_of_week) { ++$w; $end_of_week += $this->getDaysInWeek(); } return $w; } /** * Returns the number of weeks in the month * @param int year (2003) * @param int month (9) * @param int first day of the week (default: monday) * @return int weeks number * @access protected */ function getWeeksInMonth($y, $m, $firstDay=1) { $FDOM = $this->getFirstDayInMonth($y, $m); if ($FDOM == 0) { $FDOM = $this->getDaysInWeek(); } if ($FDOM > $firstDay) { $daysInTheFirstWeek = $this->getDaysInWeek() - $FDOM + $firstDay; $weeks = 1; } else { $daysInTheFirstWeek = $firstDay - $FDOM; $weeks = 0; } $daysInTheFirstWeek %= $this->getDaysInWeek(); return (int)(ceil(($this->getDaysInMonth($y, $m) - $daysInTheFirstWeek) / $this->getDaysInWeek()) + $weeks); } /** * Returns the number of the day of the week (0=sunday, 1=monday...) * @param int year (2003) * @param int month (9) * @param int day (4) * @return int weekday number * @access protected */ function getDayOfWeek($y, $m, $d) { $stamp = Calendar_Engine_UnixTS::dateToStamp($y,$m,$d); $date = Calendar_Engine_UnixTS::stampCollection($stamp); return $date[8]; } /** * Returns a list of integer days of the week beginning 0 * @param int year (2003) * @param int month (9) * @param int day (4) * @return array (0,1,2,3,4,5,6) 1 = Monday * @access protected */ function getWeekDays($y=NULL, $m=NULL, $d=NULL) { return array(0, 1, 2, 3, 4, 5, 6); } /** * Returns the default first day of the week * @param int year (2003) * @param int month (9) * @param int day (4) * @return int (default 1 = Monday) * @access protected */ function getFirstDayOfWeek($y=NULL, $m=NULL, $d=NULL) { return 1; } /** * Returns the number of hours in a day * @return int (24) * @access protected */ function getHoursInDay($y=null,$m=null,$d=null) { return 24; } /** * Returns the number of minutes in an hour * @return int (60) * @access protected */ function getMinutesInHour($y=null,$m=null,$d=null,$h=null) { return 60; } /** * Returns the number of seconds in a minutes * @return int (60) * @access protected */ function getSecondsInMinute($y=null,$m=null,$d=null,$h=null,$i=null) { return 60; } } ?>