New file |
0,0 → 1,394 |
<?php |
/* vim: set expandtab tabstop=4 shiftwidth=4: */ |
// |
// +----------------------------------------------------------------------+ |
// | PHP Version 4 | |
// +----------------------------------------------------------------------+ |
// | Copyright (c) 1997-2002 The PHP Group | |
// +----------------------------------------------------------------------+ |
// | This source file is subject to version 2.02 of the PHP license, | |
// | that is bundled with this package in the file LICENSE, and is | |
// | available at through the world-wide-web at | |
// | http://www.php.net/license/3_0.txt. | |
// | If you did not receive a copy of the PHP license and are unable to | |
// | obtain it through the world-wide-web, please send a note to | |
// | license@php.net so we can mail you a copy immediately. | |
// +----------------------------------------------------------------------+ |
// | Authors: Harry Fuecks <hfuecks@phppatterns.com> | |
// | Lorenzo Alberton <l dot alberton at quipo dot it> | |
// +----------------------------------------------------------------------+ |
// |
// $Id: Week.php,v 1.7 2005/10/22 10:26:49 quipo Exp $ |
// |
/** |
* @package Calendar |
* @version $Id: Week.php,v 1.7 2005/10/22 10:26:49 quipo Exp $ |
*/ |
|
/** |
* Allows Calendar include path to be redefined |
* @ignore |
*/ |
if (!defined('CALENDAR_ROOT')) { |
define('CALENDAR_ROOT', 'Calendar'.DIRECTORY_SEPARATOR); |
} |
|
/** |
* Load Calendar base class |
*/ |
require_once CALENDAR_ROOT.'Calendar.php'; |
|
/** |
* Represents a Week and builds Days in tabular format<br> |
* <code> |
* require_once 'Calendar'.DIRECTORY_SEPARATOR.'Week.php'; |
* $Week = & new Calendar_Week(2003, 10, 1); Oct 2003, 1st tabular week |
* echo '<tr>'; |
* while ($Day = & $Week->fetch()) { |
* if ($Day->isEmpty()) { |
* echo '<td> </td>'; |
* } else { |
* echo '<td>'.$Day->thisDay().'</td>'; |
* } |
* } |
* echo '</tr>'; |
* </code> |
* @package Calendar |
* @access public |
*/ |
class Calendar_Week extends Calendar |
{ |
/** |
* Instance of Calendar_Table_Helper |
* @var Calendar_Table_Helper |
* @access private |
*/ |
var $tableHelper; |
|
/** |
* Stores the timestamp of the first day of this week |
* @access private |
* @var object |
*/ |
var $thisWeek; |
|
/** |
* Stores the timestamp of first day of previous week |
* @access private |
* @var object |
*/ |
var $prevWeek; |
|
/** |
* Stores the timestamp of first day of next week |
* @access private |
* @var object |
*/ |
var $nextWeek; |
|
/** |
* Used by build() to set empty days |
* @access private |
* @var boolean |
*/ |
var $firstWeek = false; |
|
/** |
* Used by build() to set empty days |
* @access private |
* @var boolean |
*/ |
var $lastWeek = false; |
|
/** |
* First day of the week (0=sunday, 1=monday...) |
* @access private |
* @var boolean |
*/ |
var $firstDay = 1; |
|
/** |
* Constructs Week |
* @param int year e.g. 2003 |
* @param int month e.g. 5 |
* @param int a day of the desired week |
* @param int (optional) first day of week (e.g. 0 for Sunday, 2 for Tuesday etc.) |
* @access public |
*/ |
function Calendar_Week($y, $m, $d, $firstDay=null) |
{ |
require_once CALENDAR_ROOT.'Table/Helper.php'; |
Calendar::Calendar($y, $m, $d); |
$this->firstDay = $this->defineFirstDayOfWeek($firstDay); |
$this->tableHelper = new Calendar_Table_Helper($this, $this->firstDay); |
$this->thisWeek = $this->tableHelper->getWeekStart($y, $m, $d, $this->firstDay); |
$this->prevWeek = $this->tableHelper->getWeekStart($y, $m, $d - $this->cE->getDaysInWeek( |
$this->thisYear(), |
$this->thisMonth(), |
$this->thisDay()), $this->firstDay); |
$this->nextWeek = $this->tableHelper->getWeekStart($y, $m, $d + $this->cE->getDaysInWeek( |
$this->thisYear(), |
$this->thisMonth(), |
$this->thisDay()), $this->firstDay); |
} |
|
/** |
* Defines the calendar by a timestamp (Unix or ISO-8601), replacing values |
* passed to the constructor |
* @param int|string Unix or ISO-8601 timestamp |
* @return void |
* @access public |
*/ |
function setTimestamp($ts) |
{ |
parent::setTimestamp($ts); |
$this->thisWeek = $this->tableHelper->getWeekStart( |
$this->year, $this->month, $this->day, $this->firstDay |
); |
$this->prevWeek = $this->tableHelper->getWeekStart( |
$this->year, $this->month, $this->day - $this->cE->getDaysInWeek( |
$this->thisYear(), |
$this->thisMonth(), |
$this->thisDay()), $this->firstDay |
); |
$this->nextWeek = $this->tableHelper->getWeekStart( |
$this->year, $this->month, $this->day + $this->cE->getDaysInWeek( |
$this->thisYear(), |
$this->thisMonth(), |
$this->thisDay()), $this->firstDay |
); |
} |
|
/** |
* Builds Calendar_Day objects for this Week |
* @param array (optional) Calendar_Day objects representing selected dates |
* @return boolean |
* @access public |
*/ |
function build($sDates = array()) |
{ |
require_once CALENDAR_ROOT.'Day.php'; |
$year = $this->cE->stampToYear($this->thisWeek); |
$month = $this->cE->stampToMonth($this->thisWeek); |
$day = $this->cE->stampToDay($this->thisWeek); |
$end = $this->cE->getDaysInWeek( |
$this->thisYear(), |
$this->thisMonth(), |
$this->thisDay() |
); |
|
for ($i=1; $i <= $end; $i++) { |
$stamp = $this->cE->dateToStamp($year, $month, $day++); |
$this->children[$i] = new Calendar_Day( |
$this->cE->stampToYear($stamp), |
$this->cE->stampToMonth($stamp), |
$this->cE->stampToDay($stamp)); |
} |
|
//set empty days (@see Calendar_Month_Weeks::build()) |
if ($this->firstWeek) { |
$eBefore = $this->tableHelper->getEmptyDaysBefore(); |
for ($i=1; $i <= $eBefore; $i++) { |
$this->children[$i]->setEmpty(); |
} |
} |
if ($this->lastWeek) { |
$eAfter = $this->tableHelper->getEmptyDaysAfterOffset(); |
for ($i = $eAfter+1; $i <= $end; $i++) { |
$this->children[$i]->setEmpty(); |
} |
} |
|
if (count($sDates) > 0) { |
$this->setSelection($sDates); |
} |
return true; |
} |
|
/** |
* @param boolean |
* @return void |
* @access private |
*/ |
function setFirst($state=true) |
{ |
$this->firstWeek = $state; |
} |
|
/** |
* @param boolean |
* @return void |
* @access private |
*/ |
function setLast($state=true) |
{ |
$this->lastWeek = $state; |
} |
|
/** |
* Called from build() |
* @param array |
* @return void |
* @access private |
*/ |
function setSelection($sDates) |
{ |
foreach ($sDates as $sDate) { |
foreach ($this->children as $key => $child) { |
if ($child->thisDay() == $sDate->thisDay() && |
$child->thisMonth() == $sDate->thisMonth() && |
$child->thisYear() == $sDate->thisYear() |
) { |
$this->children[$key] = $sDate; |
$this->children[$key]->setSelected(); |
} |
} |
} |
reset($this->children); |
} |
|
/** |
* Gets the value of the previous week, according to the requested format |
* |
* @param string $format ['timestamp' | 'n_in_month' | 'n_in_year' | 'array'] |
* @return mixed |
* @access public |
*/ |
function prevWeek($format = 'n_in_month') |
{ |
switch (strtolower($format)) { |
case 'int': |
case 'n_in_month': |
return ($this->firstWeek) ? null : $this->thisWeek('n_in_month') -1; |
break; |
case 'n_in_year': |
return $this->cE->getWeekNInYear( |
$this->cE->stampToYear($this->prevWeek), |
$this->cE->stampToMonth($this->prevWeek), |
$this->cE->stampToDay($this->prevWeek)); |
break; |
case 'array': |
return $this->toArray($this->prevWeek); |
break; |
case 'object': |
require_once CALENDAR_ROOT.'Factory.php'; |
return Calendar_Factory::createByTimestamp('Week', $this->prevWeek); |
break; |
case 'timestamp': |
default: |
return $this->prevWeek; |
break; |
} |
} |
|
/** |
* Gets the value of the current week, according to the requested format |
* |
* @param string $format ['timestamp' | 'n_in_month' | 'n_in_year' | 'array'] |
* @return mixed |
* @access public |
*/ |
function thisWeek($format = 'n_in_month') |
{ |
switch (strtolower($format)) { |
case 'int': |
case 'n_in_month': |
if ($this->firstWeek) { |
return 1; |
} |
if ($this->lastWeek) { |
return $this->cE->getWeeksInMonth( |
$this->thisYear(), |
$this->thisMonth(), |
$this->firstDay); |
} |
return $this->cE->getWeekNInMonth( |
$this->thisYear(), |
$this->thisMonth(), |
$this->thisDay(), |
$this->firstDay); |
break; |
case 'n_in_year': |
return $this->cE->getWeekNInYear( |
$this->cE->stampToYear($this->thisWeek), |
$this->cE->stampToMonth($this->thisWeek), |
$this->cE->stampToDay($this->thisWeek)); |
break; |
case 'array': |
return $this->toArray($this->thisWeek); |
break; |
case 'object': |
require_once CALENDAR_ROOT.'Factory.php'; |
return Calendar_Factory::createByTimestamp('Week', $this->thisWeek); |
break; |
case 'timestamp': |
default: |
return $this->thisWeek; |
break; |
} |
} |
|
/** |
* Gets the value of the following week, according to the requested format |
* |
* @param string $format ['timestamp' | 'n_in_month' | 'n_in_year' | 'array'] |
* @return mixed |
* @access public |
*/ |
function nextWeek($format = 'n_in_month') |
{ |
switch (strtolower($format)) { |
case 'int': |
case 'n_in_month': |
return ($this->lastWeek) ? null : $this->thisWeek('n_in_month') +1; |
break; |
case 'n_in_year': |
return $this->cE->getWeekNInYear( |
$this->cE->stampToYear($this->nextWeek), |
$this->cE->stampToMonth($this->nextWeek), |
$this->cE->stampToDay($this->nextWeek)); |
break; |
case 'array': |
return $this->toArray($this->nextWeek); |
break; |
case 'object': |
require_once CALENDAR_ROOT.'Factory.php'; |
return Calendar_Factory::createByTimestamp('Week', $this->nextWeek); |
break; |
case 'timestamp': |
default: |
return $this->nextWeek; |
break; |
} |
} |
|
/** |
* Returns the instance of Calendar_Table_Helper. |
* Called from Calendar_Validator::isValidWeek |
* @return Calendar_Table_Helper |
* @access protected |
*/ |
function & getHelper() |
{ |
return $this->tableHelper; |
} |
|
/** |
* Makes sure theres a value for $this->day |
* @return void |
* @access private |
*/ |
function findFirstDay() |
{ |
if (!count($this->children) > 0) { |
$this->build(); |
foreach ($this->children as $Day) { |
if (!$Day->isEmpty()) { |
$this->day = $Day->thisDay(); |
break; |
} |
} |
} |
} |
} |
?> |