PHP 8.2.30
Preview: DateTime.php Size: 12.10 KB
/home/byroehnu/easetack.com/vendor/fakerphp/faker/src/Faker/Provider/DateTime.php

<?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(?string $countryCode = null)
    {
        if ($countryCode) {
            $timezones = \DateTimeZone::listIdentifiers(\DateTimeZone::PER_COUNTRY, $countryCode);
        } else {
            $timezones = \DateTimeZone::listIdentifiers();
        }

        return static::randomElement($timezones);
    }

    /**
     * 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;
    }
}

Directory Contents

Dirs: 75 × Files: 20

Name Size Perms Modified Actions
ar_EG DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
ar_JO DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
ar_SA DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
at_AT DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
bg_BG DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
bn_BD DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
cs_CZ DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
da_DK DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
de_AT DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
de_CH DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
de_DE DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
el_CY DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
el_GR DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
en_AU DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
en_CA DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
en_GB DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
en_HK DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
en_IN DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
en_NG DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
en_NZ DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
en_PH DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
en_SG DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
en_UG DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
en_US DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
en_ZA DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
es_AR DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
es_ES DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
es_PE DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
es_VE DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
et_EE DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
fa_IR DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
fi_FI DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
fr_BE DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
fr_CA DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
fr_CH DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
fr_FR DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
he_IL DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
hr_HR DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
hu_HU DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
hy_AM DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
id_ID DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
is_IS DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
it_CH DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
it_IT DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
ja_JP DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
ka_GE DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
kk_KZ DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
ko_KR DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
lt_LT DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
lv_LV DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
me_ME DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
mn_MN DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
ms_MY DIR
- drwxrwxrwx 2025-05-16 16:14:39
Edit Download
nb_NO DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
ne_NP DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
nl_BE DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
nl_NL DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
pl_PL DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
pt_BR DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
pt_PT DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
ro_MD DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
ro_RO DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
ru_RU DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
sk_SK DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
sl_SI DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
sr_RS DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
sv_SE DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
th_TH DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
tr_TR DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
uk_UA DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
vi_VN DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
zh_CN DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
zh_TW DIR
- drwxrwxrwx 2025-05-16 16:14:40
Edit Download
3.49 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
2.19 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
22.20 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
1.79 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
4.64 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
901 B lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
12.10 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
25.10 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
9.98 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
6.00 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
17.17 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
7.70 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
648 B lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
13.21 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
10.42 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
3.23 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
6.45 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
6.65 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
8.46 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download
1.78 KB lrw-rw-rw- 2024-11-21 13:46:39
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).