mirror of
https://github.com/ACSPRI/queXS
synced 2024-04-02 12:12:16 +00:00
394 lines
12 KiB
PHP
394 lines
12 KiB
PHP
<?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;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
?>
|