v5.2.0

CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+## v5.2.0
+
+### Added
+
+- Add scalars `Date`, `DateTime` and `DateTimeTz`
+
 ## v5.1.0
 
 ### Added

README.md

@@ -18,6 +18,22 @@ A collection of custom scalar types for usage with https://github.com/webonyx/gr
 You can use the provided Scalars just like any other type in your schema definition.
 Check [SchemaUsageTest](tests/SchemaUsageTest.php) for an example.
 
+### [Date](src/Date.php)
+
+A date string with format `Y-m-d`, e.g. `2011-05-23`.
+
+The following conversion applies to all date scalars:
+- Outgoing values can either be valid date strings or `\DateTimeInterface` instances.
+- Incoming values must always be valid date strings and will be converted to `\DateTimeImmutable` instances.
+
+### [DateTime](src/DateTime.php)
+
+A datetime string with format `Y-m-d H:i:s`, e.g. `2018-05-23 13:43:32`.
+
+### [DateTimeTz](src/DateTimeTz.php)
+
+A datetime string with format `Y-m-d\TH:i:s.uP`, e.g. `2020-04-20T16:20:04+04:00`, `2020-04-20T16:20:04Z`.
+
 ### [Email](src/Email.php)
 
 A [RFC 5321](https://tools.ietf.org/html/rfc5321) compliant email.

src/DateTimeTz.php

@@ -5,7 +5,7 @@
 class DateTimeTz extends DateScalar
 {
     public $description /** @lang Markdown */
-        = 'The `DateTime` scalar type represents time data, represented as an ISO-8601 encoded UTC date string.';
+        = 'A datetime string with format `Y-m-d\TH:i:s.uP`, e.g. `2020-04-20T16:20:04.000000+04:00`.';
 
     protected static function outputFormat(): string
     {