Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.2.x will end 22 April 2024 (12 months).
  • Bug fixes for security issues in 4.2.x will end 7 October 2024 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.1.x is supported too.
<?php

namespace PhpXmlRpc\Helper;

> use PhpXmlRpc\PhpXmlRpc; class Date > { > /** /** > * Helps to convert timestamps to the xml-rpc date format. * Given a timestamp, return the corresponding ISO8601 encoded string. > * * > * Feature creep -- add support for custom TZs * Really, timezones ought to be supported but the XML-RPC spec says: > */
* * "Don't assume a timezone. It should be specified by the server in its documentation what assumptions it makes * about timezones." *
< * These routines always assume localtime unless $utc is set to 1, in which case UTC is assumed and an adjustment < * for locale is made when encoding < * < * @param int $timet (timestamp) < * @param int $utc (0 or 1)
> * This routine always encodes to local time unless $utc is set to 1, in which case UTC output is produced and an > * adjustment for the local timezone's offset is made
*
> * @param int|\DateTimeInterface $timet timestamp or datetime * @return string > * @param bool|int $utc (0 or 1)
*/ public static function iso8601Encode($timet, $utc = 0) {
> if (is_a($timet, 'DateTimeInterface') || is_a($timet, 'DateTime')) { if (!$utc) { > $timet = $timet->getTimestamp(); $t = date('Ymd\TH:i:s', $timet); > }
} else { $t = gmdate('Ymd\TH:i:s', $timet); } return $t; } /**
< * Given an ISO8601 date string, return a timet in the localtime, or UTC.
> * Given an ISO8601 date string, return a timestamp in the localtime, or UTC.
* * @param string $idate
< * @param int $utc either 0 or 1
> * @param bool|int $utc either 0 (assume date is in local time) or 1 (assume date is in UTC)
*
< * @return int (datetime)
> * @return int (timestamp) 0 if the source string does not match the xml-rpc dateTime format
*/ public static function iso8601Decode($idate, $utc = 0) { $t = 0;
< if (preg_match('/([0-9]{4})([0-1][0-9])([0-3][0-9])T([0-2][0-9]):([0-5][0-9]):([0-5][0-9])/', $idate, $regs)) {
> if (preg_match(PhpXmlRpc::$xmlrpc_datetime_format, $idate, $regs)) {
if ($utc) { $t = gmmktime($regs[4], $regs[5], $regs[6], $regs[2], $regs[3], $regs[1]); } else { $t = mktime($regs[4], $regs[5], $regs[6], $regs[2], $regs[3], $regs[1]); } } return $t; } }