Change to supporting \DateTimeInterface for better handling of immutable source data

Author: tomwalder

src/GDS/Gateway/ProtoBuf.php

@@ -413,7 +413,7 @@ protected function configureObjectValueParamForQuery($obj_val, $mix_value)
             $obj_key_value = $obj_val->mutableKeyValue();
             $this->createMapper()->configureGoogleKey($obj_key_value, $mix_value);
             $this->applyNamespace($obj_key_value);
-        } elseif ($mix_value instanceof \DateTime) {
+        } elseif ($mix_value instanceof \DateTimeInterface) {
             $obj_val->setTimestampMicrosecondsValue($mix_value->format(Mapper::DATETIME_FORMAT_UU));
         } elseif (method_exists($mix_value, '__toString')) {
             $obj_val->setStringValue($mix_value->__toString());

src/GDS/Gateway/RESTv1.php

@@ -428,7 +428,7 @@ protected function configureObjectValueParamForQuery($obj_val, $mix_value)
         if($mix_value instanceof Entity) {
             /** @var Entity $mix_value */
             $obj_val->keyValue = $this->applyPartition((object)['path' => $this->createMapper()->buildKeyPath($mix_value)]);
-        } elseif ($mix_value instanceof \DateTime) {
+        } elseif ($mix_value instanceof \DateTimeInterface) {
             $obj_val->timestampValue = $mix_value->format(\GDS\Mapper\RESTv1::DATETIME_FORMAT);
         } elseif (method_exists($mix_value, '__toString')) {
             $obj_val->stringValue = $mix_value->__toString();

src/GDS/Mapper.php

@@ -85,7 +85,7 @@ protected function determineDynamicType($mix_value)
                 break;
 
             case 'object':
-                if($mix_value instanceof \DateTime) {
+                if($mix_value instanceof \DateTimeInterface) {
                     $int_dynamic_type = Schema::PROPERTY_DATETIME;
                     break;
                 }

src/GDS/Mapper/ProtoBuf.php

@@ -210,10 +210,10 @@ private function configureGooglePropertyValue(Value $obj_val, array $arr_field_d
                 break;
 
             case Schema::PROPERTY_DATETIME:
-                if($mix_value instanceof \DateTime) {
+                if($mix_value instanceof \DateTimeInterface) {
                     $obj_dtm = $mix_value;
                 } else {
-                    $obj_dtm = new \DateTime($mix_value);
+                    $obj_dtm = new \DateTimeImmutable($mix_value);
                 }
                 $obj_val->setTimestampMicrosecondsValue($obj_dtm->format(self::DATETIME_FORMAT_UU));
                 break;

src/GDS/Mapper/RESTv1.php

@@ -393,10 +393,10 @@ protected function createPropertyValue(array $arr_field_def, $mix_value)
                 break;
 
             case Schema::PROPERTY_DATETIME:
-                if($mix_value instanceof \DateTime) {
+                if($mix_value instanceof \DateTimeInterface) {
                     $obj_dtm = $mix_value;
                 } else {
-                    $obj_dtm = new \DateTime($mix_value);
+                    $obj_dtm = new \DateTimeImmutable($mix_value);
                 }
                 // A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".
                 $obj_property_value->timestampValue = $obj_dtm->format(self::DATETIME_FORMAT);