DateTime: some timezone related methods

Author: moritz

lib/Type/DateTime.pod

@@ -15,7 +15,8 @@ It provides methods for calculating with date and time.
 C<DateTime> methods are immutable; if you are tempted to modify one, create a
 modified copy instead.
 
-Time zones are handled as L<Integers|/type/Int> in B<seconds> offset from UTC.
+Time zones are handled as L<Integers|/type/Int> in B<seconds> offset from UTC,
+not by time zone name.
 
 =head1 Methods
 
@@ -161,10 +162,26 @@ C<.truncated-to('second')>.
 
 Returns a L<Date|/type/Date> object for this datetime object.
 
+=head2 method utc
+
+    method utc() returns DateTime:D
+
+Returns a DateTime object for the same time, but in time zone UTC.
+
+    say DateTime.new('2015-12-24T12:23:00+0200').utc";  # 2015-12-24T10:23:00Z
+
+=head2 method in-timezone
+
+    method in-timezone($timezone = 0) returns DateTime:D
+
+Returns a DateTime object for the same time, but in the specified time zone.
+
+    say DateTime.new('2015-12-24T12:23:00Z').in-timezone(3600 + 1800);
+        # 2015-12-24T13:53:00+0130
+
 =begin comment
 
-TODO: offset, offset-in-minutes, offset-in-hours, whole-second, in-timezone,
-    utc, local, Str
+TODO: offset, offset-in-minutes, offset-in-hours, whole-second, local, Str
 
 =end comment