Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.x is supported too.
<?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/>.

< /** < * Tests legacy Moodle date/time functions. < * < * @package core < * @copyright 2015 Totara Learning Solutions Ltd {@link http://www.totaralms.com/} < * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later < * @author Petr Skoda <petr.skoda@totaralms.com> < */ < < defined('MOODLE_INTERNAL') || die();
> namespace core;
/** * Tests legacy Moodle date/time functions. * * @package core * @copyright 2015 Totara Learning Solutions Ltd {@link http://www.totaralms.com/} * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @author Petr Skoda <petr.skoda@totaralms.com> */
< class core_date_legacy_testcase extends advanced_testcase {
> class date_legacy_test extends \advanced_testcase {
public function test_settings() { global $CFG; $this->resetAfterTest(); $this->assertNotEmpty($CFG->timezone); $this->assertSame('99', $CFG->forcetimezone); $user = $this->getDataGenerator()->create_user(); $this->assertSame('99', $user->timezone); } public function test_get_user_timezone() { global $CFG, $USER; $this->resetAfterTest(); $user = $this->getDataGenerator()->create_user(); $this->setUser($user); // All set to something. $this->setTimezone('Pacific/Auckland', 'Pacific/Auckland'); $USER->timezone = 'Europe/Prague'; $tz = get_user_timezone(); $this->assertSame('Europe/Prague', $tz); $tz = get_user_timezone(99); $this->assertSame('Europe/Prague', $tz); $tz = get_user_timezone('99'); $this->assertSame('Europe/Prague', $tz); $tz = get_user_timezone('Europe/Berlin'); $this->assertSame('Europe/Berlin', $tz); // User timezone not set. $this->setTimezone('Pacific/Auckland', 'Pacific/Auckland'); $USER->timezone = '99'; $tz = get_user_timezone(); $this->assertSame('Pacific/Auckland', $tz); $tz = get_user_timezone(99); $this->assertSame('Pacific/Auckland', $tz); $tz = get_user_timezone('99'); $this->assertSame('Pacific/Auckland', $tz); $tz = get_user_timezone('Europe/Berlin'); $this->assertSame('Europe/Berlin', $tz); // Server timezone not set. $this->setTimezone('99', 'Pacific/Auckland'); $USER->timezone = 'Europe/Prague'; $tz = get_user_timezone(); $this->assertSame('Europe/Prague', $tz); $tz = get_user_timezone(99); $this->assertSame('Europe/Prague', $tz); $tz = get_user_timezone('99'); $this->assertSame('Europe/Prague', $tz); $tz = get_user_timezone('Europe/Berlin'); $this->assertSame('Europe/Berlin', $tz); // Server and user timezone not set. $this->setTimezone('99', 'Pacific/Auckland'); $USER->timezone = '99'; $tz = get_user_timezone(); $this->assertSame(99.0, $tz); $tz = get_user_timezone(99); $this->assertSame(99.0, $tz); $tz = get_user_timezone('99'); $this->assertSame(99.0, $tz); $tz = get_user_timezone('Europe/Berlin'); $this->assertSame('Europe/Berlin', $tz); } public function test_dst_offset_on() { $time = gmmktime(1, 1, 1, 3, 1, 2015); $this->assertSame(3600, dst_offset_on($time, 'Pacific/Auckland')); $this->assertSame(0, dst_offset_on($time, 'Australia/Perth')); $this->assertSame(1800, dst_offset_on($time, 'Australia/Lord_Howe')); $this->assertSame(0, dst_offset_on($time, 'Europe/Prague')); $this->assertSame(0, dst_offset_on($time, 'America/New_York')); $time = gmmktime(1, 1, 1, 5, 1, 2015); $this->assertSame(0, dst_offset_on($time, 'Pacific/Auckland')); $this->assertSame(0, dst_offset_on($time, 'Australia/Perth')); $this->assertSame(0, dst_offset_on($time, 'Australia/Lord_Howe')); $this->assertSame(3600, dst_offset_on($time, 'Europe/Prague')); $this->assertSame(3600, dst_offset_on($time, 'America/New_York')); } public function test_make_timestamp() { global $CFG; $this->resetAfterTest(); // There are quite a lot of problems, let's pick some less problematic zones for now. $timezones = array('Europe/Prague', 'Europe/London', 'Australia/Perth', 'Pacific/Auckland', 'America/New_York', '99'); $dates = array( array(2, 1, 0, 40, 40), array(4, 3, 0, 30, 22), array(9, 5, 0, 20, 19), array(11, 28, 0, 10, 45), ); $years = array(1999, 2009, 2014, 2018); $this->setTimezone('Pacific/Auckland', 'Pacific/Auckland'); foreach ($timezones as $tz) { foreach ($years as $year) { foreach ($dates as $date) { $result = make_timestamp($year, $date[0], $date[1], $date[2], $date[3], $date[4], $tz, true);
< $expected = new DateTime('now', new DateTimeZone(($tz == 99 ? 'Pacific/Auckland' : $tz)));
> $expected = new \DateTime('now', new \DateTimeZone(($tz == 99 ? 'Pacific/Auckland' : $tz)));
$expected->setDate($year, $date[0], $date[1]); $expected->setTime($date[2], $date[3], $date[4]); $this->assertSame($expected->getTimestamp(), $result, 'Incorrect result for data ' . $expected->format("D, d M Y H:i:s O") . ' ' . $tz); } } } $this->setTimezone('99', 'Pacific/Auckland'); foreach ($timezones as $tz) { foreach ($years as $year) { foreach ($dates as $date) { $result = make_timestamp($year, $date[0], $date[1], $date[2], $date[3], $date[4], $tz, true);
< $expected = new DateTime('now', new DateTimeZone(($tz == 99 ? 'Pacific/Auckland' : $tz)));
> $expected = new \DateTime('now', new \DateTimeZone(($tz == 99 ? 'Pacific/Auckland' : $tz)));
$expected->setDate($year, $date[0], $date[1]); $expected->setTime($date[2], $date[3], $date[4]); $this->assertSame($expected->getTimestamp(), $result, 'Incorrect result for data ' . $expected->format("D, d M Y H:i:s O") . ' ' . $tz); } } } } public function test_usergetdate() { global $CFG; $this->resetAfterTest(); // There are quite a lot of problems, let's pick some less problematic zones for now. $timezones = array('Europe/Prague', 'Europe/London', 'Australia/Perth', 'Pacific/Auckland', 'America/New_York', '99'); $dates = array( array(2, 1, 0, 40, 40), array(4, 3, 0, 30, 22), array(9, 5, 0, 20, 19), array(11, 28, 0, 10, 45), ); $years = array(1999, 2009, 2014, 2018); $this->setTimezone('Pacific/Auckland', 'Pacific/Auckland'); foreach ($timezones as $tz) { foreach ($years as $year) { foreach ($dates as $date) {
< $expected = new DateTime('now', new DateTimeZone(($tz == 99 ? 'Pacific/Auckland' : $tz)));
> $expected = new \DateTime('now', new \DateTimeZone(($tz == 99 ? 'Pacific/Auckland' : $tz)));
$expected->setDate($year, $date[0], $date[1]); $expected->setTime($date[2], $date[3], $date[4]); $result = usergetdate($expected->getTimestamp(), $tz); unset($result[0]); // Extra introduced by getdate(). $ex = array( 'seconds' => $date[4], 'minutes' => $date[3], 'hours' => $date[2], 'mday' => $date[1], 'wday' => (int)$expected->format('w'), 'mon' => $date[0], 'year' => $year, 'yday' => (int)$expected->format('z'), 'weekday' => $expected->format('l'), 'month' => $expected->format('F'), ); $this->assertSame($ex, $result, 'Incorrect result for data ' . $expected->format("D, d M Y H:i:s O") . ' ' . $tz); } } } $this->setTimezone('99', 'Pacific/Auckland'); foreach ($timezones as $tz) { foreach ($years as $year) { foreach ($dates as $date) {
< $expected = new DateTime('now', new DateTimeZone(($tz == 99 ? 'Pacific/Auckland' : $tz)));
> $expected = new \DateTime('now', new \DateTimeZone(($tz == 99 ? 'Pacific/Auckland' : $tz)));
$expected->setDate($year, $date[0], $date[1]); $expected->setTime($date[2], $date[3], $date[4]); $result = usergetdate($expected->getTimestamp(), $tz); unset($result[0]); // Extra introduced by getdate(). $ex = array( 'seconds' => $date[4], 'minutes' => $date[3], 'hours' => $date[2], 'mday' => $date[1], 'wday' => (int)$expected->format('w'), 'mon' => $date[0], 'year' => $year, 'yday' => (int)$expected->format('z'), 'weekday' => $expected->format('l'), 'month' => $expected->format('F'), ); $this->assertSame($ex, $result, 'Incorrect result for data ' . $expected->format("D, d M Y H:i:s O") . ' ' . $tz); } } } } public function test_userdate() { global $CFG; $this->resetAfterTest(); $dates = array( array(2, 1, 0, 40, 40), array(4, 3, 0, 30, 22), array(9, 5, 0, 20, 19), array(11, 28, 0, 10, 45), ); $years = array(1999, 2009, 2014, 2018); $users = array(); $users[] = $this->getDataGenerator()->create_user(array('timezone' => 99)); $users[] = $this->getDataGenerator()->create_user(array('timezone' => 'Europe/Prague')); $users[] = $this->getDataGenerator()->create_user(array('timezone' => 'Pacific/Auckland')); $users[] = $this->getDataGenerator()->create_user(array('timezone' => 'Australia/Perth')); $users[] = $this->getDataGenerator()->create_user(array('timezone' => 'America/New_York')); $format = get_string('strftimedaydatetime', 'langconfig'); $this->setTimezone('Pacific/Auckland', 'Pacific/Auckland'); foreach ($years as $year) { foreach ($dates as $date) {
< $expected = new DateTime('now', new DateTimeZone('UTC'));
> $expected = new \DateTime('now', new \DateTimeZone('UTC'));
$expected->setDate($year, $date[0], $date[1]); $expected->setTime($date[2], $date[3], $date[4]); foreach ($users as $user) { $this->setUser($user);
< $expected->setTimezone(new DateTimeZone(($user->timezone == 99 ? 'Pacific/Auckland' : $user->timezone)));
> $expected->setTimezone(new \DateTimeZone(($user->timezone == 99 ? 'Pacific/Auckland' : $user->timezone)));
$result = userdate($expected->getTimestamp(), '', 99, false, false); date_default_timezone_set($expected->getTimezone()->getName());
< $ex = strftime($format, $expected->getTimestamp());
> $ex = \core_date::strftime($format, $expected->getTimestamp());
date_default_timezone_set($CFG->timezone); $this->assertSame($ex, $result); } } } } public function test_usertime() { // This is a useless bad hack, it needs to be completely eliminated. $time = gmmktime(1, 1, 1, 3, 1, 2015); $this->assertSame($time - (60 * 60 * 1), usertime($time, '1')); $this->assertSame($time - (60 * 60 * -1), usertime($time, '-1')); $this->assertSame($time - (60 * 60 * 1), usertime($time, 'Europe/Prague')); $this->assertSame($time - (60 * 60 * 8), usertime($time, 'Australia/Perth')); $this->assertSame($time - (60 * 60 * 12), usertime($time, 'Pacific/Auckland')); $this->assertSame($time - (60 * 60 * -5), usertime($time, 'America/New_York')); $time = gmmktime(1, 1, 1, 5, 1, 2015); $this->assertSame($time - (60 * 60 * 1), usertime($time, '1')); $this->assertSame($time - (60 * 60 * -1), usertime($time, '-1')); $this->assertSame($time - (60 * 60 * 1), usertime($time, 'Europe/Prague')); $this->assertSame($time - (60 * 60 * 8), usertime($time, 'Australia/Perth')); $this->assertSame($time - (60 * 60 * 12), usertime($time, 'Pacific/Auckland')); $this->assertSame($time - (60 * 60 * -5), usertime($time, 'America/New_York')); } public function test_usertimezone() { global $USER; $this->resetAfterTest(); $this->setTimezone('Pacific/Auckland', 'Pacific/Auckland'); $USER->timezone = 'Europe/Prague'; $this->assertSame('Europe/Prague', usertimezone()); $USER->timezone = '1'; $this->assertSame('UTC+1', usertimezone()); $USER->timezone = '0'; $this->assertSame('UTC', usertimezone()); $USER->timezone = '99'; $this->assertSame('Pacific/Auckland', usertimezone()); $USER->timezone = '99'; $this->assertSame('Europe/Berlin', usertimezone('Europe/Berlin')); $USER->timezone = '99'; $this->assertSame('Pacific/Auckland', usertimezone('99')); $USER->timezone = 'Europe/Prague'; $this->assertSame('Europe/Prague', usertimezone('99')); // When passed an unknown non-whole hour TZ, verify we round to closest // hour. (Possible for legacy reasons when old timezones go away). $USER->timezone = '-9.23'; $this->assertSame('UTC-9', usertimezone('99')); } }