WebSVN – Applications.gtt – Diff – /trunk/bibliotheque/pear/Calendar/Calendar.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: Calendar.php,v 1.3 2005/10/22 10:07:11 quipo Exp $
//
/**
 * @package Calendar
 * @version $Id: Calendar.php,v 1.3 2005/10/22 10:07:11 quipo Exp $
 */
 
/**
 * Allows Calendar include path to be redefined
 */
if (!defined('CALENDAR_ROOT')) {
    define('CALENDAR_ROOT', 'Calendar'.DIRECTORY_SEPARATOR);
}
 
/**
 * Constant which defines the calculation engine to use
 */
if (!defined('CALENDAR_ENGINE')) {
    define('CALENDAR_ENGINE', 'UnixTS');
}
 
/**
 * Define Calendar Month states
 */
define('CALENDAR_USE_MONTH',          1);
define('CALENDAR_USE_MONTH_WEEKDAYS', 2);
define('CALENDAR_USE_MONTH_WEEKS',    3);
 
/**
 * Contains a factory method to return a Singleton instance of a class
 * implementing the Calendar_Engine_Interface.<br>
 * <b>Note:</b> this class must be modified to "register" alternative
 * Calendar_Engines. The engine used can be controlled with the constant
 * CALENDAR_ENGINE
 * @see Calendar_Engine_Interface
 * @package Calendar
 * @access protected
 */
class Calendar_Engine_Factory
{
    /**
     * Returns an instance of the engine
     * @return object instance of a calendar calculation engine
     * @access protected
     */
    function & getEngine()
    {
        static $engine = false;
        switch (CALENDAR_ENGINE) {
            case 'PearDate':
                $class = 'Calendar_Engine_PearDate';
                break;
            case 'UnixTS':
            default:
                $class = 'Calendar_Engine_UnixTS';
            break;
        }
        if (!$engine) {
            if (!class_exists($class)) {
                require_once CALENDAR_ROOT.'Engine'.DIRECTORY_SEPARATOR.CALENDAR_ENGINE.'.php';
            }
            $engine = new $class;
        }
        return $engine;
    }
}
 
/**
 * Base class for Calendar API. This class should not be instantiated
 * directly.
 * @abstract
 * @package Calendar
 */
class Calendar
{
    /**
     * Instance of class implementing calendar engine interface
     * @var object
     * @access private
     */
    var $cE;
 
    /**
     * Instance of Calendar_Validator (lazy initialized when isValid() or
     * getValidor() is called
     * @var Calendar_Validator
     * @access private
     */
    var $validator;
 
    /**
     * Year for this calendar object e.g. 2003
     * @access private
     * @var int
     */
   var $year;
 
    /**
     * Month for this calendar object e.g. 9
     * @access private
     * @var int
     */
    var $month;
 
    /**
     * Day of month for this calendar object e.g. 23
     * @access private
     * @var int
     */
    var $day;
 
    /**
     * Hour of day for this calendar object e.g. 13
     * @access private
     * @var int
     */
    var $hour;
 
    /**
     * Minute of hour this calendar object e.g. 46
     * @access private
     * @var int
     */
    var $minute;
 
    /**
     * Second of minute this calendar object e.g. 34
     * @access private
     * @var int
     */
    var $second;
 
    /**
     * Marks this calendar object as selected (e.g. 'today')
     * @access private
     * @var boolean
     */
    var $selected = false;
 
    /**
     * Collection of child calendar objects created from subclasses
     * of Calendar. Type depends on the object which created them.
     * @access private
     * @var array
     */
    var $children = array();
 
    /**
     * Constructs the Calendar
     * @param int year
     * @param int month
     * @param int day
     * @param int hour
     * @param int minute
     * @param int second
     * @access protected
     */
    function Calendar($y = 2000, $m = 1, $d = 1, $h = 0, $i = 0, $s = 0)
    {
        static $cE = null;
        if (!isset($cE)) {
            $cE = & Calendar_Engine_Factory::getEngine();
        }
        $this->cE = & $cE;
        $this->year   = (int)$y;
        $this->month  = (int)$m;
        $this->day    = (int)$d;
        $this->hour   = (int)$h;
        $this->minute = (int)$i;
        $this->second = (int)$s;
    }
 
    /**
     * 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)
    {
        $this->year   = $this->cE->stampToYear($ts);
        $this->month  = $this->cE->stampToMonth($ts);
        $this->day    = $this->cE->stampToDay($ts);
        $this->hour   = $this->cE->stampToHour($ts);
        $this->minute = $this->cE->stampToMinute($ts);
        $this->second = $this->cE->stampToSecond($ts);
    }
 
    /**
     * Returns a timestamp from the current date / time values. Format of
     * timestamp depends on Calendar_Engine implementation being used
     * @return int|string timestamp
     * @access public
     */
    function getTimestamp()
    {
        return $this->cE->dateToStamp(
            $this->year, $this->month, $this->day,
            $this->hour, $this->minute, $this->second);
    }
 
    /**
     * Defines calendar object as selected (e.g. for today)
     * @param boolean state whether Calendar subclass
     * @return void
     * @access public
     */
    function setSelected($state = true)
    {
        $this->selected = $state;
    }
 
    /**
     * True if the calendar subclass object is selected (e.g. today)
     * @return boolean
     * @access public
     */
    function isSelected()
    {
        return $this->selected;
    }
 
    /**
     * Adjusts the date (helper method)
     * @return void
     * @access public
     */
    function adjust()
    {
        $stamp = $this->getTimeStamp();
        $this->year   = $this->cE->stampToYear($stamp);
        $this->month  = $this->cE->stampToMonth($stamp);
        $this->day    = $this->cE->stampToDay($stamp);
        $this->hour   = $this->cE->stampToHour($stamp);
        $this->minute = $this->cE->stampToMinute($stamp);
        $this->second = $this->cE->stampToSecond($stamp);
    }
 
    /**
     * Returns the date as an associative array (helper method)
     * @param mixed timestamp (leave empty for current timestamp)
     * @return array
     * @access public
     */
    function toArray($stamp=null)
    {
        if (is_null($stamp)) {
            $stamp = $this->getTimeStamp();
        }
        return array(
            'year'   => $this->cE->stampToYear($stamp),
            'month'  => $this->cE->stampToMonth($stamp),
            'day'    => $this->cE->stampToDay($stamp),
            'hour'   => $this->cE->stampToHour($stamp),
            'minute' => $this->cE->stampToMinute($stamp),
            'second' => $this->cE->stampToSecond($stamp)
        );
    }
 
    /**
     * Returns the value as an associative array (helper method)
     * @param string type of date object that return value represents
     * @param string $format ['int' | 'array' | 'timestamp' | 'object']
     * @param mixed timestamp (depending on Calendar engine being used)
     * @param int integer default value (i.e. give me the answer quick)
     * @return mixed
     * @access private
     */
    function returnValue($returnType, $format, $stamp, $default)
    {
        switch (strtolower($format)) {
            case 'int':
                return $default;
            case 'array':
                return $this->toArray($stamp);
                break;
            case 'object':
                require_once CALENDAR_ROOT.'Factory.php';
                return Calendar_Factory::createByTimestamp($returnType,$stamp);
                break;
            case 'timestamp':
            default:
                return $stamp;
                break;
        }
    }
 
    /**
     * Abstract method for building the children of a calendar object.
     * Implemented by Calendar subclasses
     * @param array containing Calendar objects to select (optional)
     * @return boolean
     * @access public
     * @abstract
     */
    function build($sDates = array())
    {
        require_once 'PEAR.php';
        PEAR::raiseError(
            'Calendar::build is abstract', null, PEAR_ERROR_TRIGGER,
            E_USER_NOTICE, 'Calendar::build()');
        return false;
    }
 
    /**
     * Abstract method for selected data objects called from build
     * @param array
     * @return boolean
     * @access public
     * @abstract
     */
    function setSelection($sDates)
    {
        require_once 'PEAR.php';
        PEAR::raiseError(
            'Calendar::setSelection is abstract', null, PEAR_ERROR_TRIGGER,
            E_USER_NOTICE, 'Calendar::setSelection()');
        return false;
    }
 
    /**
     * Iterator method for fetching child Calendar subclass objects
     * (e.g. a minute from an hour object). On reaching the end of
     * the collection, returns false and resets the collection for
     * further iteratations.
     * @return mixed either an object subclass of Calendar or false
     * @access public
     */
    function fetch()
    {
        $child = each($this->children);
        if ($child) {
            return $child['value'];
        } else {
            reset($this->children);
            return false;
        }
    }
 
    /**
     * Fetches all child from the current collection of children
     * @return array
     * @access public
     */
    function fetchAll()
    {
        return $this->children;
    }
 
    /**
     * Get the number Calendar subclass objects stored in the internal
     * collection.
     * @return int
     * @access public
     */
    function size()
    {
        return count($this->children);
    }
 
    /**
     * Determine whether this date is valid, with the bounds determined by
     * the Calendar_Engine. The call is passed on to
     * Calendar_Validator::isValid
     * @return boolean
     * @access public
     */
    function isValid()
    {
        $validator = & $this->getValidator();
        return $validator->isValid();
    }
 
    /**
     * Returns an instance of Calendar_Validator
     * @return Calendar_Validator
     * @access public
     */
    function & getValidator()
    {
        if (!isset($this->validator)) {
            require_once CALENDAR_ROOT.'Validator.php';
            $this->validator = new Calendar_Validator($this);
        }
        return $this->validator;
    }
 
    /**
     * Returns a reference to the current Calendar_Engine being used. Useful
     * for Calendar_Table_Helper and Calendar_Validator
     * @return object implementing Calendar_Engine_Inteface
     * @access protected
     */
    function & getEngine()
    {
        return $this->cE;
    }
 
    /**
     * Set the CALENDAR_FIRST_DAY_OF_WEEK constant to the $firstDay value
     * if the constant is not set yet.
     * @throws E_USER_WARNING this method throws a WARNING if the
     *    CALENDAR_FIRST_DAY_OF_WEEK constant is already defined and
     *    the $firstDay parameter is set to a different value
     * @param integer $firstDay first day of the week (0=sunday, 1=monday, ...)
     * @return integer
     * @access protected
     */
    function defineFirstDayOfWeek($firstDay = null)
    {
        if (defined('CALENDAR_FIRST_DAY_OF_WEEK')) {
            if (!is_null($firstDay) && ($firstDay != CALENDAR_FIRST_DAY_OF_WEEK)) {
                $msg = 'CALENDAR_FIRST_DAY_OF_WEEK constant already defined.'
                  .' The $firstDay parameter will be ignored.';
                trigger_error($msg, E_USER_WARNING);
            }
            return CALENDAR_FIRST_DAY_OF_WEEK;
        }
        if (is_null($firstDay)) {
            $firstDay = $this->cE->getFirstDayOfWeek(
                $this->thisYear(),
                $this->thisMonth(),
                $this->thisDay()
            );
        }
        define ('CALENDAR_FIRST_DAY_OF_WEEK', $firstDay);
        return CALENDAR_FIRST_DAY_OF_WEEK;
    }
 
    /**
     * Returns the value for the previous year
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 2002 or timestamp
     * @access public
     */
    function prevYear($format = 'int')
    {
        $ts = $this->cE->dateToStamp($this->year-1, 1, 1, 0, 0, 0);
        return $this->returnValue('Year', $format, $ts, $this->year-1);
    }
 
    /**
     * Returns the value for this year
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 2003 or timestamp
     * @access public
     */
    function thisYear($format = 'int')
    {
        $ts = $this->cE->dateToStamp($this->year, 1, 1, 0, 0, 0);
        return $this->returnValue('Year', $format, $ts, $this->year);
    }
 
    /**
     * Returns the value for next year
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 2004 or timestamp
     * @access public
     */
    function nextYear($format = 'int')
    {
        $ts = $this->cE->dateToStamp($this->year+1, 1, 1, 0, 0, 0);
        return $this->returnValue('Year', $format, $ts, $this->year+1);
    }
 
    /**
     * Returns the value for the previous month
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 4 or Unix timestamp
     * @access public
     */
    function prevMonth($format = 'int')
    {
        $ts = $this->cE->dateToStamp($this->year, $this->month-1, 1, 0, 0, 0);
        return $this->returnValue('Month', $format, $ts, $this->cE->stampToMonth($ts));
    }
 
    /**
     * Returns the value for this month
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 5 or timestamp
     * @access public
     */
    function thisMonth($format = 'int')
    {
        $ts = $this->cE->dateToStamp($this->year, $this->month, 1, 0, 0, 0);
        return $this->returnValue('Month', $format, $ts, $this->month);
    }
 
    /**
     * Returns the value for next month
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 6 or timestamp
     * @access public
     */
    function nextMonth($format = 'int')
    {
        $ts = $this->cE->dateToStamp($this->year, $this->month+1, 1, 0, 0, 0);
        return $this->returnValue('Month', $format, $ts, $this->cE->stampToMonth($ts));
    }
 
    /**
     * Returns the value for the previous day
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 10 or timestamp
     * @access public
     */
    function prevDay($format = 'int')
    {
        $ts = $this->cE->dateToStamp(
            $this->year, $this->month, $this->day-1, 0, 0, 0);
        return $this->returnValue('Day', $format, $ts, $this->cE->stampToDay($ts));
    }
 
    /**
     * Returns the value for this day
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 11 or timestamp
     * @access public
     */
    function thisDay($format = 'int')
    {
        $ts = $this->cE->dateToStamp(
            $this->year, $this->month, $this->day, 0, 0, 0);
        return $this->returnValue('Day', $format, $ts, $this->day);
    }
 
    /**
     * Returns the value for the next day
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 12 or timestamp
     * @access public
     */
    function nextDay($format = 'int')
    {
        $ts = $this->cE->dateToStamp(
            $this->year, $this->month, $this->day+1, 0, 0, 0);
        return $this->returnValue('Day', $format, $ts, $this->cE->stampToDay($ts));
    }
 
    /**
     * Returns the value for the previous hour
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 13 or timestamp
     * @access public
     */
    function prevHour($format = 'int')
    {
        $ts = $this->cE->dateToStamp(
            $this->year, $this->month, $this->day, $this->hour-1, 0, 0);
        return $this->returnValue('Hour', $format, $ts, $this->cE->stampToHour($ts));
    }
 
    /**
     * Returns the value for this hour
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 14 or timestamp
     * @access public
     */
    function thisHour($format = 'int')
    {
        $ts = $this->cE->dateToStamp(
            $this->year, $this->month, $this->day, $this->hour, 0, 0);
        return $this->returnValue('Hour', $format, $ts, $this->hour);
    }
 
    /**
     * Returns the value for the next hour
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 14 or timestamp
     * @access public
     */
    function nextHour($format = 'int')
    {
        $ts = $this->cE->dateToStamp(
            $this->year, $this->month, $this->day, $this->hour+1, 0, 0);
        return $this->returnValue('Hour', $format, $ts, $this->cE->stampToHour($ts));
    }
 
    /**
     * Returns the value for the previous minute
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 23 or timestamp
     * @access public
     */
    function prevMinute($format = 'int')
    {
        $ts = $this->cE->dateToStamp(
            $this->year, $this->month, $this->day,
            $this->hour, $this->minute-1, 0);
        return $this->returnValue('Minute', $format, $ts, $this->cE->stampToMinute($ts));
    }
 
    /**
     * Returns the value for this minute
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 24 or timestamp
     * @access public
     */
    function thisMinute($format = 'int')
    {
        $ts = $this->cE->dateToStamp(
            $this->year, $this->month, $this->day,
            $this->hour, $this->minute, 0);
        return $this->returnValue('Minute', $format, $ts, $this->minute);
    }
 
    /**
    * Returns the value for the next minute
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 25 or timestamp
     * @access public
     */
    function nextMinute($format = 'int')
    {
        $ts = $this->cE->dateToStamp(
            $this->year, $this->month, $this->day,
            $this->hour, $this->minute+1, 0);
        return $this->returnValue('Minute', $format, $ts, $this->cE->stampToMinute($ts));
    }
 
    /**
     * Returns the value for the previous second
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 43 or timestamp
     * @access public
     */
    function prevSecond($format = 'int')
    {
        $ts = $this->cE->dateToStamp(
            $this->year, $this->month, $this->day,
            $this->hour, $this->minute, $this->second-1);
        return $this->returnValue('Second', $format, $ts, $this->cE->stampToSecond($ts));
    }
 
    /**
     * Returns the value for this second
    * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 44 or timestamp
     * @access public
     */
    function thisSecond($format = 'int')
    {
        $ts = $this->cE->dateToStamp(
            $this->year, $this->month, $this->day,
            $this->hour, $this->minute, $this->second);
        return $this->returnValue('Second', $format, $ts, $this->second);
    }
 
    /**
     * Returns the value for the next second
     * @param string return value format ['int' | 'timestamp' | 'object' | 'array']
     * @return int e.g. 45 or timestamp
     * @access public
     */
    function nextSecond($format = 'int')
    {
        $ts = $this->cE->dateToStamp(
            $this->year, $this->month, $this->day,
            $this->hour, $this->minute, $this->second+1);
        return $this->returnValue('Second', $format, $ts, $this->cE->stampToSecond($ts));
    }
}
?>

Rev 61	Rev 66
1	`<?php`	1	`<?php`
2	`/* vim: set expandtab tabstop=4 shiftwidth=4: */`	2	`/* vim: set expandtab tabstop=4 shiftwidth=4: */`
3	`//`	3	`//`
4	`// +----------------------------------------------------------------------+`	4	`// +----------------------------------------------------------------------+`
5	`// \| PHP Version 4 \|`	5	`// \| PHP Version 4 \|`
6	`// +----------------------------------------------------------------------+`	6	`// +----------------------------------------------------------------------+`
7	`// \| Copyright (c) 1997-2002 The PHP Group \|`	7	`// \| Copyright (c) 1997-2002 The PHP Group \|`
8	`// +----------------------------------------------------------------------+`	8	`// +----------------------------------------------------------------------+`
9	`// \| This source file is subject to version 2.02 of the PHP license, \|`	9	`// \| This source file is subject to version 2.02 of the PHP license, \|`
10	`// \| that is bundled with this package in the file LICENSE, and is \|`	10	`// \| that is bundled with this package in the file LICENSE, and is \|`
11	`// \| available at through the world-wide-web at \|`	11	`// \| available at through the world-wide-web at \|`
12	`// \| http://www.php.net/license/3_0.txt. \|`	12	`// \| http://www.php.net/license/3_0.txt. \|`
13	`// \| If you did not receive a copy of the PHP license and are unable to \|`	13	`// \| If you did not receive a copy of the PHP license and are unable to \|`
14	`// \| obtain it through the world-wide-web, please send a note to \|`	14	`// \| obtain it through the world-wide-web, please send a note to \|`
15	`// \| license@php.net so we can mail you a copy immediately. \|`	15	`// \| license@php.net so we can mail you a copy immediately. \|`
16	`// +----------------------------------------------------------------------+`	16	`// +----------------------------------------------------------------------+`
17	`// \| Authors: Harry Fuecks <hfuecks@phppatterns.com> \|`	17	`// \| Authors: Harry Fuecks <hfuecks@phppatterns.com> \|`
18	`// \| Lorenzo Alberton <l dot alberton at quipo dot it> \|`	18	`// \| Lorenzo Alberton <l dot alberton at quipo dot it> \|`
19	`// +----------------------------------------------------------------------+`	19	`// +----------------------------------------------------------------------+`
20	`//`	20	`//`
21	`// $Id: Calendar.php,v 1.3 2005/10/22 10:07:11 quipo Exp $`	21	`// $Id: Calendar.php,v 1.3 2005/10/22 10:07:11 quipo Exp $`
22	`//`	22	`//`
23	`/**`	23	`/**`
24	`* @package Calendar`	24	`* @package Calendar`
25	`* @version $Id: Calendar.php,v 1.3 2005/10/22 10:07:11 quipo Exp $`	25	`* @version $Id: Calendar.php,v 1.3 2005/10/22 10:07:11 quipo Exp $`
26	`*/`	26	`*/`
27		27
28	`/**`	28	`/**`
29	`* Allows Calendar include path to be redefined`	29	`* Allows Calendar include path to be redefined`
30	`*/`	30	`*/`
31	`if (!defined('CALENDAR_ROOT')) {`	31	`if (!defined('CALENDAR_ROOT')) {`
32	`define('CALENDAR_ROOT', 'Calendar'.DIRECTORY_SEPARATOR);`	32	`define('CALENDAR_ROOT', 'Calendar'.DIRECTORY_SEPARATOR);`
33	`}`	33	`}`
34		34
35	`/**`	35	`/**`
36	`* Constant which defines the calculation engine to use`	36	`* Constant which defines the calculation engine to use`
37	`*/`	37	`*/`
38	`if (!defined('CALENDAR_ENGINE')) {`	38	`if (!defined('CALENDAR_ENGINE')) {`
39	`define('CALENDAR_ENGINE', 'UnixTS');`	39	`define('CALENDAR_ENGINE', 'UnixTS');`
40	`}`	40	`}`
41		41
42	`/**`	42	`/**`
43	`* Define Calendar Month states`	43	`* Define Calendar Month states`
44	`*/`	44	`*/`
45	`define('CALENDAR_USE_MONTH', 1);`	45	`define('CALENDAR_USE_MONTH', 1);`
46	`define('CALENDAR_USE_MONTH_WEEKDAYS', 2);`	46	`define('CALENDAR_USE_MONTH_WEEKDAYS', 2);`
47	`define('CALENDAR_USE_MONTH_WEEKS', 3);`	47	`define('CALENDAR_USE_MONTH_WEEKS', 3);`
48		48
49	`/**`	49	`/**`
50	`* Contains a factory method to return a Singleton instance of a class`	50	`* Contains a factory method to return a Singleton instance of a class`
51	`* implementing the Calendar_Engine_Interface.<br>`	51	`* implementing the Calendar_Engine_Interface.<br>`
52	`* <b>Note:</b> this class must be modified to "register" alternative`	52	`* <b>Note:</b> this class must be modified to "register" alternative`
53	`* Calendar_Engines. The engine used can be controlled with the constant`	53	`* Calendar_Engines. The engine used can be controlled with the constant`
54	`* CALENDAR_ENGINE`	54	`* CALENDAR_ENGINE`
55	`* @see Calendar_Engine_Interface`	55	`* @see Calendar_Engine_Interface`
56	`* @package Calendar`	56	`* @package Calendar`
57	`* @access protected`	57	`* @access protected`
58	`*/`	58	`*/`
59	`class Calendar_Engine_Factory`	59	`class Calendar_Engine_Factory`
60	`{`	60	`{`
61	`/**`	61	`/**`
62	`* Returns an instance of the engine`	62	`* Returns an instance of the engine`
63	`* @return object instance of a calendar calculation engine`	63	`* @return object instance of a calendar calculation engine`
64	`* @access protected`	64	`* @access protected`
65	`*/`	65	`*/`
66	`function & getEngine()`	66	`function & getEngine()`
67	`{`	67	`{`
68	`static $engine = false;`	68	`static $engine = false;`
69	`switch (CALENDAR_ENGINE) {`	69	`switch (CALENDAR_ENGINE) {`
70	`case 'PearDate':`	70	`case 'PearDate':`
71	`$class = 'Calendar_Engine_PearDate';`	71	`$class = 'Calendar_Engine_PearDate';`
72	`break;`	72	`break;`
73	`case 'UnixTS':`	73	`case 'UnixTS':`
74	`default:`	74	`default:`
75	`$class = 'Calendar_Engine_UnixTS';`	75	`$class = 'Calendar_Engine_UnixTS';`
76	`break;`	76	`break;`
77	`}`	77	`}`
78	`if (!$engine) {`	78	`if (!$engine) {`
79	`if (!class_exists($class)) {`	79	`if (!class_exists($class)) {`
80	`require_once CALENDAR_ROOT.'Engine'.DIRECTORY_SEPARATOR.CALENDAR_ENGINE.'.php';`	80	`require_once CALENDAR_ROOT.'Engine'.DIRECTORY_SEPARATOR.CALENDAR_ENGINE.'.php';`
81	`}`	81	`}`
82	`$engine = new $class;`	82	`$engine = new $class;`
83	`}`	83	`}`
84	`return $engine;`	84	`return $engine;`
85	`}`	85	`}`
86	`}`	86	`}`
87		87
88	`/**`	88	`/**`
89	`* Base class for Calendar API. This class should not be instantiated`	89	`* Base class for Calendar API. This class should not be instantiated`
90	`* directly.`	90	`* directly.`
91	`* @abstract`	91	`* @abstract`
92	`* @package Calendar`	92	`* @package Calendar`
93	`*/`	93	`*/`
94	`class Calendar`	94	`class Calendar`
95	`{`	95	`{`
96	`/**`	96	`/**`
97	`* Instance of class implementing calendar engine interface`	97	`* Instance of class implementing calendar engine interface`
98	`* @var object`	98	`* @var object`
99	`* @access private`	99	`* @access private`
100	`*/`	100	`*/`
101	`var $cE;`	101	`var $cE;`
102		102
103	`/**`	103	`/**`
104	`* Instance of Calendar_Validator (lazy initialized when isValid() or`	104	`* Instance of Calendar_Validator (lazy initialized when isValid() or`
105	`* getValidor() is called`	105	`* getValidor() is called`
106	`* @var Calendar_Validator`	106	`* @var Calendar_Validator`
107	`* @access private`	107	`* @access private`
108	`*/`	108	`*/`
109	`var $validator;`	109	`var $validator;`
110		110
111	`/**`	111	`/**`
112	`* Year for this calendar object e.g. 2003`	112	`* Year for this calendar object e.g. 2003`
113	`* @access private`	113	`* @access private`
114	`* @var int`	114	`* @var int`
115	`*/`	115	`*/`
116	`var $year;`	116	`var $year;`
117		117
118	`/**`	118	`/**`
119	`* Month for this calendar object e.g. 9`	119	`* Month for this calendar object e.g. 9`
120	`* @access private`	120	`* @access private`
121	`* @var int`	121	`* @var int`
122	`*/`	122	`*/`
123	`var $month;`	123	`var $month;`
124		124
125	`/**`	125	`/**`
126	`* Day of month for this calendar object e.g. 23`	126	`* Day of month for this calendar object e.g. 23`
127	`* @access private`	127	`* @access private`
128	`* @var int`	128	`* @var int`
129	`*/`	129	`*/`
130	`var $day;`	130	`var $day;`
131		131
132	`/**`	132	`/**`
133	`* Hour of day for this calendar object e.g. 13`	133	`* Hour of day for this calendar object e.g. 13`
134	`* @access private`	134	`* @access private`
135	`* @var int`	135	`* @var int`
136	`*/`	136	`*/`
137	`var $hour;`	137	`var $hour;`
138		138
139	`/**`	139	`/**`
140	`* Minute of hour this calendar object e.g. 46`	140	`* Minute of hour this calendar object e.g. 46`
141	`* @access private`	141	`* @access private`
142	`* @var int`	142	`* @var int`
143	`*/`	143	`*/`
144	`var $minute;`	144	`var $minute;`
145		145
146	`/**`	146	`/**`
147	`* Second of minute this calendar object e.g. 34`	147	`* Second of minute this calendar object e.g. 34`
148	`* @access private`	148	`* @access private`
149	`* @var int`	149	`* @var int`
150	`*/`	150	`*/`
151	`var $second;`	151	`var $second;`
152		152
153	`/**`	153	`/**`
154	`* Marks this calendar object as selected (e.g. 'today')`	154	`* Marks this calendar object as selected (e.g. 'today')`
155	`* @access private`	155	`* @access private`
156	`* @var boolean`	156	`* @var boolean`
157	`*/`	157	`*/`
158	`var $selected = false;`	158	`var $selected = false;`
159		159
160	`/**`	160	`/**`
161	`* Collection of child calendar objects created from subclasses`	161	`* Collection of child calendar objects created from subclasses`
162	`* of Calendar. Type depends on the object which created them.`	162	`* of Calendar. Type depends on the object which created them.`
163	`* @access private`	163	`* @access private`
164	`* @var array`	164	`* @var array`
165	`*/`	165	`*/`
166	`var $children = array();`	166	`var $children = array();`
167		167
168	`/**`	168	`/**`
169	`* Constructs the Calendar`	169	`* Constructs the Calendar`
170	`* @param int year`	170	`* @param int year`
171	`* @param int month`	171	`* @param int month`
172	`* @param int day`	172	`* @param int day`
173	`* @param int hour`	173	`* @param int hour`
174	`* @param int minute`	174	`* @param int minute`
175	`* @param int second`	175	`* @param int second`
176	`* @access protected`	176	`* @access protected`
177	`*/`	177	`*/`
178	`function Calendar($y = 2000, $m = 1, $d = 1, $h = 0, $i = 0, $s = 0)`	178	`function Calendar($y = 2000, $m = 1, $d = 1, $h = 0, $i = 0, $s = 0)`
179	`{`	179	`{`
180	`static $cE = null;`	180	`static $cE = null;`
181	`if (!isset($cE)) {`	181	`if (!isset($cE)) {`
182	`$cE = & Calendar_Engine_Factory::getEngine();`	182	`$cE = & Calendar_Engine_Factory::getEngine();`
183	`}`	183	`}`
184	`$this->cE = & $cE;`	184	`$this->cE = & $cE;`
185	`$this->year = (int)$y;`	185	`$this->year = (int)$y;`
186	`$this->month = (int)$m;`	186	`$this->month = (int)$m;`
187	`$this->day = (int)$d;`	187	`$this->day = (int)$d;`
188	`$this->hour = (int)$h;`	188	`$this->hour = (int)$h;`
189	`$this->minute = (int)$i;`	189	`$this->minute = (int)$i;`
190	`$this->second = (int)$s;`	190	`$this->second = (int)$s;`
191	`}`	191	`}`
192		192
193	`/**`	193	`/**`
194	`* Defines the calendar by a timestamp (Unix or ISO-8601), replacing values`	194	`* Defines the calendar by a timestamp (Unix or ISO-8601), replacing values`
195	`* passed to the constructor`	195	`* passed to the constructor`
196	`* @param int\|string Unix or ISO-8601 timestamp`	196	`* @param int\|string Unix or ISO-8601 timestamp`
197	`* @return void`	197	`* @return void`
198	`* @access public`	198	`* @access public`
199	`*/`	199	`*/`
200	`function setTimestamp($ts)`	200	`function setTimestamp($ts)`
201	`{`	201	`{`
202	`$this->year = $this->cE->stampToYear($ts);`	202	`$this->year = $this->cE->stampToYear($ts);`
203	`$this->month = $this->cE->stampToMonth($ts);`	203	`$this->month = $this->cE->stampToMonth($ts);`
204	`$this->day = $this->cE->stampToDay($ts);`	204	`$this->day = $this->cE->stampToDay($ts);`
205	`$this->hour = $this->cE->stampToHour($ts);`	205	`$this->hour = $this->cE->stampToHour($ts);`
206	`$this->minute = $this->cE->stampToMinute($ts);`	206	`$this->minute = $this->cE->stampToMinute($ts);`
207	`$this->second = $this->cE->stampToSecond($ts);`	207	`$this->second = $this->cE->stampToSecond($ts);`
208	`}`	208	`}`
209		209
210	`/**`	210	`/**`
211	`* Returns a timestamp from the current date / time values. Format of`	211	`* Returns a timestamp from the current date / time values. Format of`
212	`* timestamp depends on Calendar_Engine implementation being used`	212	`* timestamp depends on Calendar_Engine implementation being used`
213	`* @return int\|string timestamp`	213	`* @return int\|string timestamp`
214	`* @access public`	214	`* @access public`
215	`*/`	215	`*/`
216	`function getTimestamp()`	216	`function getTimestamp()`
217	`{`	217	`{`
218	`return $this->cE->dateToStamp(`	218	`return $this->cE->dateToStamp(`
219	`$this->year, $this->month, $this->day,`	219	`$this->year, $this->month, $this->day,`
220	`$this->hour, $this->minute, $this->second);`	220	`$this->hour, $this->minute, $this->second);`
221	`}`	221	`}`
222		222
223	`/**`	223	`/**`
224	`* Defines calendar object as selected (e.g. for today)`	224	`* Defines calendar object as selected (e.g. for today)`
225	`* @param boolean state whether Calendar subclass`	225	`* @param boolean state whether Calendar subclass`
226	`* @return void`	226	`* @return void`
227	`* @access public`	227	`* @access public`
228	`*/`	228	`*/`
229	`function setSelected($state = true)`	229	`function setSelected($state = true)`
230	`{`	230	`{`
231	`$this->selected = $state;`	231	`$this->selected = $state;`
232	`}`	232	`}`
233		233
234	`/**`	234	`/**`
235	`* True if the calendar subclass object is selected (e.g. today)`	235	`* True if the calendar subclass object is selected (e.g. today)`
236	`* @return boolean`	236	`* @return boolean`
237	`* @access public`	237	`* @access public`
238	`*/`	238	`*/`
239	`function isSelected()`	239	`function isSelected()`
240	`{`	240	`{`
241	`return $this->selected;`	241	`return $this->selected;`
242	`}`	242	`}`
243		243
244	`/**`	244	`/**`
245	`* Adjusts the date (helper method)`	245	`* Adjusts the date (helper method)`
246	`* @return void`	246	`* @return void`
247	`* @access public`	247	`* @access public`
248	`*/`	248	`*/`
249	`function adjust()`	249	`function adjust()`
250	`{`	250	`{`
251	`$stamp = $this->getTimeStamp();`	251	`$stamp = $this->getTimeStamp();`
252	`$this->year = $this->cE->stampToYear($stamp);`	252	`$this->year = $this->cE->stampToYear($stamp);`
253	`$this->month = $this->cE->stampToMonth($stamp);`	253	`$this->month = $this->cE->stampToMonth($stamp);`
254	`$this->day = $this->cE->stampToDay($stamp);`	254	`$this->day = $this->cE->stampToDay($stamp);`
255	`$this->hour = $this->cE->stampToHour($stamp);`	255	`$this->hour = $this->cE->stampToHour($stamp);`
256	`$this->minute = $this->cE->stampToMinute($stamp);`	256	`$this->minute = $this->cE->stampToMinute($stamp);`
257	`$this->second = $this->cE->stampToSecond($stamp);`	257	`$this->second = $this->cE->stampToSecond($stamp);`
258	`}`	258	`}`
259		259
260	`/**`	260	`/**`
261	`* Returns the date as an associative array (helper method)`	261	`* Returns the date as an associative array (helper method)`
262	`* @param mixed timestamp (leave empty for current timestamp)`	262	`* @param mixed timestamp (leave empty for current timestamp)`
263	`* @return array`	263	`* @return array`
264	`* @access public`	264	`* @access public`
265	`*/`	265	`*/`
266	`function toArray($stamp=null)`	266	`function toArray($stamp=null)`
267	`{`	267	`{`
268	`if (is_null($stamp)) {`	268	`if (is_null($stamp)) {`
269	`$stamp = $this->getTimeStamp();`	269	`$stamp = $this->getTimeStamp();`
270	`}`	270	`}`
271	`return array(`	271	`return array(`
272	`'year' => $this->cE->stampToYear($stamp),`	272	`'year' => $this->cE->stampToYear($stamp),`
273	`'month' => $this->cE->stampToMonth($stamp),`	273	`'month' => $this->cE->stampToMonth($stamp),`
274	`'day' => $this->cE->stampToDay($stamp),`	274	`'day' => $this->cE->stampToDay($stamp),`
275	`'hour' => $this->cE->stampToHour($stamp),`	275	`'hour' => $this->cE->stampToHour($stamp),`
276	`'minute' => $this->cE->stampToMinute($stamp),`	276	`'minute' => $this->cE->stampToMinute($stamp),`
277	`'second' => $this->cE->stampToSecond($stamp)`	277	`'second' => $this->cE->stampToSecond($stamp)`
278	`);`	278	`);`
279	`}`	279	`}`
280		280
281	`/**`	281	`/**`
282	`* Returns the value as an associative array (helper method)`	282	`* Returns the value as an associative array (helper method)`
283	`* @param string type of date object that return value represents`	283	`* @param string type of date object that return value represents`
284	`* @param string $format ['int' \| 'array' \| 'timestamp' \| 'object']`	284	`* @param string $format ['int' \| 'array' \| 'timestamp' \| 'object']`
285	`* @param mixed timestamp (depending on Calendar engine being used)`	285	`* @param mixed timestamp (depending on Calendar engine being used)`
286	`* @param int integer default value (i.e. give me the answer quick)`	286	`* @param int integer default value (i.e. give me the answer quick)`
287	`* @return mixed`	287	`* @return mixed`
288	`* @access private`	288	`* @access private`
289	`*/`	289	`*/`
290	`function returnValue($returnType, $format, $stamp, $default)`	290	`function returnValue($returnType, $format, $stamp, $default)`
291	`{`	291	`{`
292	`switch (strtolower($format)) {`	292	`switch (strtolower($format)) {`
293	`case 'int':`	293	`case 'int':`
294	`return $default;`	294	`return $default;`
295	`case 'array':`	295	`case 'array':`
296	`return $this->toArray($stamp);`	296	`return $this->toArray($stamp);`
297	`break;`	297	`break;`
298	`case 'object':`	298	`case 'object':`
299	`require_once CALENDAR_ROOT.'Factory.php';`	299	`require_once CALENDAR_ROOT.'Factory.php';`
300	`return Calendar_Factory::createByTimestamp($returnType,$stamp);`	300	`return Calendar_Factory::createByTimestamp($returnType,$stamp);`
301	`break;`	301	`break;`
302	`case 'timestamp':`	302	`case 'timestamp':`
303	`default:`	303	`default:`
304	`return $stamp;`	304	`return $stamp;`
305	`break;`	305	`break;`
306	`}`	306	`}`
307	`}`	307	`}`
308		308
309	`/**`	309	`/**`
310	`* Abstract method for building the children of a calendar object.`	310	`* Abstract method for building the children of a calendar object.`
311	`* Implemented by Calendar subclasses`	311	`* Implemented by Calendar subclasses`
312	`* @param array containing Calendar objects to select (optional)`	312	`* @param array containing Calendar objects to select (optional)`
313	`* @return boolean`	313	`* @return boolean`
314	`* @access public`	314	`* @access public`
315	`* @abstract`	315	`* @abstract`
316	`*/`	316	`*/`
317	`function build($sDates = array())`	317	`function build($sDates = array())`
318	`{`	318	`{`
319	`require_once 'PEAR.php';`	319	`require_once 'PEAR.php';`
320	`PEAR::raiseError(`	320	`PEAR::raiseError(`
321	`'Calendar::build is abstract', null, PEAR_ERROR_TRIGGER,`	321	`'Calendar::build is abstract', null, PEAR_ERROR_TRIGGER,`
322	`E_USER_NOTICE, 'Calendar::build()');`	322	`E_USER_NOTICE, 'Calendar::build()');`
323	`return false;`	323	`return false;`
324	`}`	324	`}`
325		325
326	`/**`	326	`/**`
327	`* Abstract method for selected data objects called from build`	327	`* Abstract method for selected data objects called from build`
328	`* @param array`	328	`* @param array`
329	`* @return boolean`	329	`* @return boolean`
330	`* @access public`	330	`* @access public`
331	`* @abstract`	331	`* @abstract`
332	`*/`	332	`*/`
333	`function setSelection($sDates)`	333	`function setSelection($sDates)`
334	`{`	334	`{`
335	`require_once 'PEAR.php';`	335	`require_once 'PEAR.php';`
336	`PEAR::raiseError(`	336	`PEAR::raiseError(`
337	`'Calendar::setSelection is abstract', null, PEAR_ERROR_TRIGGER,`	337	`'Calendar::setSelection is abstract', null, PEAR_ERROR_TRIGGER,`
338	`E_USER_NOTICE, 'Calendar::setSelection()');`	338	`E_USER_NOTICE, 'Calendar::setSelection()');`
339	`return false;`	339	`return false;`
340	`}`	340	`}`
341		341
342	`/**`	342	`/**`
343	`* Iterator method for fetching child Calendar subclass objects`	343	`* Iterator method for fetching child Calendar subclass objects`
344	`* (e.g. a minute from an hour object). On reaching the end of`	344	`* (e.g. a minute from an hour object). On reaching the end of`
345	`* the collection, returns false and resets the collection for`	345	`* the collection, returns false and resets the collection for`
346	`* further iteratations.`	346	`* further iteratations.`
347	`* @return mixed either an object subclass of Calendar or false`	347	`* @return mixed either an object subclass of Calendar or false`
348	`* @access public`	348	`* @access public`
349	`*/`	349	`*/`
350	`function fetch()`	350	`function fetch()`
351	`{`	351	`{`
352	`$child = each($this->children);`	352	`$child = each($this->children);`
353	`if ($child) {`	353	`if ($child) {`
354	`return $child['value'];`	354	`return $child['value'];`
355	`} else {`	355	`} else {`
356	`reset($this->children);`	356	`reset($this->children);`
357	`return false;`	357	`return false;`
358	`}`	358	`}`
359	`}`	359	`}`
360		360
361	`/**`	361	`/**`
362	`* Fetches all child from the current collection of children`	362	`* Fetches all child from the current collection of children`
363	`* @return array`	363	`* @return array`
364	`* @access public`	364	`* @access public`
365	`*/`	365	`*/`
366	`function fetchAll()`	366	`function fetchAll()`
367	`{`	367	`{`
368	`return $this->children;`	368	`return $this->children;`
369	`}`	369	`}`
370		370
371	`/**`	371	`/**`
372	`* Get the number Calendar subclass objects stored in the internal`	372	`* Get the number Calendar subclass objects stored in the internal`
373	`* collection.`	373	`* collection.`
374	`* @return int`	374	`* @return int`
375	`* @access public`	375	`* @access public`
376	`*/`	376	`*/`
377	`function size()`	377	`function size()`
378	`{`	378	`{`
379	`return count($this->children);`	379	`return count($this->children);`
380	`}`	380	`}`
381		381
382	`/**`	382	`/**`
383	`* Determine whether this date is valid, with the bounds determined by`	383	`* Determine whether this date is valid, with the bounds determined by`
384	`* the Calendar_Engine. The call is passed on to`	384	`* the Calendar_Engine. The call is passed on to`
385	`* Calendar_Validator::isValid`	385	`* Calendar_Validator::isValid`
386	`* @return boolean`	386	`* @return boolean`
387	`* @access public`	387	`* @access public`
388	`*/`	388	`*/`
389	`function isValid()`	389	`function isValid()`
390	`{`	390	`{`
391	`$validator = & $this->getValidator();`	391	`$validator = & $this->getValidator();`
392	`return $validator->isValid();`	392	`return $validator->isValid();`
393	`}`	393	`}`
394		394
395	`/**`	395	`/**`
396	`* Returns an instance of Calendar_Validator`	396	`* Returns an instance of Calendar_Validator`
397	`* @return Calendar_Validator`	397	`* @return Calendar_Validator`
398	`* @access public`	398	`* @access public`
399	`*/`	399	`*/`
400	`function & getValidator()`	400	`function & getValidator()`
401	`{`	401	`{`
402	`if (!isset($this->validator)) {`	402	`if (!isset($this->validator)) {`
403	`require_once CALENDAR_ROOT.'Validator.php';`	403	`require_once CALENDAR_ROOT.'Validator.php';`
404	`$this->validator = & new Calendar_Validator($this);`	404	`$this->validator = new Calendar_Validator($this);`
405	`}`	405	`}`
406	`return $this->validator;`	406	`return $this->validator;`
407	`}`	407	`}`
408		408
409	`/**`	409	`/**`
410	`* Returns a reference to the current Calendar_Engine being used. Useful`	410	`* Returns a reference to the current Calendar_Engine being used. Useful`
411	`* for Calendar_Table_Helper and Calendar_Validator`	411	`* for Calendar_Table_Helper and Calendar_Validator`
412	`* @return object implementing Calendar_Engine_Inteface`	412	`* @return object implementing Calendar_Engine_Inteface`
413	`* @access protected`	413	`* @access protected`
414	`*/`	414	`*/`
415	`function & getEngine()`	415	`function & getEngine()`
416	`{`	416	`{`
417	`return $this->cE;`	417	`return $this->cE;`
418	`}`	418	`}`
419		419
420	`/**`	420	`/**`
421	`* Set the CALENDAR_FIRST_DAY_OF_WEEK constant to the $firstDay value`	421	`* Set the CALENDAR_FIRST_DAY_OF_WEEK constant to the $firstDay value`
422	`* if the constant is not set yet.`	422	`* if the constant is not set yet.`
423	`* @throws E_USER_WARNING this method throws a WARNING if the`	423	`* @throws E_USER_WARNING this method throws a WARNING if the`
424	`* CALENDAR_FIRST_DAY_OF_WEEK constant is already defined and`	424	`* CALENDAR_FIRST_DAY_OF_WEEK constant is already defined and`
425	`* the $firstDay parameter is set to a different value`	425	`* the $firstDay parameter is set to a different value`
426	`* @param integer $firstDay first day of the week (0=sunday, 1=monday, ...)`	426	`* @param integer $firstDay first day of the week (0=sunday, 1=monday, ...)`
427	`* @return integer`	427	`* @return integer`
428	`* @access protected`	428	`* @access protected`
429	`*/`	429	`*/`
430	`function defineFirstDayOfWeek($firstDay = null)`	430	`function defineFirstDayOfWeek($firstDay = null)`
431	`{`	431	`{`
432	`if (defined('CALENDAR_FIRST_DAY_OF_WEEK')) {`	432	`if (defined('CALENDAR_FIRST_DAY_OF_WEEK')) {`
433	`if (!is_null($firstDay) && ($firstDay != CALENDAR_FIRST_DAY_OF_WEEK)) {`	433	`if (!is_null($firstDay) && ($firstDay != CALENDAR_FIRST_DAY_OF_WEEK)) {`
434	`$msg = 'CALENDAR_FIRST_DAY_OF_WEEK constant already defined.'`	434	`$msg = 'CALENDAR_FIRST_DAY_OF_WEEK constant already defined.'`
435	`.' The $firstDay parameter will be ignored.';`	435	`.' The $firstDay parameter will be ignored.';`
436	`trigger_error($msg, E_USER_WARNING);`	436	`trigger_error($msg, E_USER_WARNING);`
437	`}`	437	`}`
438	`return CALENDAR_FIRST_DAY_OF_WEEK;`	438	`return CALENDAR_FIRST_DAY_OF_WEEK;`
439	`}`	439	`}`
440	`if (is_null($firstDay)) {`	440	`if (is_null($firstDay)) {`
441	`$firstDay = $this->cE->getFirstDayOfWeek(`	441	`$firstDay = $this->cE->getFirstDayOfWeek(`
442	`$this->thisYear(),`	442	`$this->thisYear(),`
443	`$this->thisMonth(),`	443	`$this->thisMonth(),`
444	`$this->thisDay()`	444	`$this->thisDay()`
445	`);`	445	`);`
446	`}`	446	`}`
447	`define ('CALENDAR_FIRST_DAY_OF_WEEK', $firstDay);`	447	`define ('CALENDAR_FIRST_DAY_OF_WEEK', $firstDay);`
448	`return CALENDAR_FIRST_DAY_OF_WEEK;`	448	`return CALENDAR_FIRST_DAY_OF_WEEK;`
449	`}`	449	`}`
450		450
451	`/**`	451	`/**`
452	`* Returns the value for the previous year`	452	`* Returns the value for the previous year`
453	`* @param string return value format ['int' \| 'timestamp' \| 'object' \| 'array']`	453	`* @param string return value format ['int' \| 'timestamp' \| 'object' \| 'array']`
454	`* @return int e.g. 2002 or timestamp`	454	`* @return int e.g. 2002 or timestamp`
455	`* @access public`	455	`* @access public`
456	`*/`	456	`*/`
457	`function prevYear($format = 'int')`	457	`function prevYear($format = 'int')`
458	`{`	458	`{`
459	`$ts = $this->cE->dateToStamp($this->year-1, 1, 1, 0, 0, 0);`	459	`$ts = $this->cE->dateToStamp($this->year-1, 1, 1, 0, 0, 0);`
460	`return $this->returnValue('Year', $format, $ts, $this->year-1);`	460	`return $this->returnValue('Year', $format, $ts, $this->year-1);`
461	`}`	461	`}`
462		462
463	`/**`	463	`/**`
464	`* Returns the value for this year`	464	`* Returns the value for this year`
465	`* @param string return value format ['int' \| 'timestamp' \| 'object' \| 'array']`	465	`* @param string return value format ['int' \| 'timestamp' \| 'object' \| 'array']`
466	`* @return int e.g. 2003 or timestamp`	466	`* @return int e.g. 2003 or timestamp`
467	`* @access public`	467	`* @access public`
468	`*/`	468	`*/`
469	`function thisYear($format = 'int')`	469	`function thisYear($format = 'int')`
470	`{`	470	`{`
471	`$ts = $this->cE->dateToStamp($this->year, 1, 1, 0, 0, 0);`	471	`$ts = $this->cE->dateToStamp($this->year, 1, 1, 0, 0, 0);`
472	`return $this->returnValue('Year', $format, $ts, $this->year);`	472	`return $this->returnValue('Year', $format, $ts, $this->year);`
473	`}`	473	`}`
474		474
475	`/**`	475	`/**`
476	`* Returns the value for next year`	476	`* Returns the value for next year`
477	`* @param string return value format ['int' \| 'timestamp' \| 'object' \| 'array']`	477	`* @param string return value format ['int' \| 'timestamp' \| 'object' \| 'array']`
478	`* @return int e.g. 2004 or timestamp`	478	`* @return int e.g. 2004 or timestamp`
479	`* @access public`	479	`* @access public`
480	`*/`	480	`*/`
481	`function nextYear($format = 'int')`	481	`function nextYear($format = 'int')`
482	`{`	482	`{`
483	`$ts = $this->cE->dateToStamp($this->year+1, 1, 1, 0, 0, 0);`	483	`$ts = $this->cE->dateToStamp($this->year+1, 1, 1, 0, 0, 0);`
484	`return $this->returnValue('Year', $format, $ts, $this->year+1);`	484	`return $this->returnValue('Year', $format, $ts, $this->year+1);`
485	`}`	485	`}`
486		486
487	`/**`	487	`/**`
488	`* Returns the value for the previous month`	488	`* Returns the value for the previous month`
489	`* @param string return value format ['int' \| 'timestamp' \| 'object' \| 'array']`	489	`* @param string return value format ['int' \| 'timestamp' \| 'object' \| 'array']`
490	`* @return int e.g. 4 or Unix timestamp`	490	`* @return int e.g. 4 or Unix timestamp`
491	`* @access public`	491	`* @access public`
492	`*/`	492	`*/`
493	`function prevMonth($format = 'int')`	493	`function prevMonth($format = 'int')`
494	`{`	494	`{`
495	`$ts = $this->cE->dateToStamp($this->year, $this->month-1, 1, 0, 0, 0);`	495	`$ts = $this->cE->dateToStamp($this->year, $this->month-1, 1, 0, 0, 0);`
496	`return $this->returnValue('Month', $format, $ts, $this->cE->stampToMonth($ts));`	496	`return $this->returnValue('Month', $format, $ts, $this->cE->stampToMonth($ts));`
497	`}`	497	`}`
498		498
499	`/**`	499	`/**`
500	`* Returns the value for this month`	500	`* Returns the value for this month`

Subversion Repositories Applications.gtt

(root)/trunk/bibliotheque/pear/Calendar/Calendar.php – Rev 61 → 66