Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. DateTimeNormalizer.php

class DateTimeNormalizer

Same name in this branch
  1. 11.1.x core/modules/serialization/src/Normalizer/DateTimeNormalizer.php \Drupal\serialization\Normalizer\DateTimeNormalizer

Normalizes an object implementing the {Denormalizes a date string to an instance of { @author Kévin Dunglas <dunglas@gmail.com>

Hierarchy

  • class \Symfony\Component\Serializer\Normalizer\DateTimeNormalizer implements \Symfony\Component\Serializer\Normalizer\NormalizerInterface, \Symfony\Component\Serializer\Normalizer\DenormalizerInterface

Expanded class hierarchy of DateTimeNormalizer

See also

\DateTimeInterface} to a date string.

\DateTime} or {@see \DateTimeImmutable}.

1 file declares its use of DateTimeNormalizer
DateTimeNormalizerContextBuilder.php in vendor/symfony/serializer/Context/Normalizer/DateTimeNormalizerContextBuilder.php

File

vendor/symfony/serializer/Normalizer/DateTimeNormalizer.php, line 23

Namespace

Symfony\Component\Serializer\Normalizer
View source
final class DateTimeNormalizer implements NormalizerInterface, DenormalizerInterface {
    public const FORMAT_KEY = 'datetime_format';
    public const TIMEZONE_KEY = 'datetime_timezone';
    public const CAST_KEY = 'datetime_cast';
    private array $defaultContext = [
        self::FORMAT_KEY => \DateTimeInterface::RFC3339,
        self::TIMEZONE_KEY => null,
        self::CAST_KEY => null,
    ];
    private const SUPPORTED_TYPES = [
        \DateTimeInterface::class => true,
        \DateTimeImmutable::class => true,
        \DateTime::class => true,
    ];
    public function __construct(array $defaultContext = []) {
        $this->setDefaultContext($defaultContext);
    }
    public function setDefaultContext(array $defaultContext) : void {
        $this->defaultContext = array_merge($this->defaultContext, $defaultContext);
    }
    public function getSupportedTypes(?string $format) : array {
        return self::SUPPORTED_TYPES;
    }
    
    /**
     * @throws InvalidArgumentException
     */
    public function normalize(mixed $object, ?string $format = null, array $context = []) : int|float|string {
        if (!$object instanceof \DateTimeInterface) {
            throw new InvalidArgumentException('The object must implement the "\\DateTimeInterface".');
        }
        $dateTimeFormat = $context[self::FORMAT_KEY] ?? $this->defaultContext[self::FORMAT_KEY];
        $timezone = $this->getTimezone($context);
        if (null !== $timezone) {
            $object = clone $object;
            $object = $object->setTimezone($timezone);
        }
        return match ($context[self::CAST_KEY] ?? $this->defaultContext[self::CAST_KEY] ?? false) {    'int' => (int) $object->format($dateTimeFormat),
            'float' => (double) $object->format($dateTimeFormat),
            default => $object->format($dateTimeFormat),
        
        };
    }
    public function supportsNormalization(mixed $data, ?string $format = null, array $context = []) : bool {
        return $data instanceof \DateTimeInterface;
    }
    
    /**
     * @throws NotNormalizableValueException
     */
    public function denormalize(mixed $data, string $type, ?string $format = null, array $context = []) : \DateTimeInterface {
        if (\is_int($data) || \is_float($data)) {
            switch ($context[self::FORMAT_KEY] ?? $this->defaultContext[self::FORMAT_KEY] ?? null) {
                case 'U':
                    $data = \sprintf('%d', $data);
                    break;
                case 'U.u':
                    $data = \sprintf('%.6F', $data);
                    break;
            }
        }
        if (!\is_string($data) || '' === trim($data)) {
            throw NotNormalizableValueException::createForUnexpectedDataType('The data is either not an string, an empty string, or null; you should pass a string that can be parsed with the passed format or a valid DateTime string.', $data, [
                'string',
            ], $context['deserialization_path'] ?? null, true);
        }
        try {
            if (\DateTimeInterface::class === $type) {
                $type = \DateTimeImmutable::class;
            }
            $timezone = $this->getTimezone($context);
            $dateTimeFormat = $context[self::FORMAT_KEY] ?? null;
            if (null !== $dateTimeFormat) {
                if (false !== ($object = $type::createFromFormat($dateTimeFormat, $data, $timezone))) {
                    return $object;
                }
                $dateTimeErrors = $type::getLastErrors();
                throw NotNormalizableValueException::createForUnexpectedDataType(\sprintf('Parsing datetime string "%s" using format "%s" resulted in %d errors: ', $data, $dateTimeFormat, $dateTimeErrors['error_count']) . "\n" . implode("\n", $this->formatDateTimeErrors($dateTimeErrors['errors'])), $data, [
                    'string',
                ], $context['deserialization_path'] ?? null, true);
            }
            $defaultDateTimeFormat = $this->defaultContext[self::FORMAT_KEY] ?? null;
            if (null !== $defaultDateTimeFormat) {
                if (false !== ($object = $type::createFromFormat($defaultDateTimeFormat, $data, $timezone))) {
                    return $object;
                }
            }
            return new $type($data, $timezone);
        } catch (NotNormalizableValueException $e) {
            throw $e;
        } catch (\Exception $e) {
            throw NotNormalizableValueException::createForUnexpectedDataType($e->getMessage(), $data, [
                'string',
            ], $context['deserialization_path'] ?? null, false, $e->getCode(), $e);
        }
    }
    public function supportsDenormalization(mixed $data, string $type, ?string $format = null, array $context = []) : bool {
        return is_a($type, \DateTimeInterface::class, true);
    }
    
    /**
     * Formats datetime errors.
     *
     * @return string[]
     */
    private function formatDateTimeErrors(array $errors) : array {
        $formattedErrors = [];
        foreach ($errors as $pos => $message) {
            $formattedErrors[] = \sprintf('at position %d: %s', $pos, $message);
        }
        return $formattedErrors;
    }
    private function getTimezone(array $context) : ?\DateTimeZone {
        $dateTimeZone = $context[self::TIMEZONE_KEY] ?? $this->defaultContext[self::TIMEZONE_KEY];
        if (null === $dateTimeZone) {
            return null;
        }
        return $dateTimeZone instanceof \DateTimeZone ? $dateTimeZone : new \DateTimeZone($dateTimeZone);
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
DateTimeNormalizer::$defaultContext private property
DateTimeNormalizer::CAST_KEY public constant
DateTimeNormalizer::denormalize public function Overrides DenormalizerInterface::denormalize
DateTimeNormalizer::formatDateTimeErrors private function Formats datetime errors.
DateTimeNormalizer::FORMAT_KEY public constant
DateTimeNormalizer::getSupportedTypes public function Returns the types potentially supported by this normalizer. Overrides NormalizerInterface::getSupportedTypes
DateTimeNormalizer::getTimezone private function
DateTimeNormalizer::normalize public function Overrides NormalizerInterface::normalize
DateTimeNormalizer::setDefaultContext public function
DateTimeNormalizer::SUPPORTED_TYPES private constant
DateTimeNormalizer::supportsDenormalization public function Checks whether the given class is supported for denormalization by this normalizer. Overrides DenormalizerInterface::supportsDenormalization
DateTimeNormalizer::supportsNormalization public function Checks whether the given class is supported for normalization by this normalizer. Overrides NormalizerInterface::supportsNormalization
DateTimeNormalizer::TIMEZONE_KEY public constant
DateTimeNormalizer::__construct public function
DenormalizerInterface::COLLECT_DENORMALIZATION_ERRORS public constant
RSS feed
Powered by Drupal