Implement DateRangeInterface:getTimestampInterval() method (#18)

* Implement DateRangeInterface:getTimestampInterval() method

* Update CHANGELOG

* Update README

Author: slavcodev

CHANGELOG.md

@@ -18,14 +18,19 @@ Security - in case of vulnerabilities.
 
 _TBD_
 
+## [0.4.0] 2018-02-16
+
+### Added
+- Added new method `getTimestampInterval` to returns duration in seconds ([#18](../../pull/18)).
+
 ## [0.3.0] 2017-11-18
 
 ### Added
-- Added new methods `getInterval`, `getPeriod`, `split`
-- Added `DateRangeProvider` interface and basic provider `FiniteDateRangeProvider`
+- Added `DateRangeProvider` interface and basic provider `FiniteDateRangeProvider` ([#13](../../pull/13)).
+- Added new method `getDateInterval`, `getDatePeriod`, `split` ([#9](../../pull/9)).
 
 ### Changed
-- Rename methods from using `time` ot `date`.
+- Rename methods from using `time` ot `date` ([#11](../../pull/11)).
 - Refactored internals.
 
 ## [0.1.1] 2017-11-17

README.md

@@ -42,6 +42,8 @@ $range->isEnded();
 $range->isStartedOn(new DateTime());
 // Checking if range ended on specific date
 $range->isEndedOn(new DateTime());
+// Accessing range duration in seconds
+$range->getTimestampInterval();
 // Accessing range interval
 $range->getDateInterval()->format('%s');
 // Printing

src/DateRange.php

@@ -190,6 +190,14 @@ public function isEnded(): bool
         return $this->hasEndDate() && $this->state->compareEndDate(new DateTimeImmutable()) < 0;
     }
 
+    /**
+     * {@inheritdoc}
+     */
+    public function getTimestampInterval(): int
+    {
+        return $this->getEndDate()->getTimestamp() - $this->getStartDate()->getTimestamp();
+    }
+
     /**
      * {@inheritdoc}
      */

src/DateRangeInterface.php

@@ -112,6 +112,13 @@ public function isStarted(): bool;
      */
     public function isEnded(): bool;
 
+    /**
+     * Returns the range duration in seconds.
+     *
+     * @return int
+     */
+    public function getTimestampInterval(): int;
+
     /**
      * Returns the range interval.
      *

tests/DateRangeTest.php

@@ -111,6 +111,19 @@ public function dumpRange()
         self::assertNotContains('state', $dump);
     }
 
+    /**
+     * @test
+     */
+    public function getTimestampInterval()
+    {
+        $now = new DateTimeImmutable();
+        $oneHourRange = new DateRange($now, $now->add(new DateInterval('PT1H')));
+        $oneDayRange = new DateRange($now, $now->add(new DateInterval('P1D')));
+
+        self::assertSame(3600, $oneHourRange->getTimestampInterval());
+        self::assertSame(86400, $oneDayRange->getTimestampInterval());
+    }
+
     /**
      * @test
      */