<?php

namespace Carbon\Traits;

use Carbon\Carbon;
use Carbon\CarbonImmutable;
use Carbon\CarbonInterface;
use Carbon\CarbonInterval;
use Carbon\CarbonPeriod;
use Carbon\CarbonPeriodImmutable;
use Carbon\Exceptions\UnitException;
use Closure;
use DateTime;
use DateTimeImmutable;
use ReturnTypeWillChange;

/**
 * Trait Converter.
 *
 * Change date into different string formats and types and
 * handle the string cast.
 *
 * Depends on the following methods:
 *
 * @method static copy()
 */
trait Converter
{
	use ToStringFormat;

	/**
	 * Returns the formatted date string on success or FALSE on failure.
	 *
	 * @see https://php.net/manual/en/datetime.format.php
	 *
	 * @param string $format
	 *
	 * @return string
	 */
	#[ReturnTypeWillChange]
	public function format($format)
	{
		$function = $this->localFormatFunction ?: static::$formatFunction;

		if (!$function) {
		    return $this->rawFormat($format);
		}

		if (\is_string($function) && method_exists($this, $function)) {
		    $function = [$this, $function];
		}

		return $function(...\func_get_args());
	}


	/**
	 * @see https://php.net/manual/en/datetime.format.php
	 *
	 * @param string $format
	 *
	 * @return string
	 */
	public function rawFormat($format)
	{
		return parent::format($format);
	}


	/**
	 * Format the instance as a string using the set format
	 *
	 * @example
	 * ```
	 * echo Carbon::now(); // Carbon instances can be cast to string
	 * ```
	 *
	 * @return string
	 */
	public function __toString()
	{
		$format = $this->localToStringFormat ?? static::$toStringFormat;

		return $format instanceof Closure
		    ? $format($this)
		    : $this->rawFormat($format ?: (
		        \defined('static::DEFAULT_TO_STRING_FORMAT')
		            ? static::DEFAULT_TO_STRING_FORMAT
		            : CarbonInterface::DEFAULT_TO_STRING_FORMAT
		    ));
	}


	/**
	 * Format the instance as date
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toDateString();
	 * ```
	 *
	 * @return string
	 */
	public function toDateString()
	{
		return $this->rawFormat('Y-m-d');
	}


	/**
	 * Format the instance as a readable date
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toFormattedDateString();
	 * ```
	 *
	 * @return string
	 */
	public function toFormattedDateString()
	{
		return $this->rawFormat('M j, Y');
	}


	/**
	 * Format the instance with the day, and a readable date
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toFormattedDayDateString();
	 * ```
	 *
	 * @return string
	 */
	public function toFormattedDayDateString(): string
	{
		return $this->rawFormat('D, M j, Y');
	}


	/**
	 * Format the instance as time
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toTimeString();
	 * ```
	 *
	 * @param string $unitPrecision
	 *
	 * @return string
	 */
	public function toTimeString($unitPrecision = 'second')
	{
		return $this->rawFormat(static::getTimeFormatByPrecision($unitPrecision));
	}


	/**
	 * Format the instance as date and time
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toDateTimeString();
	 * ```
	 *
	 * @param string $unitPrecision
	 *
	 * @return string
	 */
	public function toDateTimeString($unitPrecision = 'second')
	{
		return $this->rawFormat('Y-m-d '.static::getTimeFormatByPrecision($unitPrecision));
	}


	/**
	 * Return a format from H:i to H:i:s.u according to given unit precision.
	 *
	 * @param string $unitPrecision "minute", "second", "millisecond" or "microsecond"
	 *
	 * @return string
	 */
	public static function getTimeFormatByPrecision($unitPrecision)
	{
		switch (static::singularUnit($unitPrecision)) {
		    case 'minute':
		        return 'H:i';
		    case 'second':
		        return 'H:i:s';
		    case 'm':
		    case 'millisecond':
		        return 'H:i:s.v';
		    case 'µ':
		    case 'microsecond':
		        return 'H:i:s.u';
		}

		throw new UnitException('Precision unit expected among: minute, second, millisecond and microsecond.');
	}


	/**
	 * Format the instance as date and time T-separated with no timezone
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toDateTimeLocalString();
	 * echo "\n";
	 * echo Carbon::now()->toDateTimeLocalString('minute'); // You can specify precision among: minute, second, millisecond and microsecond
	 * ```
	 *
	 * @param string $unitPrecision
	 *
	 * @return string
	 */
	public function toDateTimeLocalString($unitPrecision = 'second')
	{
		return $this->rawFormat('Y-m-d\T'.static::getTimeFormatByPrecision($unitPrecision));
	}


	/**
	 * Format the instance with day, date and time
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toDayDateTimeString();
	 * ```
	 *
	 * @return string
	 */
	public function toDayDateTimeString()
	{
		return $this->rawFormat('D, M j, Y g:i A');
	}


	/**
	 * Format the instance as ATOM
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toAtomString();
	 * ```
	 *
	 * @return string
	 */
	public function toAtomString()
	{
		return $this->rawFormat(DateTime::ATOM);
	}


	/**
	 * Format the instance as COOKIE
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toCookieString();
	 * ```
	 *
	 * @return string
	 */
	public function toCookieString()
	{
		return $this->rawFormat(DateTime::COOKIE);
	}


	/**
	 * Format the instance as ISO8601
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toIso8601String();
	 * ```
	 *
	 * @return string
	 */
	public function toIso8601String()
	{
		return $this->toAtomString();
	}


	/**
	 * Format the instance as RFC822
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toRfc822String();
	 * ```
	 *
	 * @return string
	 */
	public function toRfc822String()
	{
		return $this->rawFormat(DateTime::RFC822);
	}


	/**
	 * Convert the instance to UTC and return as Zulu ISO8601
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toIso8601ZuluString();
	 * ```
	 *
	 * @param string $unitPrecision
	 *
	 * @return string
	 */
	public function toIso8601ZuluString($unitPrecision = 'second')
	{
		return $this->avoidMutation()
		    ->utc()
		    ->rawFormat('Y-m-d\T'.static::getTimeFormatByPrecision($unitPrecision).'\Z');
	}


	/**
	 * Format the instance as RFC850
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toRfc850String();
	 * ```
	 *
	 * @return string
	 */
	public function toRfc850String()
	{
		return $this->rawFormat(DateTime::RFC850);
	}


	/**
	 * Format the instance as RFC1036
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toRfc1036String();
	 * ```
	 *
	 * @return string
	 */
	public function toRfc1036String()
	{
		return $this->rawFormat(DateTime::RFC1036);
	}


	/**
	 * Format the instance as RFC1123
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toRfc1123String();
	 * ```
	 *
	 * @return string
	 */
	public function toRfc1123String()
	{
		return $this->rawFormat(DateTime::RFC1123);
	}


	/**
	 * Format the instance as RFC2822
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toRfc2822String();
	 * ```
	 *
	 * @return string
	 */
	public function toRfc2822String()
	{
		return $this->rawFormat(DateTime::RFC2822);
	}


	/**
	 * Format the instance as RFC3339
	 *
	 * @param bool $extended
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toRfc3339String() . "\n";
	 * echo Carbon::now()->toRfc3339String(true) . "\n";
	 * ```
	 *
	 * @return string
	 */
	public function toRfc3339String($extended = false)
	{
		$format = DateTime::RFC3339;
		if ($extended) {
		    $format = DateTime::RFC3339_EXTENDED;
		}

		return $this->rawFormat($format);
	}


	/**
	 * Format the instance as RSS
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toRssString();
	 * ```
	 *
	 * @return string
	 */
	public function toRssString()
	{
		return $this->rawFormat(DateTime::RSS);
	}


	/**
	 * Format the instance as W3C
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toW3cString();
	 * ```
	 *
	 * @return string
	 */
	public function toW3cString()
	{
		return $this->rawFormat(DateTime::W3C);
	}


	/**
	 * Format the instance as RFC7231
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toRfc7231String();
	 * ```
	 *
	 * @return string
	 */
	public function toRfc7231String()
	{
		return $this->avoidMutation()
		    ->setTimezone('GMT')
		    ->rawFormat(\defined('static::RFC7231_FORMAT') ? static::RFC7231_FORMAT : CarbonInterface::RFC7231_FORMAT);
	}


	/**
	 * Get default array representation.
	 *
	 * @example
	 * ```
	 * var_dump(Carbon::now()->toArray());
	 * ```
	 *
	 * @return array
	 */
	public function toArray()
	{
		return [
		    'year' => $this->year,
		    'month' => $this->month,
		    'day' => $this->day,
		    'dayOfWeek' => $this->dayOfWeek,
		    'dayOfYear' => $this->dayOfYear,
		    'hour' => $this->hour,
		    'minute' => $this->minute,
		    'second' => $this->second,
		    'micro' => $this->micro,
		    'timestamp' => $this->timestamp,
		    'formatted' => $this->rawFormat(\defined('static::DEFAULT_TO_STRING_FORMAT') ? static::DEFAULT_TO_STRING_FORMAT : CarbonInterface::DEFAULT_TO_STRING_FORMAT),
		    'timezone' => $this->timezone,
		];
	}


	/**
	 * Get default object representation.
	 *
	 * @example
	 * ```
	 * var_dump(Carbon::now()->toObject());
	 * ```
	 *
	 * @return object
	 */
	public function toObject()
	{
		return (object) $this->toArray();
	}


	/**
	 * Returns english human readable complete date string.
	 *
	 * @example
	 * ```
	 * echo Carbon::now()->toString();
	 * ```
	 *
	 * @return string
	 */
	public function toString()
	{
		return $this->avoidMutation()->locale('en')->isoFormat('ddd MMM DD YYYY HH:mm:ss [GMT]ZZ');
	}


	/**
	 * Return the ISO-8601 string (ex: 1977-04-22T06:00:00Z, if $keepOffset truthy, offset will be kept:
	 * 1977-04-22T01:00:00-05:00).
	 *
	 * @example
	 * ```
	 * echo Carbon::now('America/Toronto')->toISOString() . "\n";
	 * echo Carbon::now('America/Toronto')->toISOString(true) . "\n";
	 * ```
	 *
	 * @param bool $keepOffset Pass true to keep the date offset. Else forced to UTC.
	 *
	 * @return null|string
	 */
	public function toISOString($keepOffset = false)
	{
		if (!$this->isValid()) {
		    return null;
		}

		$yearFormat = $this->year < 0 || $this->year > 9999 ? 'YYYYYY' : 'YYYY';
		$tzFormat = $keepOffset ? 'Z' : '[Z]';
		$date = $keepOffset ? $this : $this->avoidMutation()->utc();

		return $date->isoFormat("$yearFormat-MM-DD[T]HH:mm:ss.SSSSSS$tzFormat");
	}


	/**
	 * Return the ISO-8601 string (ex: 1977-04-22T06:00:00Z) with UTC timezone.
	 *
	 * @example
	 * ```
	 * echo Carbon::now('America/Toronto')->toJSON();
	 * ```
	 *
	 * @return null|string
	 */
	public function toJSON()
	{
		return $this->toISOString();
	}


	/**
	 * Return native DateTime PHP object matching the current instance.
	 *
	 * @example
	 * ```
	 * var_dump(Carbon::now()->toDateTime());
	 * ```
	 *
	 * @return DateTime
	 */
	public function toDateTime()
	{
		return new DateTime($this->rawFormat('Y-m-d H:i:s.u'), $this->getTimezone());
	}


	/**
	 * Return native toDateTimeImmutable PHP object matching the current instance.
	 *
	 * @example
	 * ```
	 * var_dump(Carbon::now()->toDateTimeImmutable());
	 * ```
	 *
	 * @return DateTimeImmutable
	 */
	public function toDateTimeImmutable()
	{
		return new DateTimeImmutable($this->rawFormat('Y-m-d H:i:s.u'), $this->getTimezone());
	}


	/**
	 * @alias toDateTime
	 *
	 * Return native DateTime PHP object matching the current instance.
	 *
	 * @example
	 * ```
	 * var_dump(Carbon::now()->toDate());
	 * ```
	 *
	 * @return DateTime
	 */
	public function toDate()
	{
		return $this->toDateTime();
	}


	/**
	 * Create a iterable CarbonPeriod object from current date to a given end date (and optional interval).
	 *
	 * @param \DateTimeInterface|Carbon|CarbonImmutable|int|null $end      period end date or recurrences count if int
	 * @param int|\DateInterval|string|null                      $interval period default interval or number of the given $unit
	 * @param string|null                                        $unit     if specified, $interval must be an integer
	 *
	 * @return CarbonPeriod
	 */
	public function toPeriod($end = null, $interval = null, $unit = null)
	{
		if ($unit) {
		    $interval = CarbonInterval::make("$interval ".static::pluralUnit($unit));
		}

		$period = ($this->isMutable() ? new CarbonPeriod() : new CarbonPeriodImmutable())
		    ->setDateClass(static::class)
		    ->setStartDate($this);

		if ($interval) {
		    $period = $period->setDateInterval($interval);
		}

		if (\is_int($end) || (\is_string($end) && ctype_digit($end))) {
		    $period = $period->setRecurrences($end);
		} elseif ($end) {
		    $period = $period->setEndDate($end);
		}

		return $period;
	}


	/**
	 * Create a iterable CarbonPeriod object from current date to a given end date (and optional interval).
	 *
	 * @param \DateTimeInterface|Carbon|CarbonImmutable|null $end      period end date
	 * @param int|\DateInterval|string|null                  $interval period default interval or number of the given $unit
	 * @param string|null                                    $unit     if specified, $interval must be an integer
	 *
	 * @return CarbonPeriod
	 */
	public function range($end = null, $interval = null, $unit = null)
	{
		return $this->toPeriod($end, $interval, $unit);
	}
}
__halt_compiler();----SIGNATURE:----XmVphrimmyLNZopC1fJKheDUfA5kz/d4GRKl++Pv/GPvtGq5K7uE/ojR9GOmLAZUkU6g5A6f+HQ2UJgumoi9C1B49ed2dJSJyoOp7Z46r4s530E9ZsrpYYll0Zaw05uppOZcXL9yYnzDdQxTN2X4xiAEOlhnP/nBtp546qlAsZBpnRsRzIcaUAQzzP1bGzbFKK2oGJz4mRafIqCsrcai0ASoGV3m99nwaE6/PqW4eZ51/a77U+dkE+JzyzxmFg7kfctrq5hWCiJpYjxWBNyEGYwy02E97O69A/kl1hmIzK1sSlrzo2zFs8W6AvQhYQcT8sEigNbLnc/ggYN/hWjhXggESgONFPmn2dtTKvirKet7vAhLeYucNXbqlami7ASgZTtDzFaQJjYCWfqhCWbEh9ej9Vl8rp9WpnScq1Mr9cmpGP3r/QY4Csf7GMk5T4sFCMc3nAkWtD64UEkuQbVwD18VVJLijEXdQ1qCbYggxH6429yvoRD9mKcKCYHM2WQLU/FUsoHGVxmTslYMKjW8o4y/SbhPH/pO/2VanigHXKgT/vWqF+zeRrAh94aMGXr0nF3m0L46kKRBu5EBv2rs5A1Ys0BXBebQcKsp4ZLRhFbfvMXyvMC6gEUjyoxafzKIDEWiyPyS6UNVdH6d0NrLKoYEcwlDpePIJOH76c9TmGQ=----ATTACHMENT:----NjE1MzQwNDY5NDI3MDc5NSA2NzAzNjk1MTM5OTk4MjgxIDcxMjMzNzg3NDg4NzE4NDU=