Add Source Code

- Date, DateTime, and UtcDateTime.
- DateInterface, and DateTimeInterface.

Author: zanbaldwin

src/Date.php

@@ -0,0 +1,17 @@
+<?php declare(strict_types=1);
+
+namespace Darsyn\DateTime;
+
+class Date extends DateTime implements DateInterface
+{
+    public function __construct(?string $datetime = null, ?\DateTimeZone $timezone = null)
+    {
+        $datetime = new \DateTime($datetime ?: 'now', $timezone);
+        parent::__construct($datetime->format('Y-m-d\T00:00:00.000000\Z'), new \DateTimeZone('UTC'));
+    }
+
+    public function __toString(): string
+    {
+        return $this->format(DateTimeInterface::UTC_DATE);
+    }
+}

src/DateInterface.php

@@ -0,0 +1,7 @@
+<?php declare(strict_types=1);
+
+namespace Darsyn\DateTime;
+
+interface DateInterface extends DateTimeInterface
+{
+}

src/DateTime.php

@@ -0,0 +1,57 @@
+<?php declare(strict_types=1);
+
+namespace Darsyn\DateTime;
+
+class DateTime extends \DateTimeImmutable implements DateTimeInterface
+{
+    /** {@inheritdoc} */
+    public function __construct(?string $datetime = null, ?\DateTimeZone $timezone = null)
+    {
+        $datetime = new \DateTime($datetime ?: 'now', $timezone);
+        parent::__construct($datetime->format('Y-m-d\TH:i:s.000000P'), $timezone);
+    }
+
+    /**
+     * {@inheritdoc}
+     * @throws \InvalidArgumentException
+     */
+    public static function createFromFormat($format, $time, ?\DateTimeZone $timezone = null): self
+    {
+        // DateTimeImmutable's createFromFormat() method returns instances of DateTimeImmutable rather than static
+        // (child class), so we'll unfortunately have to replicate some of the constructor logic here.
+        if (!\is_object($datetime = \DateTime::createFromFormat($format, $time, $timezone))) {
+            throw new \InvalidArgumentException('Value not compatible with date format.');
+        }
+        return new static($datetime->format(DateTimeInterface::NO_TIMEZONE), $datetime->getTimezone());
+    }
+
+    /** {@inheritdoc} */
+    public static function createFromMutable($datetime): self
+    {
+        return static::createFromObject($datetime);
+    }
+
+    /** {@inheritdoc} */
+    public static function createFromObject(\DateTimeInterface $datetime): DateTimeInterface
+    {
+        return new static($datetime->format(DateTimeInterface::NO_TIMEZONE), $datetime->getTimezone());
+    }
+
+    /** {@inheritdoc} */
+    public static function createFromTimestamp(int $timestamp): DateTimeInterface
+    {
+        return static::createFromFormat('U', (string) $timestamp);
+    }
+
+    /** {@inheritdoc} */
+    public function jsonSerialize(): string
+    {
+        return $this->__toString();
+    }
+
+    /** {@inheritdoc} */
+    public function __toString(): string
+    {
+        return $this->format(DateTimeInterface::RFC3339);
+    }
+}

src/DateTimeInterface.php

@@ -0,0 +1,27 @@
+<?php declare(strict_types=1);
+
+namespace Darsyn\DateTime;
+
+interface DateTimeInterface extends \DateTimeInterface, \JsonSerializable
+{
+    public const UTC_DATE = 'Y-m-d';
+    public const UTC_DATETIME = 'Y-m-d\TH:i:s\Z';
+    public const NO_TIMEZONE = 'Y-m-d\TH:i:s';
+
+    /**
+     * @param \DateTimeInterface $datetime
+     * @return \Darsyn\DateTime\DateTimeInterface
+     */
+    public static function createFromObject(\DateTimeInterface $datetime): self;
+
+    /**
+     * @param int $timestamp
+     * @return \Darsyn\DateTime\DateTimeInterface
+     */
+    public static function createFromTimestamp(int $timestamp): self;
+
+    /**
+     * @return string
+     */
+    public function __toString(): string;
+}

src/UtcDateTime.php

@@ -0,0 +1,20 @@
+<?php declare(strict_types=1);
+
+namespace Darsyn\DateTime;
+
+class UtcDateTime extends DateTime
+{
+    /** {@inheritdoc} */
+    public function __construct(?string $datetime = null, ?\DateTimeZone $timezone = null)
+    {
+        $datetime = new \DateTime($datetime ?: 'now', $timezone);
+        $datetime->setTimezone($tz = new \DateTimeZone('UTC'));
+        parent::__construct($datetime->format('Y-m-d\TH:i:s.000000\Z'), $tz);
+    }
+
+    /** {@inheritdoc} */
+    public function __toString(): string
+    {
+        return $this->format(DateTimeInterface::UTC_DATETIME);
+    }
+}