<?php namespace Faker\Provider; class DateTime extends Base { protected static $century = ['I', 'II', 'III', 'IV', 'V', 'VI', 'VII', 'VIII', 'IX', 'X', 'XI', 'XII', 'XIII', 'XIV', 'XV', 'XVI', 'XVII', 'XVIII', 'XIX', 'XX', 'XXI']; protected static $defaultTimezone = null; /** * @param \DateTime|float|int|string $max * * @return false|int */ protected static function getMaxTimestamp($max = 'now') { if (is_numeric($max)) { return (int) $max; } if ($max instanceof \DateTime) { return $max->getTimestamp(); } return strtotime(empty($max) ? 'now' : $max); } /** * Get a timestamp between January 1, 1970, and now * * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * * @return int * * @example 1061306726 */ public static function unixTime($max = 'now') { return self::numberBetween(0, static::getMaxTimestamp($max)); } /** * Get a datetime object for a date between January 1, 1970 and now * * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * @param string $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get` * * @return \DateTime * * @see http://php.net/manual/en/timezones.php * @see http://php.net/manual/en/function.date-default-timezone-get.php * * @example DateTime('2005-08-16 20:39:21') */ public static function dateTime($max = 'now', $timezone = null) { return static::setTimezone( new \DateTime('@' . static::unixTime($max)), $timezone, ); } /** * Get a datetime object for a date between January 1, 001 and now * * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * @param string|null $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get` * * @return \DateTime * * @see http://php.net/manual/en/timezones.php * @see http://php.net/manual/en/function.date-default-timezone-get.php * * @example DateTime('1265-03-22 21:15:52') */ public static function dateTimeAD($max = 'now', $timezone = null) { $min = (PHP_INT_SIZE > 4 ? -62135597361 : -PHP_INT_MAX); return static::setTimezone( new \DateTime('@' . self::numberBetween($min, static::getMaxTimestamp($max))), $timezone, ); } /** * get a date string formatted with ISO8601 * * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * * @return string * * @example '2003-10-21T16:05:52+0000' */ public static function iso8601($max = 'now') { return static::date(\DateTime::ISO8601, $max); } /** * Get a date string between January 1, 1970 and now * * @param string $format * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * * @return string * * @example '2008-11-27' */ public static function date($format = 'Y-m-d', $max = 'now') { return static::dateTime($max)->format($format); } /** * Get a time string (24h format by default) * * @param string $format * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * * @return string * * @example '15:02:34' */ public static function time($format = 'H:i:s', $max = 'now') { return static::dateTime($max)->format($format); } /** * Get a DateTime object based on a random date between two given dates. * Accepts date strings that can be recognized by strtotime(). * * @param \DateTime|string $startDate Defaults to 30 years ago * @param \DateTime|string $endDate Defaults to "now" * @param string|null $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get` * * @return \DateTime * * @see http://php.net/manual/en/timezones.php * @see http://php.net/manual/en/function.date-default-timezone-get.php * * @example DateTime('1999-02-02 11:42:52') */ public static function dateTimeBetween($startDate = '-30 years', $endDate = 'now', $timezone = null) { $startTimestamp = $startDate instanceof \DateTime ? $startDate->getTimestamp() : strtotime($startDate); $endTimestamp = static::getMaxTimestamp($endDate); if ($startTimestamp > $endTimestamp) { throw new \InvalidArgumentException('Start date must be anterior to end date.'); } $timestamp = self::numberBetween($startTimestamp, $endTimestamp); return static::setTimezone( new \DateTime('@' . $timestamp), $timezone, ); } /** * Get a DateTime object based on a random date between one given date and * an interval * Accepts date string that can be recognized by strtotime(). * * @param \DateTime|string $date Defaults to 30 years ago * @param string $interval Defaults to 5 days after * @param string|null $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get` * * @return \DateTime * * @example dateTimeInInterval('1999-02-02 11:42:52', '+ 5 days') * * @see http://php.net/manual/en/timezones.php * @see http://php.net/manual/en/function.date-default-timezone-get.php */ public static function dateTimeInInterval($date = '-30 years', $interval = '+5 days', $timezone = null) { $intervalObject = \DateInterval::createFromDateString($interval); $datetime = $date instanceof \DateTime ? $date : new \DateTime($date); $otherDatetime = clone $datetime; $otherDatetime->add($intervalObject); $begin = min($datetime, $otherDatetime); $end = $datetime === $begin ? $otherDatetime : $datetime; return static::dateTimeBetween( $begin, $end, $timezone, ); } /** * Get a date time object somewhere within a century. * * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * @param string|null $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get` * * @return \DateTime */ public static function dateTimeThisCentury($max = 'now', $timezone = null) { return static::dateTimeBetween('-100 year', $max, $timezone); } /** * Get a date time object somewhere within a decade. * * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * @param string|null $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get` * * @return \DateTime */ public static function dateTimeThisDecade($max = 'now', $timezone = null) { return static::dateTimeBetween('-10 year', $max, $timezone); } /** * Get a date time object somewhere inside the current year. * * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * @param string|null $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get` * * @return \DateTime */ public static function dateTimeThisYear($max = 'now', $timezone = null) { return static::dateTimeBetween('first day of january this year', $max, $timezone); } /** * Get a date time object somewhere within a month. * * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * @param string|null $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get` * * @return \DateTime */ public static function dateTimeThisMonth($max = 'now', $timezone = null) { return static::dateTimeBetween('-1 month', $max, $timezone); } /** * Get a string containing either "am" or "pm". * * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * * @return string * * @example 'am' */ public static function amPm($max = 'now') { return static::dateTime($max)->format('a'); } /** * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * * @return string * * @example '22' */ public static function dayOfMonth($max = 'now') { return static::dateTime($max)->format('d'); } /** * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * * @return string * * @example 'Tuesday' */ public static function dayOfWeek($max = 'now') { return static::dateTime($max)->format('l'); } /** * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * * @return string * * @example '7' */ public static function month($max = 'now') { return static::dateTime($max)->format('m'); } /** * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * * @return string * * @example 'September' */ public static function monthName($max = 'now') { return static::dateTime($max)->format('F'); } /** * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now" * * @return string * * @example '1987' */ public static function year($max = 'now') { return static::dateTime($max)->format('Y'); } /** * @return string * * @example 'XVII' */ public static function century() { return static::randomElement(static::$century); } /** * @return string * * @example 'Europe/Paris' */ public static function timezone() { return static::randomElement(\DateTimeZone::listIdentifiers()); } /** * Internal method to set the time zone on a DateTime. * * @param string|null $timezone * * @return \DateTime */ private static function setTimezone(\DateTime $dt, $timezone) { return $dt->setTimezone(new \DateTimeZone(static::resolveTimezone($timezone))); } /** * Sets default time zone. * * @param string $timezone */ public static function setDefaultTimezone($timezone = null) { static::$defaultTimezone = $timezone; } /** * Gets default time zone. * * @return string|null */ public static function getDefaultTimezone() { return static::$defaultTimezone; } /** * @param string|null $timezone * * @return string|null */ private static function resolveTimezone($timezone) { return (null === $timezone) ? ((null === static::$defaultTimezone) ? date_default_timezone_get() : static::$defaultTimezone) : $timezone; } }
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
ar_EG | Folder | 0755 |
|
|
ar_JO | Folder | 0755 |
|
|
ar_SA | Folder | 0755 |
|
|
at_AT | Folder | 0755 |
|
|
bg_BG | Folder | 0755 |
|
|
bn_BD | Folder | 0755 |
|
|
cs_CZ | Folder | 0755 |
|
|
da_DK | Folder | 0755 |
|
|
de_AT | Folder | 0755 |
|
|
de_CH | Folder | 0755 |
|
|
de_DE | Folder | 0755 |
|
|
el_CY | Folder | 0755 |
|
|
el_GR | Folder | 0755 |
|
|
en_AU | Folder | 0755 |
|
|
en_CA | Folder | 0755 |
|
|
en_GB | Folder | 0755 |
|
|
en_HK | Folder | 0755 |
|
|
en_IN | Folder | 0755 |
|
|
en_NG | Folder | 0755 |
|
|
en_NZ | Folder | 0755 |
|
|
en_PH | Folder | 0755 |
|
|
en_SG | Folder | 0755 |
|
|
en_UG | Folder | 0755 |
|
|
en_US | Folder | 0755 |
|
|
en_ZA | Folder | 0755 |
|
|
es_AR | Folder | 0755 |
|
|
es_ES | Folder | 0755 |
|
|
es_PE | Folder | 0755 |
|
|
es_VE | Folder | 0755 |
|
|
et_EE | Folder | 0755 |
|
|
fa_IR | Folder | 0755 |
|
|
fi_FI | Folder | 0755 |
|
|
fr_BE | Folder | 0755 |
|
|
fr_CA | Folder | 0755 |
|
|
fr_CH | Folder | 0755 |
|
|
fr_FR | Folder | 0755 |
|
|
he_IL | Folder | 0755 |
|
|
hr_HR | Folder | 0755 |
|
|
hu_HU | Folder | 0755 |
|
|
hy_AM | Folder | 0755 |
|
|
id_ID | Folder | 0755 |
|
|
is_IS | Folder | 0755 |
|
|
it_CH | Folder | 0755 |
|
|
it_IT | Folder | 0755 |
|
|
ja_JP | Folder | 0755 |
|
|
ka_GE | Folder | 0755 |
|
|
kk_KZ | Folder | 0755 |
|
|
ko_KR | Folder | 0755 |
|
|
lt_LT | Folder | 0755 |
|
|
lv_LV | Folder | 0755 |
|
|
me_ME | Folder | 0755 |
|
|
mn_MN | Folder | 0755 |
|
|
ms_MY | Folder | 0755 |
|
|
nb_NO | Folder | 0755 |
|
|
ne_NP | Folder | 0755 |
|
|
nl_BE | Folder | 0755 |
|
|
nl_NL | Folder | 0755 |
|
|
pl_PL | Folder | 0755 |
|
|
pt_BR | Folder | 0755 |
|
|
pt_PT | Folder | 0755 |
|
|
ro_MD | Folder | 0755 |
|
|
ro_RO | Folder | 0755 |
|
|
ru_RU | Folder | 0755 |
|
|
sk_SK | Folder | 0755 |
|
|
sl_SI | Folder | 0755 |
|
|
sr_Cyrl_RS | Folder | 0755 |
|
|
sr_Latn_RS | Folder | 0755 |
|
|
sr_RS | Folder | 0755 |
|
|
sv_SE | Folder | 0755 |
|
|
th_TH | Folder | 0755 |
|
|
tr_TR | Folder | 0755 |
|
|
uk_UA | Folder | 0755 |
|
|
vi_VN | Folder | 0755 |
|
|
zh_CN | Folder | 0755 |
|
|
zh_TW | Folder | 0755 |
|
|
Address.php | File | 3.49 KB | 0644 |
|
Barcode.php | File | 2.19 KB | 0644 |
|
Base.php | File | 20.44 KB | 0644 |
|
Biased.php | File | 1.79 KB | 0644 |
|
Color.php | File | 4.64 KB | 0644 |
|
Company.php | File | 901 B | 0644 |
|
DateTime.php | File | 11.88 KB | 0644 |
|
File.php | File | 25.1 KB | 0644 |
|
HtmlLorem.php | File | 9.98 KB | 0644 |
|
Image.php | File | 6 KB | 0644 |
|
Internet.php | File | 17.17 KB | 0644 |
|
Lorem.php | File | 7.62 KB | 0644 |
|
Medical.php | File | 648 B | 0644 |
|
Miscellaneous.php | File | 13.13 KB | 0644 |
|
Payment.php | File | 10.42 KB | 0644 |
|
Person.php | File | 3.23 KB | 0644 |
|
PhoneNumber.php | File | 6.45 KB | 0644 |
|
Text.php | File | 6.65 KB | 0644 |
|
UserAgent.php | File | 8.46 KB | 0644 |
|
Uuid.php | File | 1.78 KB | 0644 |
|