Author: Kodi Date: 2010-07-14 16:02:34 +0200 (Wed, 14 Jul 2010) New Revision: 31678
Modified: docs/Perl6/Spec/S32-setting-library/Temporal.pod Log: [S32/Temporal] DateTime.new(Numeric) -> DateTime.new(Int), since time no longer returns fractional seconds. Modified: docs/Perl6/Spec/S32-setting-library/Temporal.pod =================================================================== --- docs/Perl6/Spec/S32-setting-library/Temporal.pod 2010-07-14 12:50:51 UTC (rev 31677) +++ docs/Perl6/Spec/S32-setting-library/Temporal.pod 2010-07-14 14:02:34 UTC (rev 31678) @@ -15,8 +15,8 @@ Created: 19 Mar 2009 - Last Modified: 12 Jul 2010 - Version: 10 + Last Modified: 14 Jul 2010 + Version: 11 The document is a draft. @@ -57,7 +57,7 @@ =head1 C<time> -Returns the current POSIX time as an Int. Use the C<now> function for an +Returns the current POSIX time as an C<Int>. Use C<now> for an epoch-agnostic measure of atomic seconds (i.e., an C<Instant>). Note that both C<time> and C<now> are not functions, but terms of the pseudo-constant variety; as such they never take an argument. @@ -68,15 +68,14 @@ A C<DateTime> object describes the time as it would appear on someone's calendar and someone's clock. You can create a C<DateTime> object from an -C<Instant> or from any object that does the C<Numeric> role; in the latter -case, the argument is interpreted as POSIX time. +C<Instant> or from an C<Int>; in the latter case, the argument is +interpreted as POSIX time. my $now = DateTime.new(now); - my $now = DateTime.new(time); # same thing (usually) + my $now = DateTime.new(time); -Note that a C<DateTime> based on C<now> can return a C<DateTime> -that cannot be produced using C<time>, since C<time> doesn't know -about leap seconds. +These two statements are equivalent except that C<time> doesn't know about +leap seconds or fractions of seconds. Or you can use named arguments: