Adds a datetime() helper method to the Timezone class

Author: sdispater

docs/_docs/timezones.rst

@@ -215,7 +215,6 @@ when adding and subtracting time around transition times.
     '2013-03-31T03:00:00+02:00'
 
 
-
 .. note::
 
     You can control the normalization behavior:
@@ -233,3 +232,15 @@ when adding and subtracting time around transition times.
         '2013-03-31T02:30:00+01:00'
         tz.convert(dt, dst_rule=tz.TRANSITION_ERROR)
         # NonExistingTime: The datetime 2013-03-31 02:30:00 does not exist.
+
+
+You can also get a normalized ``datetime`` object from a ``Timezone`` by using the ``datetime()`` method:
+
+.. code-block:: python
+
+    import pendulum
+
+    tz = pendulum.timezone('Europe/Paris')
+    dt = tz.datetime(2013, 3, 31, 2, 30)
+    dt.isoformat()
+    '2013-03-31T03:30:00+02:00'

pendulum/tz/timezone.py

@@ -118,6 +118,38 @@ def convert(self, dt, dst_rule=None):
 
         return dt.__class__(*converted[0], **converted[1])
 
+    def datetime(self, year, month, day,
+                 hour=0, minute=0, second=0, microsecond=0):
+        """
+        Creates a new datetime object for the current timezone.
+
+        :param year: The year
+        :type year: int
+
+        :param month: The month
+        :type month: int
+
+        :param day: The day
+        :type day: int
+
+        :param hour: The hour
+        :type hour: int
+
+        :param minute: The minute
+        :type minute: int
+
+        :param second: The second
+        :type second: int
+
+        :param microsecond: The microsecond
+        :type microsecond: int
+
+        :rtype: datetime
+        """
+        dt = datetime(year, month, day, hour, minute, second, microsecond)
+
+        return self.convert(dt, dst_rule=self.POST_TRANSITION)
+
     def _normalize(self, dt, dst_rule=None):
         # if tzinfo is set, something wrong happened
         if dt.tzinfo is not None:

tests/tz_tests/test_timezone.py

@@ -283,3 +283,24 @@ def test_timezone_with_no_transitions(self):
         self.assertEqual(dt.hour, 0)
         self.assertEqual(dt.minute, 0)
         self.assertEqual(dt.second, 0)
+
+    def test_datetime(self):
+        tz = timezone('Europe/Paris')
+
+        dt = tz.datetime(2013, 3, 24, 1, 30)
+        self.assertEqual(2013, dt.year)
+        self.assertEqual(3, dt.month)
+        self.assertEqual(24, dt.day)
+        self.assertEqual(1, dt.hour)
+        self.assertEqual(30, dt.minute)
+        self.assertEqual(0, dt.second)
+        self.assertEqual(0, dt.microsecond)
+
+        dt = tz.datetime(2013, 3, 31, 2, 30)
+        self.assertEqual(2013, dt.year)
+        self.assertEqual(3, dt.month)
+        self.assertEqual(31, dt.day)
+        self.assertEqual(3, dt.hour)
+        self.assertEqual(30, dt.minute)
+        self.assertEqual(0, dt.second)
+        self.assertEqual(0, dt.microsecond)