Subversion-Projekte lars-tiefland.laravel_shop

<?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;

    }

}