add millisecond and microsecond methods to duration

docs/docs/duration.md

@@ -136,6 +136,12 @@ you can use the appropriate methods.
 
 >>> it.total_seconds()
 101700084.001234
+
+>>> it.total_milliseconds()
+101700084001.234
+
+>>> it.total_microseconds()
+101700084001234
 ```
 
 Similarly, the `in_xxx()` methods return the total duration in each
@@ -156,6 +162,12 @@ supported unit as a truncated integer.
 
 >>> it.in_seconds()
 101700084
+
+>>> it.in_milliseconds()
+101700084001
+
+>>> it.in_microseconds()
+10170084001234
 ```
 
 It also has a handy `in_words()` method, which determines the duration representation when printed.

pendulum/constants.py

@@ -18,7 +18,9 @@
 SECONDS_PER_MINUTE = 60
 SECONDS_PER_HOUR = MINUTES_PER_HOUR * SECONDS_PER_MINUTE
 SECONDS_PER_DAY = HOURS_PER_DAY * SECONDS_PER_HOUR
+MS_PER_SECOND = 1000
 US_PER_SECOND = 1000000
+US_PER_MS = 1000
 
 # Formats
 ATOM = "YYYY-MM-DDTHH:mm:ssZ"

pendulum/duration.py

@@ -8,7 +8,7 @@
 from pendulum.utils._compat import PYPY
 from pendulum.utils._compat import decode
 
-from .constants import SECONDS_PER_DAY
+from .constants import SECONDS_PER_DAY, US_PER_MS, MS_PER_SECOND
 from .constants import SECONDS_PER_HOUR
 from .constants import SECONDS_PER_MINUTE
 from .constants import US_PER_SECOND
@@ -129,6 +129,12 @@ def total_seconds(self):
                 + self._microseconds
             ) / US_PER_SECOND
 
+    def total_milliseconds(self):
+        return self.total_seconds() * MS_PER_SECOND + self._microseconds / US_PER_MS
+
+    def total_microseconds(self):
+        return self.total_seconds() * US_PER_SECOND + self._microseconds
+
     @property
     def years(self):
         return self._years
@@ -209,6 +215,12 @@ def in_minutes(self):
     def in_seconds(self):
         return int(self.total_seconds())
 
+    def in_milliseconds(self):
+        return int(self.total_milliseconds())
+
+    def in_microseconds(self):
+        return int(self.total_microseconds())
+
     def in_words(self, locale=None, separator=" "):
         """
         Get the current interval in words in the current locale.

tests/duration/test_in_methods.py

@@ -24,3 +24,13 @@ def test_in_minutes():
 def test_in_seconds():
     it = pendulum.duration(seconds=72)
     assert it.in_seconds() == 72
+
+
+def test_in_milliseconds():
+    it = pendulum.duration(milliseconds=1234)
+    assert it.in_milliseconds() == 1234
+
+
+def test_in_microseconds():
+    it = pendulum.duration(microseconds=1234567)
+    assert it.in_microseconds() == 1234567

tests/duration/test_total_methods.py

@@ -24,3 +24,13 @@ def test_in_minutes():
 def test_in_seconds():
     it = pendulum.duration(seconds=72, microseconds=123456)
     assert it.total_seconds() == 72.123456
+
+
+def test_in_milliseconds():
+    it = pendulum.duration(seconds=1, milliseconds=234)
+    assert it.total_milliseconds() == 1234
+
+
+def test_in_microseconds():
+    it = pendulum.duration(seconds=1, milliseconds=234, microseconds=567)
+    assert it.total_microseconds() == 1234567