TimestampItemNormalizer.php

Same filename and directory in other branches
  1. 9 core/modules/serialization/src/Normalizer/TimestampItemNormalizer.php
  2. 9 core/modules/hal/src/Normalizer/TimestampItemNormalizer.php
  3. 8.9.x core/modules/serialization/src/Normalizer/TimestampItemNormalizer.php
  4. 8.9.x core/modules/hal/src/Normalizer/TimestampItemNormalizer.php
  5. 10 core/modules/serialization/src/Normalizer/TimestampItemNormalizer.php

Namespace

Drupal\serialization\Normalizer

File

core/modules/serialization/src/Normalizer/TimestampItemNormalizer.php

View source
<?php

namespace Drupal\serialization\Normalizer;

use Drupal\Core\Field\Plugin\Field\FieldType\TimestampItem;
use Drupal\Core\TypedData\Plugin\DataType\Timestamp;

/**
 * Converts values for TimestampItem to and from common formats.
 *
 * Overrides FieldItemNormalizer to use \Drupal\serialization\Normalizer\TimestampNormalizer
 *
 * Overrides FieldItemNormalizer to
 * - during normalization, add the 'format' key to assist consumers
 * - during denormalization, use \Drupal\serialization\Normalizer\TimestampNormalizer
 */
class TimestampItemNormalizer extends FieldItemNormalizer {
    
    /**
     * {@inheritdoc}
     */
    public function normalize($object, $format = NULL, array $context = []) : array|string|int|float|bool|\ArrayObject|null {
        return parent::normalize($object, $format, $context) + [
            // 'format' is not a property on Timestamp objects. This is present to
            // assist consumers of this data.
'format' => \DateTime::RFC3339,
        ];
    }
    
    /**
     * {@inheritdoc}
     */
    protected function constructValue($data, $context) {
        if (!empty($data['format'])) {
            $context['datetime_allowed_formats'] = [
                $data['format'],
            ];
        }
        return [
            'value' => $this->serializer
                ->denormalize($data['value'], Timestamp::class, NULL, $context),
        ];
    }
    
    /**
     * {@inheritdoc}
     */
    public function getSupportedTypes(?string $format) : array {
        return [
            TimestampItem::class => TRUE,
        ];
    }

}

Classes

Title Deprecated Summary
TimestampItemNormalizer Converts values for TimestampItem to and from common formats.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.