Spade
Mini Shell
| Directory:~$ /home/lmsyaran/public_html/joomla4/ |
| [Home] [System Details] [Kill Me] |
PK���[`#H&G4G4Date.phpnu�[���<?php
/**
* Joomla! Content Management System
*
* @copyright Copyright (C) 2005 - 2020 Open Source Matters, Inc. All
rights reserved.
* @license GNU General Public License version 2 or later; see
LICENSE.txt
*/
namespace Joomla\CMS\Date;
defined('JPATH_PLATFORM') or die;
/**
* JDate is a class that stores a date and provides logic to manipulate
* and render that date in a variety of formats.
*
* @method Date|bool add(\DateInterval $interval) Adds an amount of
days, months, years, hours, minutes and seconds to a JDate object.
* @method Date|bool sub(\DateInterval $interval) Subtracts an amount of
days, months, years, hours, minutes and seconds from a JDate object.
* @method Date|bool modify(string $modify) Alter the timestamp of
this object by incre/decre-menting in a format accepted by strtotime().
*
* @property-read string $daysinmonth t - Number of days in the given
month.
* @property-read string $dayofweek N - ISO-8601 numeric
representation of the day of the week.
* @property-read string $dayofyear z - The day of the year
(starting from 0).
* @property-read boolean $isleapyear L - Whether it's a leap
year.
* @property-read string $day d - Day of the month, 2 digits
with leading zeros.
* @property-read string $hour H - 24-hour format of an hour
with leading zeros.
* @property-read string $minute i - Minutes with leading zeros.
* @property-read string $second s - Seconds with leading zeros.
* @property-read string $microsecond u - Microseconds with leading
zeros.
* @property-read string $month m - Numeric representation of a
month, with leading zeros.
* @property-read string $ordinal S - English ordinal suffix for
the day of the month, 2 characters.
* @property-read string $week W - ISO-8601 week number of
year, weeks starting on Monday.
* @property-read string $year Y - A full numeric
representation of a year, 4 digits.
*
* @since 1.7.0
*/
class Date extends \DateTime
{
const DAY_ABBR = "\x021\x03";
const DAY_NAME = "\x022\x03";
const MONTH_ABBR = "\x023\x03";
const MONTH_NAME = "\x024\x03";
/**
* The format string to be applied when using the __toString() magic
method.
*
* @var string
* @since 1.7.0
*/
public static $format = 'Y-m-d H:i:s';
/**
* Placeholder for a \DateTimeZone object with GMT as the time zone.
*
* @var object
* @since 1.7.0
*/
protected static $gmt;
/**
* Placeholder for a \DateTimeZone object with the default server
* time zone as the time zone.
*
* @var object
* @since 1.7.0
*/
protected static $stz;
/**
* The \DateTimeZone object for usage in rending dates as strings.
*
* @var \DateTimeZone
* @since 3.0.0
*/
protected $tz;
/**
* Constructor.
*
* @param string $date String in a format accepted by strtotime(),
defaults to "now".
* @param mixed $tz Time zone to be used for the date. Might be a
string or a DateTimeZone object.
*
* @since 1.7.0
*/
public function __construct($date = 'now', $tz = null)
{
// Create the base GMT and server time zone objects.
if (empty(self::$gmt) || empty(self::$stz))
{
self::$gmt = new \DateTimeZone('GMT');
self::$stz = new \DateTimeZone(@date_default_timezone_get());
}
// If the time zone object is not set, attempt to build it.
if (!($tz instanceof \DateTimeZone))
{
if ($tz === null)
{
$tz = self::$gmt;
}
elseif (is_string($tz))
{
$tz = new \DateTimeZone($tz);
}
}
// If the date is numeric assume a unix timestamp and convert it.
date_default_timezone_set('UTC');
$date = is_numeric($date) ? date('c', $date) : $date;
// Call the DateTime constructor.
parent::__construct($date, $tz);
// Reset the timezone for 3rd party libraries/extension that does not use
JDate
date_default_timezone_set(self::$stz->getName());
// Set the timezone object for access later.
$this->tz = $tz;
}
/**
* Magic method to access properties of the date given by class to the
format method.
*
* @param string $name The name of the property.
*
* @return mixed A value if the property name is valid, null otherwise.
*
* @since 1.7.0
*/
public function __get($name)
{
$value = null;
switch ($name)
{
case 'daysinmonth':
$value = $this->format('t', true);
break;
case 'dayofweek':
$value = $this->format('N', true);
break;
case 'dayofyear':
$value = $this->format('z', true);
break;
case 'isleapyear':
$value = (boolean) $this->format('L', true);
break;
case 'day':
$value = $this->format('d', true);
break;
case 'hour':
$value = $this->format('H', true);
break;
case 'minute':
$value = $this->format('i', true);
break;
case 'second':
$value = $this->format('s', true);
break;
case 'month':
$value = $this->format('m', true);
break;
case 'ordinal':
$value = $this->format('S', true);
break;
case 'week':
$value = $this->format('W', true);
break;
case 'year':
$value = $this->format('Y', true);
break;
default:
$trace = debug_backtrace();
trigger_error(
'Undefined property via __get(): ' . $name . ' in
' . $trace[0]['file'] . ' on line ' .
$trace[0]['line'],
E_USER_NOTICE
);
}
return $value;
}
/**
* Magic method to render the date object in the format specified in the
public
* static member Date::$format.
*
* @return string The date as a formatted string.
*
* @since 1.7.0
*/
public function __toString()
{
return (string) parent::format(self::$format);
}
/**
* Proxy for new JDate().
*
* @param string $date String in a format accepted by strtotime(),
defaults to "now".
* @param mixed $tz Time zone to be used for the date.
*
* @return Date
*
* @since 1.7.3
*/
public static function getInstance($date = 'now', $tz = null)
{
return new Date($date, $tz);
}
/**
* Translates day of week number to a string.
*
* @param integer $day The numeric day of the week.
* @param boolean $abbr Return the abbreviated day string?
*
* @return string The day of the week.
*
* @since 1.7.0
*/
public function dayToString($day, $abbr = false)
{
switch ($day)
{
case 0:
return $abbr ? \JText::_('SUN') :
\JText::_('SUNDAY');
case 1:
return $abbr ? \JText::_('MON') :
\JText::_('MONDAY');
case 2:
return $abbr ? \JText::_('TUE') :
\JText::_('TUESDAY');
case 3:
return $abbr ? \JText::_('WED') :
\JText::_('WEDNESDAY');
case 4:
return $abbr ? \JText::_('THU') :
\JText::_('THURSDAY');
case 5:
return $abbr ? \JText::_('FRI') :
\JText::_('FRIDAY');
case 6:
return $abbr ? \JText::_('SAT') :
\JText::_('SATURDAY');
}
}
/**
* Gets the date as a formatted string in a local calendar.
*
* @param string $format The date format specification string (see
{@link PHP_MANUAL#date})
* @param boolean $local True to return the date string in the
local time zone, false to return it in GMT.
* @param boolean $translate True to translate localised strings
*
* @return string The date string in the specified format format.
*
* @since 1.7.0
*/
public function calendar($format, $local = false, $translate = true)
{
return $this->format($format, $local, $translate);
}
/**
* Gets the date as a formatted string.
*
* @param string $format The date format specification string (see
{@link PHP_MANUAL#date})
* @param boolean $local True to return the date string in the
local time zone, false to return it in GMT.
* @param boolean $translate True to translate localised strings
*
* @return string The date string in the specified format format.
*
* @since 1.7.0
*/
public function format($format, $local = false, $translate = true)
{
if ($translate)
{
// Do string replacements for date format options that can be
translated.
$format = preg_replace('/(^|[^\\\])D/', "\\1" .
self::DAY_ABBR, $format);
$format = preg_replace('/(^|[^\\\])l/', "\\1" .
self::DAY_NAME, $format);
$format = preg_replace('/(^|[^\\\])M/', "\\1" .
self::MONTH_ABBR, $format);
$format = preg_replace('/(^|[^\\\])F/', "\\1" .
self::MONTH_NAME, $format);
}
// If the returned time should not be local use GMT.
if ($local == false && !empty(self::$gmt))
{
parent::setTimezone(self::$gmt);
}
// Format the date.
$return = parent::format($format);
if ($translate)
{
// Manually modify the month and day strings in the formatted time.
if (strpos($return, self::DAY_ABBR) !== false)
{
$return = str_replace(self::DAY_ABBR,
$this->dayToString(parent::format('w'), true), $return);
}
if (strpos($return, self::DAY_NAME) !== false)
{
$return = str_replace(self::DAY_NAME,
$this->dayToString(parent::format('w')), $return);
}
if (strpos($return, self::MONTH_ABBR) !== false)
{
$return = str_replace(self::MONTH_ABBR,
$this->monthToString(parent::format('n'), true), $return);
}
if (strpos($return, self::MONTH_NAME) !== false)
{
$return = str_replace(self::MONTH_NAME,
$this->monthToString(parent::format('n')), $return);
}
}
if ($local == false && !empty($this->tz))
{
parent::setTimezone($this->tz);
}
return $return;
}
/**
* Get the time offset from GMT in hours or seconds.
*
* @param boolean $hours True to return the value in hours.
*
* @return float The time offset from GMT either in hours or in seconds.
*
* @since 1.7.0
*/
public function getOffsetFromGmt($hours = false)
{
return (float) $hours ? ($this->tz->getOffset($this) / 3600) :
$this->tz->getOffset($this);
}
/**
* Translates month number to a string.
*
* @param integer $month The numeric month of the year.
* @param boolean $abbr If true, return the abbreviated month string
*
* @return string The month of the year.
*
* @since 1.7.0
*/
public function monthToString($month, $abbr = false)
{
switch ($month)
{
case 1:
return $abbr ? \JText::_('JANUARY_SHORT') :
\JText::_('JANUARY');
case 2:
return $abbr ? \JText::_('FEBRUARY_SHORT') :
\JText::_('FEBRUARY');
case 3:
return $abbr ? \JText::_('MARCH_SHORT') :
\JText::_('MARCH');
case 4:
return $abbr ? \JText::_('APRIL_SHORT') :
\JText::_('APRIL');
case 5:
return $abbr ? \JText::_('MAY_SHORT') :
\JText::_('MAY');
case 6:
return $abbr ? \JText::_('JUNE_SHORT') :
\JText::_('JUNE');
case 7:
return $abbr ? \JText::_('JULY_SHORT') :
\JText::_('JULY');
case 8:
return $abbr ? \JText::_('AUGUST_SHORT') :
\JText::_('AUGUST');
case 9:
return $abbr ? \JText::_('SEPTEMBER_SHORT') :
\JText::_('SEPTEMBER');
case 10:
return $abbr ? \JText::_('OCTOBER_SHORT') :
\JText::_('OCTOBER');
case 11:
return $abbr ? \JText::_('NOVEMBER_SHORT') :
\JText::_('NOVEMBER');
case 12:
return $abbr ? \JText::_('DECEMBER_SHORT') :
\JText::_('DECEMBER');
}
}
/**
* Method to wrap the setTimezone() function and set the internal time
zone object.
*
* @param \DateTimeZone $tz The new \DateTimeZone object.
*
* @return Date
*
* @since 1.7.0
* @note This method can't be type hinted due to a PHP bug:
https://bugs.php.net/bug.php?id=61483
*/
public function setTimezone($tz)
{
$this->tz = $tz;
return parent::setTimezone($tz);
}
/**
* Gets the date as an ISO 8601 string. IETF RFC 3339 defines the ISO
8601 format
* and it can be found at the IETF Web site.
*
* @param boolean $local True to return the date string in the local
time zone, false to return it in GMT.
*
* @return string The date string in ISO 8601 format.
*
* @link http://www.ietf.org/rfc/rfc3339.txt
* @since 1.7.0
*/
public function toISO8601($local = false)
{
return $this->format(\DateTime::RFC3339, $local, false);
}
/**
* Gets the date as an SQL datetime string.
*
* @param boolean $local True to return the date string in
the local time zone, false to return it in GMT.
* @param \JDatabaseDriver $db The database driver or null to use
\JFactory::getDbo()
*
* @return string The date string in SQL datetime format.
*
* @link http://dev.mysql.com/doc/refman/5.0/en/datetime.html
* @since 2.5.0
*/
public function toSql($local = false, \JDatabaseDriver $db = null)
{
if ($db === null)
{
$db = \JFactory::getDbo();
}
return $this->format($db->getDateFormat(), $local, false);
}
/**
* Gets the date as an RFC 822 string. IETF RFC 2822 supercedes RFC 822
and its definition
* can be found at the IETF Web site.
*
* @param boolean $local True to return the date string in the local
time zone, false to return it in GMT.
*
* @return string The date string in RFC 822 format.
*
* @link http://www.ietf.org/rfc/rfc2822.txt
* @since 1.7.0
*/
public function toRFC822($local = false)
{
return $this->format(\DateTime::RFC2822, $local, false);
}
/**
* Gets the date as UNIX time stamp.
*
* @return integer The date as a UNIX timestamp.
*
* @since 1.7.0
*/
public function toUnix()
{
return (int) parent::format('U');
}
}
PK���[`#H&G4G4Date.phpnu�[���PKH4