class DateTimeNormalizerContextBuilder

final class DateTimeNormalizerContextBuilder implements ContextBuilderInterface {
    use ContextBuilderTrait;
    
    /**
     * Configures the format of the date.
     *
     * @see https://secure.php.net/manual/en/datetime.format.php
     */
    public function withFormat(?string $format) : static {
        return $this->with(DateTimeNormalizer::FORMAT_KEY, $format);
    }
    
    /**
     * Configures the timezone of the date.
     *
     * It could be either a \DateTimeZone or a string
     * that will be used to construct the \DateTimeZone
     *
     * @see https://secure.php.net/manual/en/class.datetimezone.php
     *
     * @throws InvalidArgumentException
     */
    public function withTimezone(\DateTimeZone|string|null $timezone) : static {
        if (null === $timezone) {
            return $this->with(DateTimeNormalizer::TIMEZONE_KEY, null);
        }
        if (\is_string($timezone)) {
            try {
                $timezone = new \DateTimeZone($timezone);
            } catch (\Exception $e) {
                throw new InvalidArgumentException(\sprintf('The "%s" timezone is invalid.', $timezone), previous: $e);
            }
        }
        return $this->with(DateTimeNormalizer::TIMEZONE_KEY, $timezone);
    }
    
    /**
     * @param 'int'|'float'|null $cast
     */
    public function withCast(?string $cast) : static {
        return $this->with(DateTimeNormalizer::CAST_KEY, $cast);
    }

}