Now converting timestamps to DateTimeResult objects

build/docs/classes/ExampleBuilder.php

@@ -89,7 +89,9 @@ private function getSimpleValue(array $shape)
             case 'stream':
                 return '<Psr\\Http\\Message\\StreamableInterface>';
             case 'timestamp':
-                return '<integer || string || DateTime>';
+                return $this->isInput
+                    ? '<integer || string || DateTime>'
+                    : '<DateTime>';
             case 'float':
                 return '<float>';
             default:

src/Api/DateTimeResult.php

@@ -0,0 +1,41 @@
+<?php
+namespace Aws\Api;
+
+/**
+ * DateTime overrides that make DateTime work more seamlessly as a string,
+ * with JSON documents, and with JMESPath.
+ */
+class DateTimeResult extends \DateTime implements \JsonSerializable
+{
+    /**
+     * Create a new DateTimeResult from a unix timestamp.
+     *
+     * @param $unixTimestamp
+     *
+     * @return DateTimeResult
+     */
+    public static function fromEpoch($unixTimestamp)
+    {
+        return new self(gmdate('c', $unixTimestamp));
+    }
+
+    /**
+     * Serialize the DateTimeResult as an ISO 8601 date string.
+     *
+     * @return string
+     */
+    public function __toString()
+    {
+        return $this->format('c');
+    }
+
+    /**
+     * Serialize the date as an ISO 8601 date when serializing as JSON.
+     *
+     * @return mixed|string
+     */
+    public function jsonSerialize()
+    {
+        return (string) $this;
+    }
+}

src/Api/Parser/AbstractRestParser.php

@@ -1,6 +1,7 @@
 <?php
 namespace Aws\Api\Parser;
 
+use Aws\Api\DateTimeResult;
 use Aws\Api\Shape;
 use Aws\Api\StructureShape;
 use Aws\Result;
@@ -87,7 +88,22 @@ private function extractHeader(
         ResponseInterface $response,
         &$result
     ) {
-        $result[$name] = $response->getHeaderLine($shape['locationName'] ?: $name);
+        $value = $response->getHeaderLine($shape['locationName'] ?: $name);
+        $type = $shape->getType();
+
+        if ($type === 'blob') {
+            $value = base64_decode($value);
+        } elseif ($type === 'timestamp') {
+            try {
+                $value = new DateTimeResult($value);
+            } catch (\Exception $e) {
+                // If the value cannot be parsed, then do not add it to the
+                // output structure.
+                return;
+            }
+        }
+
+        $result[$name] = $value;
     }
 
     /**

src/Api/Parser/JsonParser.php

@@ -1,6 +1,7 @@
 <?php
 namespace Aws\Api\Parser;
 
+use Aws\Api\DateTimeResult;
 use Aws\Api\Shape;
 
 /**
@@ -37,6 +38,12 @@ public function parse(Shape $shape, $value)
                 }
                 return $target;
 
+            case 'timestamp':
+                // The Unix epoch (or Unix time or POSIX time or Unix
+                // timestamp) is the number of seconds that have elapsed since
+                // January 1, 1970 (midnight UTC/GMT).
+                return DateTimeResult::fromEpoch($value);
+
             case 'blob':
                 return base64_decode($value);
 

src/Api/Parser/XmlParser.php

@@ -1,6 +1,7 @@
 <?php
 namespace Aws\Api\Parser;
 
+use Aws\Api\DateTimeResult;
 use Aws\Api\ListShape;
 use Aws\Api\MapShape;
 use Aws\Api\Shape;
@@ -26,7 +27,8 @@ private function dispatch($shape, \SimpleXMLElement $value)
             'boolean'   => 'parse_boolean',
             'integer'   => 'parse_integer',
             'float'     => 'parse_float',
-            'double'    => 'parse_float'
+            'double'    => 'parse_float',
+            'timestamp' => 'parse_timestamp',
         ];
 
         $type = $shape['type'];
@@ -120,4 +122,9 @@ private function parse_boolean(Shape $shape, $value)
     {
         return $value == 'true' ? true : false;
     }
+
+    private function parse_timestamp(Shape $shape, $value)
+    {
+        return new DateTimeResult($value);
+    }
 }

tests/Api/DateTimeResultTest.php

@@ -0,0 +1,31 @@
+<?php
+namespace Aws\Test\Api;
+
+use Aws\Api\DateTimeResult;
+
+/**
+ * @covers \Aws\Api\DateTimeResult
+ */
+class DateTimeResultTest extends \PHPUnit_Framework_TestCase
+{
+    public function testCreatesFromEpoch()
+    {
+        $t = time();
+        $d = DateTimeResult::fromEpoch($t);
+        $this->assertEquals($t, $d->format('U'));
+    }
+
+    public function testCastToIso8601String()
+    {
+        $t = time();
+        $d = DateTimeResult::fromEpoch($t);
+        $this->assertSame(gmdate('c', $t), (string) $d);
+    }
+
+    public function testJsonSerialzesAsIso8601()
+    {
+        $t = time();
+        $d = DateTimeResult::fromEpoch($t);
+        $this->assertSame('"' . gmdate('c', $t). '"', json_encode($d));
+    }
+}

tests/Api/Parser/ComplianceTest.php

@@ -99,9 +99,8 @@ private function fixTimestamps(&$data, Shape $shape)
                 }
                 break;
             case 'Aws\Api\TimestampShape':
-                if (is_string($data)) {
-                    $data = strtotime($data);
-                }
+                // Format the DateTimeResult as a Unix timestamp.
+                $data = $data->format('U');
                 break;
         }
     }