mambax7 / extcal

class/pear/Calendar/Week.php

<?php

/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */

/**
 * Contains the Calendar_Week class.
 *
 * PHP versions 4 and 5
 *
 * LICENSE: Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. The name of the author may not be used to endorse or promote products
 *    derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE FREEBSD PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY
 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * @category  Date and Time
 *
 * @author    Harry Fuecks <hfuecks@phppatterns.com>
 * @author    Lorenzo Alberton <l.alberton@quipo.it>
 * @copyright 2003-2007 Harry Fuecks, Lorenzo Alberton
 * @license   http://www.debian.org/misc/bsd.license  BSD License (3 Clause)
 *
 * @link      http://pear.php.net/package/Calendar
 */

/**
 * Allows Calendar include path to be redefined.
 *
 * @ignore
 */
if (!defined('CALENDAR_ROOT')) {
    define('CALENDAR_ROOT', 'Calendar/');
}

/**
 * Load Calendar base class.
 */
require_once CALENDAR_ROOT . 'Calendar.php';

/**
 * Represents a Week and builds Days in tabular format<br>
 * <code>
 * require_once __DIR__ . '/Calendar/Week.php';
 * $Week = new Calendar_Week(2003, 10, 1); Oct 2003, 1st tabular week
 * echo '<tr>';
 * while (false !== ($Day = $Week->fetch())) {
 *     if ($Day->isEmpty()) {
 *         echo '<td>&nbsp;</td>';
 *     } else {
 *         echo '<td>'.$Day->thisDay().'</td>';
 *      }
 * }
 * echo '</tr>';
 * </code>.
 *
 * @category  Date and Time
 *
 * @author    Harry Fuecks <hfuecks@phppatterns.com>
 * @author    Lorenzo Alberton <l.alberton@quipo.it>
 * @copyright 2003-2007 Harry Fuecks, Lorenzo Alberton
 * @license   http://www.debian.org/misc/bsd.license  BSD License (3 Clause)
 *
 * @link      http://pear.php.net/package/Calendar
 */
class Calendar_Week extends Calendar
{
    /**
     * Instance of Calendar_Table_Helper.
     *
     * @var Calendar_Table_Helper
     */
    public $tableHelper;

    /**
     * Stores the timestamp of the first day of this week.
     *
     * @var object
     */
    public $thisWeek;

    /**
     * Stores the timestamp of first day of previous week.
     *
     * @var object
     */
    public $prevWeek;

    /**
     * Stores the timestamp of first day of next week.
     *
     * @var object
     */
    public $nextWeek;

    /**
     * Used by build() to set empty days.
     *
     * @var bool
     */
    public $firstWeek = false;

    /**
     * Used by build() to set empty days.
     *
     * @var bool
     */
    public $lastWeek = false;

    /**
     * First day of the week (0=sunday, 1=monday...).
     *
     * @var bool
     */
    public $firstDay = 1;

    /**
     * Constructs Week.
     *
     * @param int $y        year e.g. 2003
     * @param int $m        month e.g. 5
     * @param int $d        a day of the desired week
     * @param int $firstDay (optional) first day of week (e.g. 0 for Sunday, 2 for Tuesday etc.)
     */
    public function __construct($y, $m, $d, $firstDay = null)
    {
        require_once CALENDAR_ROOT . 'Table/Helper.php';
        parent::__construct($y, $m, $d);
        $this->firstDay    = $this->defineFirstDayOfWeek($firstDay);

The property $firstDay was declared of type boolean, but $this->defineFirstDayOfWeek($firstDay) is of type integer. Maybe add a type cast?

        $this->tableHelper = new Calendar_Table_Helper($this, $this->firstDay);
        $this->thisWeek    = $this->tableHelper->getWeekStart($y, $m, $d, $this->firstDay);

It seems like $this->tableHelper->getWeekStart($y, $m, $d, $this->firstDay) of type integer is incompatible with the declared type object of property $thisWeek.

        $this->prevWeek    = $this->tableHelper->getWeekStart($y, $m, $d - $this->cE->getDaysInWeek($this->thisYear(), $this->thisMonth(), $this->thisDay()), $this->firstDay);

It seems like $this->tableHelper->getWeekStart($y, $m, $d - $this->cE->getDaysInWeek($this->thisYear(), $this->thisMonth(), $this->thisDay()), $this->firstDay) of type integer is incompatible with the declared type object of property $prevWeek.

        $this->nextWeek    = $this->tableHelper->getWeekStart($y, $m, $d + $this->cE->getDaysInWeek($this->thisYear(), $this->thisMonth(), $this->thisDay()), $this->firstDay);

It seems like $this->tableHelper->getWeekStart($y, $m, $d + $this->cE->getDaysInWeek($this->thisYear(), $this->thisMonth(), $this->thisDay()), $this->firstDay) of type integer is incompatible with the declared type object of property $nextWeek.

    }

    /**
     * Defines the calendar by a timestamp (Unix or ISO-8601), replacing values
     * passed to the constructor.
     *
     * @param int|string $ts Unix or ISO-8601 timestamp
     */
    public function setTimestamp($ts)
    {
        parent::setTimestamp($ts);
        $this->thisWeek = $this->tableHelper->getWeekStart($this->year, $this->month, $this->day, $this->firstDay);

It seems like $this->tableHelper->getWeekStart($this->year, $this->month, $this->day, $this->firstDay) of type integer is incompatible with the declared type object of property $thisWeek.

$this->firstDay of type boolean is incompatible with the type integer expected by parameter $firstDay of Calendar_Table_Helper::getWeekStart().

        $this->prevWeek = $this->tableHelper->getWeekStart($this->year, $this->month, $this->day - $this->cE->getDaysInWeek($this->thisYear(), $this->thisMonth(), $this->thisDay()), $this->firstDay);

It seems like $this->tableHelper->getWeekStart($this->year, $this->month, $this->day - $this->cE->getDaysInWeek($this->thisYear(), $this->thisMonth(), $this->thisDay()), $this->firstDay) of type integer is incompatible with the declared type object of property $prevWeek.

        $this->nextWeek = $this->tableHelper->getWeekStart($this->year, $this->month, $this->day + $this->cE->getDaysInWeek($this->thisYear(), $this->thisMonth(), $this->thisDay()), $this->firstDay);

It seems like $this->tableHelper->getWeekStart($this->year, $this->month, $this->day + $this->cE->getDaysInWeek($this->thisYear(), $this->thisMonth(), $this->thisDay()), $this->firstDay) of type integer is incompatible with the declared type object of property $nextWeek.

    }

    /**
     * Builds Calendar_Day objects for this Week.
     *
     * @param array $sDates (optional) Calendar_Day objects representing selected dates
     *
     * @return bool
     */
    public function build($sDates = [])
    {
        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;
    }

    /**
     * Set as first week of the month.
     *
     * @param bool $state whether it's first or not
     */
    public function setFirst($state = true)
    {
        $this->firstWeek = $state;
    }

    /**
     * Set as last week of the month.
     *
     * @param bool $state whether it's lasst or not
     */
    public function setLast($state = true)
    {
        $this->lastWeek = $state;
    }

    /**
     * Called from build().
     *
     * @param array $sDates Calendar_Day objects representing selected dates
     * @return bool|void
     */
    public 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);
    }

    /**
     * Returns the value for this year.
     *
     * When a on the first/last week of the year, the year of the week is
     * calculated according to ISO-8601
     *
     * @param string $format return value format ['int' | 'timestamp' | 'object' | 'array']
     *
     * @return int e.g. 2003 or timestamp
     */
    public function thisYear($format = 'int')
    {
        if (null !== $this->thisWeek) {
            $tmp_cal = new Calendar();
            $tmp_cal->setTimestamp($this->thisWeek);

$this->thisWeek of type object is incompatible with the type integer|string expected by parameter $ts of Calendar::setTimestamp().

            $first_dow    = $tmp_cal->thisDay('array');
            $days_in_week = $tmp_cal->cE->getDaysInWeek($tmp_cal->year, $tmp_cal->month, $tmp_cal->day);
            $tmp_cal->day += $days_in_week;
            $last_dow     = $tmp_cal->thisDay('array');

            if ($first_dow['year'] == $last_dow['year']) {
                return $first_dow['year'];
            }

            if ($last_dow['day'] > floor($days_in_week / 2)) {
                return $last_dow['year'];
            }

            return $first_dow['year'];
        }

        return parent::thisYear();
    }

    /**
     * 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
     */
    public function prevWeek($format = 'n_in_month')
    {
        switch (mb_strtolower($format)) {
            case 'int':
            case 'n_in_month':
                return $this->firstWeek ? null : $this->thisWeek('n_in_month') - 1;
            case 'n_in_year':
                return $this->cE->getWeekNInYear($this->cE->stampToYear($this->prevWeek), $this->cE->stampToMonth($this->prevWeek), $this->cE->stampToDay($this->prevWeek));
            case 'array':
                return $this->toArray($this->prevWeek);
            case 'object':
                require_once CALENDAR_ROOT . 'Factory.php';

                return Calendar_Factory::createByTimestamp('Week', $this->prevWeek);
            case 'timestamp':
            default:
                return $this->prevWeek;
        }
    }

    /**
     * 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
     */
    public function thisWeek($format = 'n_in_month')
    {
        switch (mb_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);
            case 'n_in_year':
                return $this->cE->getWeekNInYear($this->cE->stampToYear($this->thisWeek), $this->cE->stampToMonth($this->thisWeek), $this->cE->stampToDay($this->thisWeek));
            case 'array':
                return $this->toArray($this->thisWeek);
            case 'object':
                require_once CALENDAR_ROOT . 'Factory.php';

                return Calendar_Factory::createByTimestamp('Week', $this->thisWeek);
            case 'timestamp':
            default:
                return $this->thisWeek;
        }
    }

    /**
     * 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
     */
    public function nextWeek($format = 'n_in_month')
    {
        switch (mb_strtolower($format)) {
            case 'int':
            case 'n_in_month':
                return $this->lastWeek ? null : $this->thisWeek('n_in_month') + 1;
            case 'n_in_year':
                return $this->cE->getWeekNInYear($this->cE->stampToYear($this->nextWeek), $this->cE->stampToMonth($this->nextWeek), $this->cE->stampToDay($this->nextWeek));
            case 'array':
                return $this->toArray($this->nextWeek);
            case 'object':
                require_once CALENDAR_ROOT . 'Factory.php';

                return Calendar_Factory::createByTimestamp('Week', $this->nextWeek);
            case 'timestamp':
            default:
                return $this->nextWeek;
        }
    }

    /**
     * Returns the instance of Calendar_Table_Helper.
     * Called from Calendar_Validator::isValidWeek.
     *
     * @return Calendar_Table_Helper
     */
    public function &getHelper()
    {
        return $this->tableHelper;
    }

    /**
     * Makes sure theres a value for $this->day.
     */
    public function findFirstDay()
    {
        if (!count($this->children) > 0) {
            $this->build();
            foreach ($this->children as $Day) {
                if (!$Day->isEmpty()) {
                    $this->day = $Day->thisDay();
                    break;
                }
            }
        }
    }
}