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:
