⚝
One Hat Cyber Team
⚝
Your IP:
216.73.216.72
Server IP:
41.128.143.86
Server:
Linux host.raqmix.cloud 6.8.0-1025-azure #30~22.04.1-Ubuntu SMP Wed Mar 12 15:28:20 UTC 2025 x86_64
Server Software:
Apache
PHP Version:
8.3.23
Buat File
|
Buat Folder
Eksekusi
Dir :
~
/
usr
/
share
/
psa-pear
/
pear
/
php
/
Horde
/
Edit File: Date.php
<?php /** * Copyright 2004-2017 Horde LLC (http://www.horde.org/) * * See the enclosed file LICENSE for license information (LGPL). If you * did not receive this file, see http://www.horde.org/licenses/lgpl21. * * @author Chuck Hagenbuch <chuck@horde.org> * @author Jan Schneider <jan@horde.org> * @author Michael J Rubinsky <mrubinsk@horde.org> * @category Horde * @license http://www.horde.org/licenses/lgpl21 LGPL * @package Date * @todo in format(): * http://php.net/intldateformatter * @todo on timezones: * http://trac.agavi.org/ticket/1008 * http://trac.agavi.org/changeset/3659 * @todo on switching to PHP::DateTime: * The only thing ever stored in the database *IS* Unix timestamps. Doing * anything other than that is unmanageable, yet some frameworks use 'server * based' times in their systems, simply because they do not bother with * daylight saving and only 'serve' one timezone! * * The second you have to manage 'real' time across timezones then daylight * saving becomes essential, BUT only on the display side! Since the browser * only provides a time offset, this is useless and to be honest should simply * be ignored ( until it is upgraded to provide the correct information ;) * ). So we need a 'display' function that takes a simple numeric epoch, and a * separate timezone id into which the epoch is to be 'converted'. My W3C * mapping works simply because ADOdb then converts that to it's own simple * offset abbreviation - in my case GMT or BST. As long as DateTime passes the * full 64 bit number the date range from 100AD is also preserved ( and * further back if 2 digit years are disabled ). If I want to display the * 'real' timezone with this 'time' then I just add it in place of ADOdb's * 'timezone'. I am tempted to simply adjust the ADOdb class to take a * timezone in place of the simple GMT switch it currently uses. * * The return path is just the reverse and simply needs to take the client * display offset off prior to storage of the UTC epoch. SO we use * DateTimeZone to get an offset value for the clients timezone and simply add * or subtract this from a timezone agnostic display on the client end when * entering new times. * * * It's not really feasible to store dates in specific timezone, as most * national/local timezones support DST - and that is a pain to support, as * eg. sorting breaks when some timestamps get repeated. That's why it's * usually better to store datetimes as either UTC datetime or plain unix * timestamp. I usually go with the former - using database datetime type. */ /** * Horde Date wrapper/logic class, including some calculation functions. * * @author Chuck Hagenbuch <chuck@horde.org> * @author Jan Schneider <jan@horde.org> * @author Michael J Rubinsky <mrubinsk@horde.org> * @category Horde * @copyright 2004-2017 Horde LLC * @license http://www.horde.org/licenses/lgpl21 LGPL * @package Date */ class Horde_Date { const DATE_SUNDAY = 0; const DATE_MONDAY = 1; const DATE_TUESDAY = 2; const DATE_WEDNESDAY = 3; const DATE_THURSDAY = 4; const DATE_FRIDAY = 5; const DATE_SATURDAY = 6; const MASK_SUNDAY = 1; const MASK_MONDAY = 2; const MASK_TUESDAY = 4; const MASK_WEDNESDAY = 8; const MASK_THURSDAY = 16; const MASK_FRIDAY = 32; const MASK_SATURDAY = 64; const MASK_WEEKDAYS = 62; const MASK_WEEKEND = 65; const MASK_ALLDAYS = 127; const MASK_SECOND = 1; const MASK_MINUTE = 2; const MASK_HOUR = 4; const MASK_DAY = 8; const MASK_MONTH = 16; const MASK_YEAR = 32; const MASK_ALLPARTS = 63; const DATE_DEFAULT = 'Y-m-d H:i:s'; const DATE_JSON = 'Y-m-d\TH:i:s'; /** * Year * * @var integer */ protected $_year; /** * Month * * @var integer */ protected $_month; /** * Day * * @var integer */ protected $_mday; /** * Hour * * @var integer */ protected $_hour = 0; /** * Minute * * @var integer */ protected $_min = 0; /** * Second * * @var integer */ protected $_sec = 0; /** * String representation of the date's timezone. * * @var string */ protected $_timezone; /** * These aliases map Windows, Lotus, and other Timezone IDs to those * understood by PHP. * * @todo This list better moves somewhere else * @var array */ protected static $_timezoneAliases = array( 'Dateline Standard Time' => 'Etc/GMT+12', 'UTC-11' => 'Etc/GMT+11', 'Hawaiian Standard Time' => 'Pacific/Honolulu', 'Alaskan Standard Time' => 'America/Anchorage', 'Pacific Standard Time (Mexico)' => 'America/Santa_Isabel', 'Pacific Standard Time' => 'America/Los_Angeles', 'US Mountain Standard Time' => 'America/Phoenix', 'Mountain Standard Time (Mexico)' => 'America/Chihuahua', 'Mountain Standard Time' => 'America/Denver', 'Central America Standard Time' => 'America/Guatemala', 'Central Standard Time' => 'America/Chicago', 'Central Standard Time (Mexico)' => 'America/Mexico_City', 'Canada Central Standard Time' => 'America/Regina', 'SA Pacific Standard Time' => 'America/Bogota', 'Eastern Standard Time' => 'America/New_York', 'US Eastern Standard Time' => 'America/Indianapolis', 'Venezuela Standard Time' => 'America/Caracas', 'Paraguay Standard Time' => 'America/Asuncion', 'Atlantic Standard Time' => 'America/Halifax', 'Central Brazilian Standard Time' => 'America/Cuiaba', 'SA Western Standard Time' => 'America/La_Paz', 'Pacific SA Standard Time' => 'America/Santiago', 'Newfoundland Standard Time' => 'America/St_Johns', 'E. South America Standard Time' => 'America/Sao_Paulo', 'Argentina Standard Time' => 'America/Buenos_Aires', 'SA Eastern Standard Time' => 'America/Cayenne', 'Greenland Standard Time' => 'America/Godthab', 'Montevideo Standard Time' => 'America/Montevideo', 'Bahia Standard Time' => 'America/Bahia', 'UTC-02' => 'Etc/GMT+2', 'Azores Standard Time' => 'Atlantic/Azores', 'Cape Verde Standard Time' => 'Atlantic/Cape_Verde', 'Morocco Standard Time' => 'Africa/Casablanca', 'GMT Standard Time' => 'Europe/London', 'Greenwich Standard Time' => 'Atlantic/Reykjavik', 'W. Europe Standard Time' => 'Europe/Berlin', 'Central Europe Standard Time' => 'Europe/Budapest', 'Romance Standard Time' => 'Europe/Paris', 'Central European Standard Time' => 'Europe/Warsaw', 'W. Central Africa Standard Time' => 'Africa/Lagos', 'Namibia Standard Time' => 'Africa/Windhoek', 'Jordan Standard Time' => 'Asia/Amman', 'GTB Standard Time' => 'Europe/Bucharest', 'Middle East Standard Time' => 'Asia/Beirut', 'Egypt Standard Time' => 'Africa/Cairo', 'Syria Standard Time' => 'Asia/Damascus', 'E. Europe Standard Time' => 'Asia/Nicosia', 'South Africa Standard Time' => 'Africa/Johannesburg', 'FLE Standard Time' => 'Europe/Kiev', 'Turkey Standard Time' => 'Europe/Istanbul', 'Israel Standard Time' => 'Asia/Jerusalem', 'Arabic Standard Time' => 'Asia/Baghdad', 'Kaliningrad Standard Time' => 'Europe/Kaliningrad', 'Arab Standard Time' => 'Asia/Riyadh', 'E. Africa Standard Time' => 'Africa/Nairobi', 'Iran Standard Time' => 'Asia/Tehran', 'Arabian Standard Time' => 'Asia/Dubai', 'Azerbaijan Standard Time' => 'Asia/Baku', 'Russian Standard Time' => 'Europe/Moscow', 'Mauritius Standard Time' => 'Indian/Mauritius', 'Georgian Standard Time' => 'Asia/Tbilisi', 'Caucasus Standard Time' => 'Asia/Yerevan', 'Afghanistan Standard Time' => 'Asia/Kabul', 'Pakistan Standard Time' => 'Asia/Karachi', 'West Asia Standard Time' => 'Asia/Tashkent', 'India Standard Time' => 'Asia/Calcutta', 'Sri Lanka Standard Time' => 'Asia/Colombo', 'Nepal Standard Time' => 'Asia/Katmandu', 'Central Asia Standard Time' => 'Asia/Almaty', 'Bangladesh Standard Time' => 'Asia/Dhaka', 'Ekaterinburg Standard Time' => 'Asia/Yekaterinburg', 'Myanmar Standard Time' => 'Asia/Rangoon', 'SE Asia Standard Time' => 'Asia/Bangkok', 'N. Central Asia Standard Time' => 'Asia/Novosibirsk', 'China Standard Time' => 'Asia/Shanghai', 'North Asia Standard Time' => 'Asia/Krasnoyarsk', 'Singapore Standard Time' => 'Asia/Singapore', 'W. Australia Standard Time' => 'Australia/Perth', 'Taipei Standard Time' => 'Asia/Taipei', 'Ulaanbaatar Standard Time' => 'Asia/Ulaanbaatar', 'North Asia East Standard Time' => 'Asia/Irkutsk', 'Tokyo Standard Time' => 'Asia/Tokyo', 'Korea Standard Time' => 'Asia/Seoul', 'Cen. Australia Standard Time' => 'Australia/Adelaide', 'AUS Central Standard Time' => 'Australia/Darwin', 'E. Australia Standard Time' => 'Australia/Brisbane', 'AUS Eastern Standard Time' => 'Australia/Sydney', 'West Pacific Standard Time' => 'Pacific/Port_Moresby', 'Tasmania Standard Time' => 'Australia/Hobart', 'Yakutsk Standard Time' => 'Asia/Yakutsk', 'Central Pacific Standard Time' => 'Pacific/Guadalcanal', 'Vladivostok Standard Time' => 'Asia/Vladivostok', 'New Zealand Standard Time' => 'Pacific/Auckland', 'UTC+12' => 'Etc/GMT-12', 'Fiji Standard Time' => 'Pacific/Fiji', 'Magadan Standard Time' => 'Asia/Magadan', 'Tonga Standard Time' => 'Pacific/Tongatapu', 'Samoa Standard Time' => 'Pacific/Apia', // Found from Lotus Notes 'W. Europe' => 'Europe/Berlin', 'E. Europe' => 'Asia/Nicosia', // Old Olsen names, from the "backward" file. 'Africa/Asmera' => 'Africa/Nairobi', 'Africa/Timbuktu' => 'Africa/Abidjan', 'America/Argentina/ComodRivadavia' => 'America/Argentina/Catamarca', 'America/Atka' => 'America/Adak', 'America/Buenos_Aires' => 'America/Argentina/Buenos_Aires', 'America/Catamarca' => 'America/Argentina/Catamarca', 'America/Coral_Harbour' => 'America/Atikokan', 'America/Cordoba' => 'America/Argentina/Cordoba', 'America/Ensenada' => 'America/Tijuana', 'America/Fort_Wayne' => 'America/Indiana/Indianapolis', 'America/Indianapolis' => 'America/Indiana/Indianapolis', 'America/Jujuy' => 'America/Argentina/Jujuy', 'America/Knox_IN' => 'America/Indiana/Knox', 'America/Louisville' => 'America/Kentucky/Louisville', 'America/Mendoza' => 'America/Argentina/Mendoza', 'America/Montreal' => 'America/Toronto', 'America/Porto_Acre' => 'America/Rio_Branco', 'America/Rosario' => 'America/Argentina/Cordoba', 'America/Santa_Isabel' => 'America/Tijuana', 'America/Shiprock' => 'America/Denver', 'America/Virgin' => 'America/Port_of_Spain', 'Antarctica/South_Pole' => 'Pacific/Auckland', 'Asia/Ashkhabad' => 'Asia/Ashgabat', 'Asia/Calcutta' => 'Asia/Kolkata', 'Asia/Chongqing' => 'Asia/Shanghai', 'Asia/Chungking' => 'Asia/Shanghai', 'Asia/Dacca' => 'Asia/Dhaka', 'Asia/Harbin' => 'Asia/Shanghai', 'Asia/Kashgar' => 'Asia/Urumqi', 'Asia/Katmandu' => 'Asia/Kathmandu', 'Asia/Macao' => 'Asia/Macau', 'Asia/Saigon' => 'Asia/Ho_Chi_Minh', 'Asia/Tel_Aviv' => 'Asia/Jerusalem', 'Asia/Thimbu' => 'Asia/Thimphu', 'Asia/Ujung_Pandang' => 'Asia/Makassar', 'Asia/Ulan_Bator' => 'Asia/Ulaanbaatar', 'Atlantic/Faeroe' => 'Atlantic/Faroe', 'Atlantic/Jan_Mayen' => 'Europe/Oslo', 'Australia/ACT' => 'Australia/Sydney', 'Australia/Canberra' => 'Australia/Sydney', 'Australia/LHI' => 'Australia/Lord_Howe', 'Australia/NSW' => 'Australia/Sydney', 'Australia/North' => 'Australia/Darwin', 'Australia/Queensland' => 'Australia/Brisbane', 'Australia/South' => 'Australia/Adelaide', 'Australia/Tasmania' => 'Australia/Hobart', 'Australia/Victoria' => 'Australia/Melbourne', 'Australia/West' => 'Australia/Perth', 'Australia/Yancowinna' => 'Australia/Broken_Hill', 'Brazil/Acre' => 'America/Rio_Branco', 'Brazil/DeNoronha' => 'America/Noronha', 'Brazil/East' => 'America/Sao_Paulo', 'Brazil/West' => 'America/Manaus', 'Canada/Atlantic' => 'America/Halifax', 'Canada/Central' => 'America/Winnipeg', 'Canada/East-Saskatchewan' => 'America/Regina', 'Canada/Eastern' => 'America/Toronto', 'Canada/Mountain' => 'America/Edmonton', 'Canada/Newfoundland' => 'America/St_Johns', 'Canada/Pacific' => 'America/Vancouver', 'Canada/Saskatchewan' => 'America/Regina', 'Canada/Yukon' => 'America/Whitehorse', 'Chile/Continental' => 'America/Santiago', 'Chile/EasterIsland' => 'Pacific/Easter', 'Cuba' => 'America/Havana', 'Egypt' => 'Africa/Cairo', 'Eire' => 'Europe/Dublin', 'Europe/Belfast' => 'Europe/London', 'Europe/Tiraspol' => 'Europe/Chisinau', 'GB' => 'Europe/London', 'GB-Eire' => 'Europe/London', 'GMT+0' => 'Etc/GMT', 'GMT-0' => 'Etc/GMT', 'GMT0' => 'Etc/GMT', 'Greenwich' => 'Etc/GMT', 'Hongkong' => 'Asia/Hong_Kong', 'Iceland' => 'Atlantic/Reykjavik', 'Iran' => 'Asia/Tehran', 'Israel' => 'Asia/Jerusalem', 'Jamaica' => 'America/Jamaica', 'Japan' => 'Asia/Tokyo', 'Kwajalein' => 'Pacific/Kwajalein', 'Libya' => 'Africa/Tripoli', 'Mexico/BajaNorte' => 'America/Tijuana', 'Mexico/BajaSur' => 'America/Mazatlan', 'Mexico/General' => 'America/Mexico_City', 'NZ' => 'Pacific/Auckland', 'NZ-CHAT' => 'Pacific/Chatham', 'Navajo' => 'America/Denver', 'PRC' => 'Asia/Shanghai', 'Pacific/Ponape' => 'Pacific/Pohnpei', 'Pacific/Samoa' => 'Pacific/Pago_Pago', 'Pacific/Truk' => 'Pacific/Chuuk', 'Pacific/Yap' => 'Pacific/Chuuk', 'Poland' => 'Europe/Warsaw', 'Portugal' => 'Europe/Lisbon', 'ROC' => 'Asia/Taipei', 'ROK' => 'Asia/Seoul', 'Singapore' => 'Asia/Singapore', 'Turkey' => 'Europe/Istanbul', 'UCT' => 'Etc/UCT', 'US/Alaska' => 'America/Anchorage', 'US/Aleutian' => 'America/Adak', 'US/Arizona' => 'America/Phoenix', 'US/Central' => 'America/Chicago', 'US/East-Indiana' => 'America/Indiana/Indianapolis', 'US/Eastern' => 'America/New_York', 'US/Hawaii' => 'Pacific/Honolulu', 'US/Indiana-Starke' => 'America/Indiana/Knox', 'US/Michigan' => 'America/Detroit', 'US/Mountain' => 'America/Denver', 'US/Pacific' => 'America/Los_Angeles', 'US/Samoa' => 'Pacific/Pago_Pago', 'UTC' => 'UTC', 'Universal' => 'UTC', 'W-SU' => 'Europe/Moscow', 'Zulu' => 'UTC', ); /** * These aliases map timezone abbreviations to those understood by PHP. * * @todo This list better moves somewhere else * @see getTimezoneAlias() * @var array */ protected static $_timezoneAbbreviations = array(); /** * A list of (Olson) timezone identifiers understood by PHP. * * @todo This list better moves somewhere else * @see getTimezoneAlias() * @var array */ protected static $_timezoneIdentifiers = array(); /** * Default format for __toString() * * @var string */ protected $_defaultFormat = self::DATE_DEFAULT; /** * Default specs that are always supported. * @var string */ protected static $_defaultSpecs = '-%CdDeHImMnRStTyY'; /** * Internally supported strftime() specifiers. * @var string */ protected static $_supportedSpecs = ''; /** * Map of required correction masks. * * @see __set() * * @var array */ protected static $_corrections = array( 'year' => self::MASK_YEAR, 'month' => self::MASK_MONTH, 'mday' => self::MASK_DAY, 'hour' => self::MASK_HOUR, 'min' => self::MASK_MINUTE, 'sec' => self::MASK_SECOND, ); protected $_formatCache = array(); /** * Builds a new date object. If $date contains date parts, use them to * initialize the object. * * Recognized formats: * - arrays with keys 'year', 'month', 'mday', 'day' * 'hour', 'min', 'minute', 'sec' * - objects with properties 'year', 'month', 'mday', 'hour', 'min', 'sec' * - yyyy-mm-dd hh:mm:ss * - yyyymmddhhmmss * - yyyymmddThhmmssZ * - yyyymmdd (might conflict with unix timestamps between 31 Oct 1966 and * 03 Mar 1973) * - unix timestamps * - anything parsed by strtotime()/DateTime. * * @throws Horde_Date_Exception */ public function __construct($date = null, $timezone = null) { if (!self::$_supportedSpecs) { self::$_supportedSpecs = self::$_defaultSpecs; if (function_exists('nl_langinfo')) { self::$_supportedSpecs .= 'bBpxX'; } } if (func_num_args() > 2) { // Handle args in order: year month day hour min sec tz $this->_initializeFromArgs(func_get_args()); return; } $this->_initializeTimezone($timezone); if (is_null($date)) { return; } if (is_string($date)) { $date = trim($date, '"'); } if (is_object($date)) { $this->_initializeFromObject($date); } elseif (is_array($date)) { $this->_initializeFromArray($date); } elseif (preg_match('/^(\d{4})-?(\d{2})-?(\d{2})T? ?(\d{2}):?(\d{2}):?(\d{2})(?:\.\d+)?(Z?)$/', $date, $parts)) { $this->_year = (int)$parts[1]; $this->_month = (int)$parts[2]; $this->_mday = (int)$parts[3]; $this->_hour = (int)$parts[4]; $this->_min = (int)$parts[5]; $this->_sec = (int)$parts[6]; if ($parts[7]) { $this->_initializeTimezone('UTC'); } } elseif (preg_match('/^(\d{4})-?(\d{2})-?(\d{2})$/', $date, $parts) && $parts[2] > 0 && $parts[2] <= 12 && $parts[3] > 0 && $parts[3] <= 31) { $this->_year = (int)$parts[1]; $this->_month = (int)$parts[2]; $this->_mday = (int)$parts[3]; $this->_hour = $this->_min = $this->_sec = 0; } elseif ((string)(int)$date == $date) { // Try as a timestamp. if ($this->_timezone) { $oldtimezone = date_default_timezone_get(); date_default_timezone_set($this->_timezone); } $parts = @getdate($date); if ($parts) { $this->_year = $parts['year']; $this->_month = $parts['mon']; $this->_mday = $parts['mday']; $this->_hour = $parts['hours']; $this->_min = $parts['minutes']; $this->_sec = $parts['seconds']; } if ($this->_timezone) { date_default_timezone_set($oldtimezone); } } else { if (!empty($timezone)) { try { $parsed = new DateTime($date, new DateTimeZone($timezone)); } catch (Exception $e) { throw new Horde_Date_Exception(sprintf(Horde_Date_Translation::t("Failed to parse time string (%s)"), $date)); } } else { try { $parsed = new DateTime($date); } catch (Exception $e) { throw new Horde_Date_Exception(sprintf(Horde_Date_Translation::t("Failed to parse time string (%s)"), $date)); } $parsed->setTimezone(new DateTimeZone(date_default_timezone_get())); $this->_initializeTimezone(date_default_timezone_get()); } $this->_year = (int)$parsed->format('Y'); $this->_month = (int)$parsed->format('m'); $this->_mday = (int)$parsed->format('d'); $this->_hour = (int)$parsed->format('H'); $this->_min = (int)$parsed->format('i'); $this->_sec = (int)$parsed->format('s'); } } /** * Returns a simple string representation of the date object * * @return string This object converted to a string. */ public function __toString() { try { return $this->format($this->_defaultFormat); } catch (Exception $e) { return ''; } } /** * Returns a DateTime object representing this object. * * @return DateTime */ public function toDateTime() { try { $date = new DateTime(null, new DateTimeZone($this->_timezone)); $date->setDate($this->_year, $this->_month, $this->_mday); $date->setTime($this->_hour, $this->_min, $this->_sec); } catch (Exception $e) { throw new Horde_Date_Exception($e); } return $date; } /** * Converts a date in the proleptic Gregorian calendar to the no of days * since 24th November, 4714 B.C. * * Returns the no of days since Monday, 24th November, 4714 B.C. in the * proleptic Gregorian calendar (which is 24th November, -4713 using * 'Astronomical' year numbering, and 1st January, 4713 B.C. in the * proleptic Julian calendar). This is also the first day of the 'Julian * Period' proposed by Joseph Scaliger in 1583, and the number of days * since this date is known as the 'Julian Day'. (It is not directly * to do with the Julian calendar, although this is where the name * is derived from.) * * The algorithm is valid for all years (positive and negative), and * also for years preceding 4714 B.C. * * Algorithm is from PEAR::Date_Calc * * @author Monte Ohrt <monte@ispi.net> * @author Pierre-Alain Joye <pajoye@php.net> * @author Daniel Convissor <danielc@php.net> * @author C.A. Woodcock <c01234@netcomuk.co.uk> * * @return integer The number of days since 24th November, 4714 B.C. */ public function toDays() { if (function_exists('GregorianToJD')) { return gregoriantojd($this->_month, $this->_mday, $this->_year); } $day = $this->_mday; $month = $this->_month; $year = $this->_year; if ($month > 2) { // March = 0, April = 1, ..., December = 9, // January = 10, February = 11 $month -= 3; } else { $month += 9; --$year; } $hb_negativeyear = $year < 0; $century = intval($year / 100); $year = $year % 100; if ($hb_negativeyear) { // Subtract 1 because year 0 is a leap year; // And N.B. that we must treat the leap years as occurring // one year earlier than they do, because for the purposes // of calculation, the year starts on 1st March: // return intval((14609700 * $century + ($year == 0 ? 1 : 0)) / 400) + intval((1461 * $year + 1) / 4) + intval((153 * $month + 2) / 5) + $day + 1721118; } else { return intval(146097 * $century / 4) + intval(1461 * $year / 4) + intval((153 * $month + 2) / 5) + $day + 1721119; } } /** * Converts number of days since 24th November, 4714 B.C. (in the proleptic * Gregorian calendar, which is year -4713 using 'Astronomical' year * numbering) to Gregorian calendar date. * * Returned date belongs to the proleptic Gregorian calendar, using * 'Astronomical' year numbering. * * The algorithm is valid for all years (positive and negative), and * also for years preceding 4714 B.C. (i.e. for negative 'Julian Days'), * and so the only limitation is platform-dependent (for 32-bit systems * the maximum year would be something like about 1,465,190 A.D.). * * N.B. Monday, 24th November, 4714 B.C. is Julian Day '0'. * * Algorithm is from PEAR::Date_Calc * * @author Monte Ohrt <monte@ispi.net> * @author Pierre-Alain Joye <pajoye@php.net> * @author Daniel Convissor <danielc@php.net> * @author C.A. Woodcock <c01234@netcomuk.co.uk> * * @param int $days the number of days since 24th November, 4714 B.C. * @param string $format the string indicating how to format the output * * @return Horde_Date A Horde_Date object representing the date. */ public static function fromDays($days) { if (function_exists('jdtogregorian')) { list($month, $day, $year) = explode('/', jdtogregorian($days)); } else { $days = intval($days); $days -= 1721119; $century = floor((4 * $days - 1) / 146097); $days = floor(4 * $days - 1 - 146097 * $century); $day = floor($days / 4); $year = floor((4 * $day + 3) / 1461); $day = floor(4 * $day + 3 - 1461 * $year); $day = floor(($day + 4) / 4); $month = floor((5 * $day - 3) / 153); $day = floor(5 * $day - 3 - 153 * $month); $day = floor(($day + 5) / 5); $year = $century * 100 + $year; if ($month < 10) { $month +=3; } else { $month -=9; ++$year; } } return new Horde_Date($year, $month, $day); } /** * Getter for the date and time properties. * * @param string $name One of 'year', 'month', 'mday', 'hour', 'min', * 'sec' or 'timezone' (since Horde_Date 2.0.0). * * @return integer|string The property value, or null if not set. */ public function __get($name) { if ($name == 'day') { $name = 'mday'; } if ($name[0] == '_') { return null; } return $this->{'_' . $name}; } /** * Setter for the date and time properties. * * @param string $name One of 'year', 'month', 'mday', 'hour', * 'min', 'sec' or 'timezone' (since * Horde_Date 2.0.0). * @param integer|string $value The property value. */ public function __set($name, $value) { if ($name == 'timezone') { $this->_initializeTimezone($value); return; } if ($name == 'day') { $name = 'mday'; } if ($name != 'year' && $name != 'month' && $name != 'mday' && $name != 'hour' && $name != 'min' && $name != 'sec') { throw new InvalidArgumentException('Undefined property ' . $name); } $down = $value < $this->{'_' . $name}; $this->{'_' . $name} = $value; $this->_correct(self::$_corrections[$name], $down); $this->_formatCache = array(); } /** * Returns whether a date or time property exists. * * @param string $name One of 'year', 'month', 'mday', 'hour', 'min' or * 'sec'. * * @return boolen True if the property exists and is set. */ public function __isset($name) { if ($name == 'day') { $name = 'mday'; } return ($name == 'year' || $name == 'month' || $name == 'mday' || $name == 'hour' || $name == 'min' || $name == 'sec') && isset($this->{'_' . $name}); } /** * Adds a number of seconds or units to this date, returning a new Date * object. */ public function add($factor) { $d = clone($this); if (is_array($factor) || is_object($factor)) { foreach ($factor as $property => $value) { $d->$property += $value; } } else { $d->sec += $factor; } return $d; } /** * Subtracts a number of seconds or units from this date, returning a new * Horde_Date object. */ public function sub($factor) { if (is_array($factor)) { foreach ($factor as &$value) { $value *= -1; } } else { $factor *= -1; } return $this->add($factor); } /** * Returns the normalized (Olson) timezone name of a timezone alias. * * We currently support Windows and Lotus timezone names, and timezone * abbreviations. * * @since Horde_Date 2.3.0 * * @param string $timezone Some timezone alias. * * @return string The Olson timezone name, or the original value, if no * alias found. */ public static function getTimezoneAlias($timezone) { if (empty(self::$_timezoneIdentifiers)) { self::$_timezoneIdentifiers = array_flip(DateTimeZone::listIdentifiers()); } if (isset(self::$_timezoneIdentifiers[$timezone])) { return $timezone; } /* Workaround for standard cases of bug #11688 */ if (isset(self::$_timezoneAliases[$timezone])) { $timezone = self::$_timezoneAliases[$timezone]; } if (empty(self::$_timezoneAbbreviations)) { self::$_timezoneAbbreviations = DateTimeZone::listAbbreviations(); } $lower = Horde_String::lower($timezone); if (isset(self::$_timezoneAbbreviations[$lower])) { $timezone = reset(self::$_timezoneAbbreviations[$lower]); $timezone = $timezone['timezone_id']; } return $timezone; } /** * Converts this object to a different timezone. * * @param string $timezone The new timezone. * * @return Horde_Date This object. * @throws Horde_Date_Exception */ public function setTimezone($timezone) { $date = $this->toDateTime(); $timezone = self::getTimezoneAlias($timezone); try { $date->setTimezone(new DateTimeZone($timezone)); } catch (Exception $e) { throw new Horde_Date_Exception($e->getMessage()); } $this->_timezone = $timezone; $this->_year = (int)$date->format('Y'); $this->_month = (int)$date->format('m'); $this->_mday = (int)$date->format('d'); $this->_hour = (int)$date->format('H'); $this->_min = (int)$date->format('i'); $this->_sec = (int)$date->format('s'); $this->_formatCache = array(); return $this; } /** * Sets the default date format used in __toString() * * @param string $format */ public function setDefaultFormat($format) { $this->_defaultFormat = $format; } /** * Returns the day of the week (0 = Sunday, 6 = Saturday) of this date. * * @return integer The day of the week. */ public function dayOfWeek() { if ($this->_month > 2) { $month = $this->_month - 2; $year = $this->_year; } else { $month = $this->_month + 10; $year = $this->_year - 1; } $day = (floor((13 * $month - 1) / 5) + $this->_mday + ($year % 100) + floor(($year % 100) / 4) + floor(($year / 100) / 4) - 2 * floor($year / 100) + 77); return (int)($day - 7 * floor($day / 7)); } /** * Returns the day number of the year (1 to 365/366). * * @return integer The day of the year. */ public function dayOfYear() { return $this->format('z') + 1; } /** * Returns the week of the month. * * @return integer The week number. */ public function weekOfMonth() { return ceil($this->_mday / 7); } /** * Returns the week of the year, first Monday is first day of first week. * * @return integer The week number. */ public function weekOfYear() { return $this->format('W'); } /** * Returns the number of weeks in the given year (52 or 53). * * @param integer $year The year to count the number of weeks in. * * @return integer $numWeeks The number of weeks in $year. */ public static function weeksInYear($year) { // Find the last Thursday of the year. $date = new Horde_Date($year . '-12-31'); while ($date->dayOfWeek() != self::DATE_THURSDAY) { --$date->mday; } return $date->weekOfYear(); } /** * Sets the date of this object to the $nth weekday of $weekday. * * @param integer $weekday The day of the week (0 = Sunday, etc). * @param integer $nth The $nth $weekday to set to (defaults to 1). * Negative values count from end of the month * (@since Horde_Date 2.1.0). */ public function setNthWeekday($weekday, $nth = 1) { if ($weekday < self::DATE_SUNDAY || $weekday > self::DATE_SATURDAY) { return; } if ($nth >= 0) { $this->_mday = 1; $first = $this->dayOfWeek(); $this->_mday = $weekday - $first + 1; if ($weekday < $first) { $this->_mday += 7; } $diff = 7 * $nth - 7; $this->_mday += $diff; $this->_correct(self::MASK_DAY, false); } else { $this->_mday = Horde_Date_Utils::daysInMonth($this->_month, $this->_year); $last = $this->dayOfWeek(); $this->_mday -= $last - $weekday; if ($last < $weekday) { $this->_mday -= 7; } $diff = -7 * $nth - 7; $this->_mday -= $diff; $this->_correct(self::MASK_DAY, true); $this->_formatCache = array(); } } /** * Is the date currently represented by this object a valid date? * * @return boolean Validity, counting leap years, etc. */ public function isValid() { return ($this->_year >= 0 && $this->_year <= 9999); } /** * Compares this date to another date object to see which one is * greater (later). Assumes that the dates are in the same * timezone. * * @param mixed $other The date to compare to. * * @return integer == 0 if they are on the same date * >= 1 if $this is greater (later) * <= -1 if $other is greater (later) */ public function compareDate($other) { if (!($other instanceof Horde_Date)) { $other = new Horde_Date($other); } if ($this->_year != $other->year) { return $this->_year - $other->year; } if ($this->_month != $other->month) { return $this->_month - $other->month; } return $this->_mday - $other->mday; } /** * Returns whether this date is after the other. * * @param mixed $other The date to compare to. * * @return boolean True if this date is after the other. */ public function after($other) { return $this->compareDate($other) > 0; } /** * Returns whether this date is before the other. * * @param mixed $other The date to compare to. * * @return boolean True if this date is before the other. */ public function before($other) { return $this->compareDate($other) < 0; } /** * Returns whether this date is the same like the other. * * @param mixed $other The date to compare to. * * @return boolean True if this date is the same like the other. */ public function equals($other) { return $this->compareDate($other) == 0; } /** * Compares this to another date object by time, to see which one * is greater (later). Assumes that the dates are in the same * timezone. * * @param mixed $other The date to compare to. * * @return integer == 0 if they are at the same time * >= 1 if $this is greater (later) * <= -1 if $other is greater (later) */ public function compareTime($other) { if (!($other instanceof Horde_Date)) { $other = new Horde_Date($other); } if ($this->_hour != $other->hour) { return $this->_hour - $other->hour; } if ($this->_min != $other->min) { return $this->_min - $other->min; } return $this->_sec - $other->sec; } /** * Compares this to another date object, including times, to see * which one is greater (later). Assumes that the dates are in the * same timezone. * * @param mixed $other The date to compare to. * * @return integer == 0 if they are equal * >= 1 if $this is greater (later) * <= -1 if $other is greater (later) */ public function compareDateTime($other) { if (!($other instanceof Horde_Date)) { $other = new Horde_Date($other); } if ($diff = $this->compareDate($other)) { return $diff; } return $this->compareTime($other); } /** * Returns number of days between this date and another. * * @param Horde_Date $other The other day to diff with. * * @return integer The absolute number of days between the two dates. */ public function diff($other) { return abs($this->toDays() - $other->toDays()); } /** * Returns the time offset for local time zone. * * @param boolean $colon Place a colon between hours and minutes? * * @return string Timezone offset as a string in the format +HH:MM. */ public function tzOffset($colon = true) { return $colon ? $this->format('P') : $this->format('O'); } /** * Returns the unix timestamp representation of this date. * * @return integer A unix timestamp. */ public function timestamp() { if ($this->_year >= 1970 && $this->_year < 2038) { return mktime($this->_hour, $this->_min, $this->_sec, $this->_month, $this->_mday, $this->_year); } return $this->format('U'); } /** * Returns the unix timestamp representation of this date, 12:00am. * * @return integer A unix timestamp. */ public function datestamp() { if ($this->_year >= 1970 && $this->_year < 2038) { return mktime(0, 0, 0, $this->_month, $this->_mday, $this->_year); } $date = new DateTime($this->format('Y-m-d')); return $date->format('U'); } /** * Formats date and time to be passed around as a short url parameter. * * @return string Date and time. */ public function dateString() { return sprintf('%04d%02d%02d', $this->_year, $this->_month, $this->_mday); } /** * Formats date and time to the ISO format used by JSON. * * @return string Date and time. */ public function toJson() { return $this->format(self::DATE_JSON); } /** * Formats date and time to the RFC 2445 iCalendar DATE-TIME format. * * @param boolean $floating Whether to return a floating date-time * (without time zone information). * * @return string Date and time. */ public function toiCalendar($floating = false) { if ($floating) { return $this->format('Ymd\THis'); } $dateTime = $this->toDateTime(); $dateTime->setTimezone(new DateTimeZone('UTC')); return $dateTime->format('Ymd\THis\Z'); } /** * Formats time using the specifiers available in date() or in the DateTime * class' format() method. * * To format in languages other than English, use strftime() instead. * * @param string $format * * @return string Formatted time. */ public function format($format) { if (!isset($this->_formatCache[$format])) { $this->_formatCache[$format] = $this->toDateTime()->format($format); } return $this->_formatCache[$format]; } /** * Formats date and time using strftime() format. * * @return string strftime() formatted date and time. */ public function strftime($format) { if (preg_match('/%[^' . self::$_supportedSpecs . ']/', $format)) { return strftime($format, $this->timestamp()); } else { return $this->_strftime($format); } } /** * Callback used to replace a strtime pattern * * @param array $matches preg_replace_callback() matches. * * @return string Replacement string. */ protected function _regexCallback($reg) { switch ($reg[0]) { case '%b': return $this->strftime(Horde_Nls::getLangInfo(constant('ABMON_' . (int)$this->_month))); case '%B': return $this->strftime(Horde_Nls::getLangInfo(constant('MON_' . (int)$this->_month))); case '%C': return (int)($this->_year / 100); case '%-d': case '%#d': return sprintf('%d', $this->_mday); case '%d': return sprintf('%02d', $this->_mday); case '%D': return $this->strftime('%m/%d/%y'); case '%e': return sprintf('%2d', $this->_mday); case '%-H': case '%#H': return sprintf('%d', $this->_hour); case '%H': return sprintf('%02d', $this->_hour); case '%-I': case '%#I': return sprintf('%d', $this->_hour == 0 ? 12 : ($this->_hour > 12 ? $this->_hour - 12 : $this->_hour)); case '%I': return sprintf('%02d', $this->_hour == 0 ? 12 : ($this->_hour > 12 ? $this->_hour - 12 : $this->_hour)); case '%-m': case '%#m': return sprintf('%d', $this->_month); case '%m': return sprintf('%02d', $this->_month); case '%-M': case '%#M': return sprintf('%d', $this->_min); case '%M': return sprintf('%02d', $this->_min); case '%n': return "\n"; case '%p': return $this->strftime(Horde_Nls::getLangInfo($this->_hour < 12 ? AM_STR : PM_STR)); case '%R': return $this->strftime('%H:%M'); case '%-S': case '%#S': return sprintf('%d', $this->_sec); case '%S': return sprintf('%02d', $this->_sec); case '%t': return "\t"; case '%T': return $this->strftime('%H:%M:%S'); case '%x': return $this->strftime(Horde_Nls::getLangInfo(D_FMT)); case '%X': return $this->strftime(Horde_Nls::getLangInfo(T_FMT)); case '%y': return substr(sprintf('%04d', $this->_year), -2); case '%Y': return (int)$this->_year; case '%%': return '%'; } return $reg[0]; } /** * Formats date and time using a limited set of the strftime() format. * * @return string strftime() formatted date and time. */ protected function _strftime($format) { return preg_replace_callback('/(%([-#]?)[%bBCdDeHImMnpRStTxXyY])/', array($this, '_regexCallback'), $format); } /** * Corrects any over- or underflows in any of the date's members. * * @param integer $mask We may not want to correct some overflows. * @param integer $down Whether to correct the date up or down. */ protected function _correct($mask = self::MASK_ALLPARTS, $down = false) { if ($mask & self::MASK_SECOND) { if ($this->_sec < 0 || $this->_sec > 59) { $mask |= self::MASK_MINUTE; $this->_min += (int)($this->_sec / 60); $this->_sec %= 60; if ($this->_sec < 0) { $this->_min--; $this->_sec += 60; } } } if ($mask & self::MASK_MINUTE) { if ($this->_min < 0 || $this->_min > 59) { $mask |= self::MASK_HOUR; $this->_hour += (int)($this->_min / 60); $this->_min %= 60; if ($this->_min < 0) { $this->_hour--; $this->_min += 60; } } } if ($mask & self::MASK_HOUR) { if ($this->_hour < 0 || $this->_hour > 23) { $mask |= self::MASK_DAY; $this->_mday += (int)($this->_hour / 24); $this->_hour %= 24; if ($this->_hour < 0) { $this->_mday--; $this->_hour += 24; } } } if ($mask & self::MASK_MONTH) { $this->_correctMonth(); /* When correcting the month, always correct the day too. Months * have different numbers of days. */ if (isset($this->_mday)) { $mask |= self::MASK_DAY; } } if ($mask & self::MASK_DAY) { while ($this->_mday > (366 + 31)) { if ((Horde_Date_Utils::isLeapYear($this->_year) && ($this->_month <= 2)) || (Horde_Date_Utils::isLeapYear($this->_year + 1) && ($this->_month > 2))) { $this->_mday -= 366; } else { $this->_mday -= 365; } $this->_year++; } while ($this->_mday > 28 && $this->_mday > Horde_Date_Utils::daysInMonth($this->_month, $this->_year)) { if ($down) { $this->_mday -= Horde_Date_Utils::daysInMonth($this->_month + 1, $this->_year) - Horde_Date_Utils::daysInMonth($this->_month, $this->_year); } else { $this->_mday -= Horde_Date_Utils::daysInMonth($this->_month, $this->_year); $this->_month++; } $this->_correctMonth(); } while ($this->_mday < 1) { --$this->_month; $this->_correctMonth(); $this->_mday += Horde_Date_Utils::daysInMonth($this->_month, $this->_year); } } } /** * Corrects the current month. * * This cannot be done in _correct() because that would also trigger a * correction of the day, which would result in an infinite loop. */ protected function _correctMonth() { $this->_year += (int)($this->_month / 12); $this->_month %= 12; if ($this->_month < 1) { $this->_year--; $this->_month += 12; } } /** * Handles args in order: year month day hour min sec tz */ protected function _initializeFromArgs($args) { $tz = (isset($args[6])) ? array_pop($args) : null; $this->_initializeTimezone($tz); $args = array_slice($args, 0, 6); $keys = array('year' => 1, 'month' => 1, 'mday' => 1, 'hour' => 0, 'min' => 0, 'sec' => 0); $date = array_combine(array_slice(array_keys($keys), 0, count($args)), $args); $date = array_merge($keys, $date); $this->_initializeFromArray($date); } protected function _initializeFromArray($date) { if (isset($date['year']) && is_string($date['year']) && strlen($date['year']) == 2) { if ($date['year'] > 70) { $date['year'] += 1900; } else { $date['year'] += 2000; } } foreach ($date as $key => $val) { if (in_array($key, array('year', 'month', 'mday', 'hour', 'min', 'sec'))) { $this->{'_'. $key} = (int)$val; } } // If $date['day'] is present and numeric we may have been passed // a Horde_Form_datetime array. if (isset($date['day']) && (string)(int)$date['day'] == $date['day']) { $this->_mday = (int)$date['day']; } // 'minute' key also from Horde_Form_datetime if (isset($date['minute']) && (string)(int)$date['minute'] == $date['minute']) { $this->_min = (int)$date['minute']; } $this->_correct(); } protected function _initializeFromObject($date) { if ($date instanceof DateTime) { $this->_year = (int)$date->format('Y'); $this->_month = (int)$date->format('m'); $this->_mday = (int)$date->format('d'); $this->_hour = (int)$date->format('H'); $this->_min = (int)$date->format('i'); $this->_sec = (int)$date->format('s'); $this->_initializeTimezone($date->getTimezone()->getName()); } else { $is_horde_date = $date instanceof Horde_Date; foreach (array('year', 'month', 'mday', 'hour', 'min', 'sec') as $key) { if ($is_horde_date || isset($date->$key)) { $this->{'_' . $key} = (int)$date->$key; } } if (!$is_horde_date) { $this->_correct(); } else { $this->_initializeTimezone($date->timezone); } } } protected function _initializeTimezone($timezone) { if (empty($timezone)) { $timezone = date_default_timezone_get(); } elseif (array_key_exists($timezone, self::$_timezoneAliases)) { /* Workaround for standard cases of bug #11688 */ $timezone = self::$_timezoneAliases[$timezone]; } $this->_timezone = $timezone; } }
Simpan