Document missing DateTime methods.

also correct some signatures, and remove from WANTED file

Author: moritz

WANTED

@@ -15,7 +15,6 @@ Tutorials:
     * Exceptions
 
 API docs:
-    * DateTime
     * MOP
     * Scheduler
     * Thread

lib/Type/DateTime.pod

@@ -71,45 +71,106 @@ Note that this can lead to invalid dates in some circumstances:
 
 =head2 method hour
 
-    method hour(DateTime:D) returns Int:D
+    method hour(DateTime:D:) returns Int:D
 
 Returns the hour component.
 
     say DateTime.new('2012-02-29T12:34:56Z').hour;      # 12
 
 =head2 method minute
 
-    method minute(DateTime:D) returns Int:D
+    method minute(DateTime:D:) returns Int:D
 
 Returns the minute component.
 
     say DateTime.new('2012-02-29T12:34:56Z').minute;     # 34
 
 =head2 method second
 
-    method second(DateTime:D)
+    method second(DateTime:D:)
 
 Returns the second component, including potentially fractional seconds.
 
     say DateTime.new('2012-02-29T12:34:56Z').second;     # 56
 
+=head2 method whole-second
+
+    method whole-second(DateTime:D:)
+
+Returns the second component, rounded down to an L<Int|/type/Int>.
+
+    say DateTime.new('2012-02-29T12:34:56Z').whole-second;      # 56
+
+=head2 method timezone
+
+    method timezone(DateTime:D:) returns Int:D
+
+Returns the time zone in seconds as an offset from UTC.
+
+    say DateTime.new('2015-12-24T12:23:00+0200').timezone;      # 7200
+
+=head2 method offset
+
+    method offset(DateTime:D:) returns Int:D
+
+Returns the time zone in seconds as an offset from UTC. This is an alias for
+L<#method timezone>.
+
+    say DateTime.new('2015-12-24T12:23:00+0200').offset;        # 7200
+
+=head2 method offset-in-minutes
+
+    method offset-in-minutes(DateTime:D:) returns Real:D
+
+Returns the time zone in minutes as an offset from UTC.
+
+    say DateTime.new('2015-12-24T12:23:00+0200').offset-in-minutes;
+            # 120
+
+=head2 method offset-in-hours
+
+    method offset-in-hours(DateTime:D:) returns Real:D
+
+Returns the time zone in hours as an offset from UTC.
+
+    say DateTime.new('2015-12-24T12:23:00+0200').offset-in-hours;
+            # 2
+
+=head2 method formatter
+
+    method formatter(DateTime:D:)
+
+Returns the formatting function which is used for conversion to
+L<Str|/type/Str>. If none was provided at object construction, a
+default formatter is used which produces an ISO 8601 timestamp.
+
+The formatting function is called by L<#method Str> with the invocant as its
+ownly argument.
+
+=head2 method Str
+
+    method Str(DateTime:D:) returns Str:D
+
+Returns a string representation of the invocant, as done by
+L<the formatter|#method formatter>.
+
 =head2 method Instant
 
-    method Instant() returns Instant:D
+    method Instant(DateTime:D:) returns Instant:D
 
 Returns an L<Instant|/type/Instant> object based on the invocant.
 
 =head2 method posix
 
-    method posix($ignore-timezone = False) returns Int:D
+    method posix(DateTime:D: $ignore-timezone = False) returns Int:D
 
 Returns the date and time as a POSIX/UNIX timestamp.
 
     say DateTime.new('2015-12-24T12:23:00Z').posix;     # 1450959780
 
 =head2 method later
 
-    method later(*%unit)
+    method later(DateTime:D: *%unit)
 
 Returns a DateTime object based on the current one, but with a time delta
 applied. The time delta can be passed as a named argument where the argument
@@ -134,14 +195,14 @@ that.
 
 =head2 method earlier
 
-    method earlier(*%unit)
+    method earlier(DateTime:D: *%unit)
 
 Returns a DateTime object based on the current one, but with a time delta
 towards the past applied. See L<#method later> for usage.
 
 =head2 method truncated-to
 
-    method truncated-to(Cool $unit)
+    method truncated-to(DateTime:D: Cool $unit)
 
 Returns a copy of the invocant, with everything smaller than the specified
 unit truncated to the smallest possible value.
@@ -158,31 +219,36 @@ C<.truncated-to('second')>.
 
 =head2 method Date
 
-    method Date() returns Date:D
+    method Date(DateTime:D:) returns Date:D
 
-Returns a L<Date|/type/Date> object for this datetime object.
+Returns a L<Date|/type/Date> object for this datetime object. Which obviously
+lacks the time component.
 
 =head2 method utc
 
-    method utc() returns DateTime:D
+    method utc(DateTime:D:) 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
+    method in-timezone(DateTime:D: $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
+=head2 method local
 
-TODO: offset, offset-in-minutes, offset-in-hours, whole-second, local, Str
+    method local(DateTime:D:) returns DateTime:D
 
-=end comment
+Returns a DateTime object for the same time, but in the local time zone
+(C<$*TZ>).
 
+    my $*TZ = -3600;
+    say DateTime.new('2015-12-24T12:23:00+0200').local;
+            # 2015-12-24T09:23:00-0100
 =end pod