Proyectos de Subversion Moodle

<?php

// This file is part of Moodle - http://moodle.org/

//

// Moodle is free software: you can redistribute it and/or modify

// it under the terms of the GNU General Public License as published by

// the Free Software Foundation, either version 3 of the License, or

// (at your option) any later version.

//

// Moodle is distributed in the hope that it will be useful,

// but WITHOUT ANY WARRANTY; without even the implied warranty of

// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

// GNU General Public License for more details.

//

// You should have received a copy of the GNU General Public License

// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

namespace calendartype_gregorian;

use core_calendar\type_base;

/**

 * Handles calendar functions for the gregorian calendar.

 *

 * @package calendartype_gregorian

 * @copyright 2008 onwards Foodle Group {@link http://foodle.org}

 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

 */

class structure extends type_base {

    /**

     * Returns the name of the calendar.

     *

     * This is the non-translated name, usually just

     * the name of the folder.

     *

     * @return string the calendar name

     */

    public function get_name() {

        return 'gregorian';

    }

    /**

     * Returns a list of all the possible days for all months.

     *

     * This is used to generate the select box for the days

     * in the date selector elements. Some months contain more days

     * than others so this function should return all possible days as

     * we can not predict what month will be chosen (the user

     * may have JS turned off and we need to support this situation in

     * Moodle).

     *

     * @return array the days

     */

    public function get_days() {

        $days = array();

        for ($i = 1; $i <= 31; $i++) {

            $days[$i] = $i;

        }

        return $days;

    }

    /**

     * Returns a list of all the names of the months.

     *

     * @return array the month names

     */

    public function get_months() {

        $months = array();

        $date = new \DateTime('@1263556800');

        $date->setTimezone(new \DateTimeZone('UTC'));

        for ($i = 1; $i <= 12; $i++) {

            $date->setDate(2000, $i, 15);

            $months[$i] = userdate($date->getTimestamp(), '%B', 'UTC');

        }

        return $months;

    }

    /**

     * Returns the minimum year for the calendar.

     *

     * @return int The minimum year

     */

    public function get_min_year() {

        return 1900;

    }

    /**

     * Returns the maximum year for the calendar

     *

     * @return int The maximum year

     */

    public function get_max_year() {

        return 2050;

    }

    /**

     * Returns an array of years.

     *

     * @param int $minyear

     * @param int $maxyear

     * @return array the years

     */

    public function get_years($minyear = null, $maxyear = null) {

        if (is_null($minyear)) {

            $minyear = $this->get_min_year();

        }

        if (is_null($maxyear)) {

            $maxyear = $this->get_max_year();

        }

        $years = array();

        for ($i = $minyear; $i <= $maxyear; $i++) {

            $years[$i] = $i;

        }

        return $years;

    }

    /**

     * Returns a multidimensional array with information for day, month, year

     * and the order they are displayed when selecting a date.

     * The order in the array will be the order displayed when selecting a date.

     * Override this function to change the date selector order.

     *

     * @param int $minyear The year to start with

     * @param int $maxyear The year to finish with

     * @return array Full date information

     */

    public function get_date_order($minyear = null, $maxyear = null) {

        $dateinfo = array();

        $dateinfo['day'] = $this->get_days();

        $dateinfo['month'] = $this->get_months();

        $dateinfo['year'] = $this->get_years($minyear, $maxyear);

        return $dateinfo;

    }

    /**

     * Returns the number of days in a week.

     *

     * @return int the number of days

     */

    public function get_num_weekdays() {

        return 7;

    }

    /**

     * Returns an indexed list of all the names of the weekdays.

     *

     * The list starts with the index 0. Each index, representing a

     * day, must be an array that contains the indexes 'shortname'

     * and 'fullname'.

     *

     * @return array array of days

     */

    public function get_weekdays() {

        return array(

                'shortname' => get_string('sun', 'calendar'),

                'fullname' => get_string('sunday', 'calendar')

            ),

            1 => array(

                'shortname' => get_string('mon', 'calendar'),

                'fullname' => get_string('monday', 'calendar')

            ),

            2 => array(

                'shortname' => get_string('tue', 'calendar'),

                'fullname' => get_string('tuesday', 'calendar')

            ),

            3 => array(

                'shortname' => get_string('wed', 'calendar'),

                'fullname' => get_string('wednesday', 'calendar')

            ),

            4 => array(

                'shortname' => get_string('thu', 'calendar'),

                'fullname' => get_string('thursday', 'calendar')

            ),

            5 => array(

                'shortname' => get_string('fri', 'calendar'),

                'fullname' => get_string('friday', 'calendar')

            ),

            6 => array(

                'shortname' => get_string('sat', 'calendar'),

                'fullname' => get_string('saturday', 'calendar')

            ),

        );

    }

    /**

     * Returns the index of the starting week day.

     *

     * This may vary, for example some may consider Monday as the start of the week,

     * where as others may consider Sunday the start.

     *

     * @return int

     */

    public function get_starting_weekday() {

        global $CFG;

        if (isset($CFG->calendar_startwday)) {

            $firstday = $CFG->calendar_startwday;

        } else {

            $firstday = get_string('firstdayofweek', 'langconfig');

        }

        if (!is_numeric($firstday)) {

            $startingweekday = CALENDAR_DEFAULT_STARTING_WEEKDAY;

        } else {

            $startingweekday = intval($firstday) % 7;

        }

        return get_user_preferences('calendar_startwday', $startingweekday);

    }

    /**

     * Returns the index of the weekday for a specific calendar date.

     *

     * @param int $year

     * @param int $month

     * @param int $day

     * @return int

     */

    public function get_weekday($year, $month, $day) {

        return intval(date('w', mktime(12, 0, 0, $month, $day, $year)));

    }

    /**

     * Returns the number of days in a given month.

     *

     * @param int $year

     * @param int $month

     * @return int the number of days

     */

    public function get_num_days_in_month($year, $month) {

        return intval(date('t', mktime(0, 0, 0, $month, 1, $year)));

    }

    /**

     * Get the previous month.

     *

     * If the current month is January, it will get the last month of the previous year.

     *

     * @param int $year

     * @param int $month

     * @return array previous month and year

     */

    public function get_prev_month($year, $month) {

        if ($month == 1) {

            return array(12, $year - 1);

        } else {

            return array($month - 1, $year);

        }

    }

    /**

     * Get the next month.

     *

     * If the current month is December, it will get the first month of the following year.

     *

     * @param int $year

     * @param int $month

     * @return array the following month and year

     */

    public function get_next_month($year, $month) {

        if ($month == 12) {

            return array(1, $year + 1);

        } else {

            return array($month + 1, $year);

        }

    }

    /**

     * Returns a formatted string that represents a date in user time.

     *

     * If parameter fixday = true (default), then take off leading

     * zero from %d, else maintain it.

     *

     * @param int $time the timestamp in UTC, as obtained from the database

     * @param string $format strftime format

     * @param int|float|string $timezone the timezone to use

     *        {@link https://moodledev.io/docs/apis/subsystems/time#timezone}

     * @param bool $fixday if true then the leading zero from %d is removed,

     *        if false then the leading zero is maintained

     * @param bool $fixhour if true then the leading zero from %I is removed,

     *        if false then the leading zero is maintained

     * @return string the formatted date/time

     */

    public function timestamp_to_date_string($time, $format, $timezone, $fixday, $fixhour) {

        global $CFG;

        if (empty($format)) {

            $format = get_string('strftimedaydatetime', 'langconfig');

        }

        // Note: This historical logic was about fixing 12-hour time to remove

        // unnecessary leading zero was required because on Windows, PHP strftime

        // function did not support the correct 'hour without leading zero' parameter (%l).

        // This is no longer required because we use IntlDateFormatter.

        // Unfortunately though the original implementation was done incorrectly.

        // The documentation for strftime notes that for the "%l" and "%e" specifiers where

        // no leading zero is used, a space is used instead.

        // As a result we switch to the new format specifiers "%l" and "%e", wrap them in placeholders

        // and then remove the spaces.

        if (empty($CFG->nofixday) && $fixday) {

            // Config.php can force %d not to be fixed, but only if the format did not specify it.

            $format = str_replace(

                '%d',

                'DDHH%eHHDD',

                $format,

            );

        }

        if (empty($CFG->nofixhour) && $fixhour) {

            $format = str_replace(

                '%I',

                'DDHH%lHHDD',

                $format,

            );

        }

        if (is_string($time) && !is_numeric($time)) {

            debugging(

                "Invalid time passed to timestamp_to_date_string: '{$time}'",

                DEBUG_DEVELOPER,

            );

            $time = 0;

        }

        if ($time === null || $time === '') {

            $time = 0;

        }

        $time = new \DateTime("@{$time}", new \DateTimeZone(date_default_timezone_get()));

        date_default_timezone_set(\core_date::get_user_timezone($timezone));

        $formattedtime = \core_date::strftime(

            $format,

            $time,

            get_string('locale', 'langconfig'),

        );

        \core_date::set_default_server_timezone();

        // Use a simple regex to remove the placeholders and any leading spaces to match the historically

        // generated format.

        $formattedtime = preg_replace('/DDHH ?(\d{1,2})HHDD/', '$1', $formattedtime);

        return $formattedtime;

    }

    /**

     * Given a $time timestamp in GMT (seconds since epoch), returns an array that

     * represents the date in user time.

     *

     * @param int $time Timestamp in GMT

     * @param float|int|string $timezone offset's time with timezone, if float and not 99, then no

     *        dst offset is applied {@link https://moodledev.io/docs/apis/subsystems/time#timezone}

     * @return array an array that represents the date in user time

     */

    public function timestamp_to_date_array($time, $timezone = 99) {

        return usergetdate($time, $timezone);

    }

    /**

     * Provided with a day, month, year, hour and minute in a specific

     * calendar type convert it into the equivalent Gregorian date.

     *

     * In this function we don't need to do anything except pass the data

     * back as an array. This is because the date received is Gregorian.

     *

     * @param int $year

     * @param int $month

     * @param int $day

     * @param int $hour

     * @param int $minute

     * @return array the converted date

     */

    public function convert_from_gregorian($year, $month, $day, $hour = 0, $minute = 0) {

        $date = array();

        $date['year'] = $year;

        $date['month'] = $month;

        $date['day'] = $day;

        $date['hour'] = $hour;

        $date['minute'] = $minute;

        return $date;

    }

    /**

     * Provided with a day, month, year, hour and minute in a specific

     * calendar type convert it into the equivalent Gregorian date.

     *

     * In this function we don't need to do anything except pass the data

     * back as an array. This is because the date received is Gregorian.

     *

     * @param int $year

     * @param int $month

     * @param int $day

     * @param int $hour

     * @param int $minute

     * @return array the converted date

     */

    public function convert_to_gregorian($year, $month, $day, $hour = 0, $minute = 0) {

        $date = array();

        $date['year'] = $year;

        $date['month'] = $month;

        $date['day'] = $day;

        $date['hour'] = $hour;

        $date['minute'] = $minute;

        return $date;

    }

    /**

     * This return locale for windows os.

     *

     * @return string locale

     */

    public function locale_win_charset() {

        return get_string('localewincharset', 'langconfig');

    }

}