Author: ruoso Date: 2009-09-09 14:56:27 +0200 (Wed, 09 Sep 2009) New Revision: 28215
Modified: docs/Perl6/Spec/S32-setting-library/Temporal.pod Log: [spec-S32-Temporal] move Duration to the top, making it more generic, while it still delegates to Gregorian::Duration if you use anything different than :tai in the constructor Modified: docs/Perl6/Spec/S32-setting-library/Temporal.pod =================================================================== --- docs/Perl6/Spec/S32-setting-library/Temporal.pod 2009-09-09 12:41:23 UTC (rev 28214) +++ docs/Perl6/Spec/S32-setting-library/Temporal.pod 2009-09-09 12:56:27 UTC (rev 28215) @@ -45,6 +45,27 @@ Returns a TAI epoch value for the current time. +=head2 Duration + +Duration objects describe an amount of time, it's the fundamental type +for time math. The base Duration object is only TAI-seconds aware, but +if you use its constructor with any other parameters it will delegate +to Gregorian::Duration in order to make the most common cases easier. + +The following attribute is declared: + +=over + +=item tai + +Returns the amount of TAI seconds described in this duration. Note +that usually you shouldn't be doing math with the result of .tai for +different datetime and duration objects. The result of .tai might also +be an estimated value for Duration types that depend on an anchor date +(i.e.: 1 month). + +=back + =head2 Calendar Every DateTime needs to follow the rules of a given calendar. The @@ -142,30 +163,6 @@ =back -=head2 Duration - -Duration objects describe an amount of time, it's the fundamental type -for DateTime math. It is also very calendar-dependent, in a way that -only a very fundamental data is seen here. - -The base Duration object is only TAI-seconds aware, but if you use its -constructor with any other parameters it will delegate to -Gregorian::Duration in order to make the most common cases easier. - -The following attribute is declared: - -=over - -=item tai - -Returns the amount of TAI seconds described in this duration. Note -that usually you shouldn't be doing math with the result of .tai for -different datetime and duration objects. The result of .tai might also -be an estimated value for Duration types that depend on an anchor date -(i.e.: 1 month). - -=back - =head2 TimeZone This is the base for the entire time-zone database with the complete