How are quarters defined? Where do(es) the extra day(s) go?
On Monday, April 12, 2010, <pugs-comm...@feather.perl6.nl> wrote:
> Author: masak
> Date: 2010-04-12 15:12:54 +0200 (Mon, 12 Apr 2010)
> New Revision: 30370
>
> Modified:
> docs/Perl6/Spec/S32-setting-library/Temporal.pod
> Log:
> [S32/Temporal] replaced underscores with dashes in method names
>
> Also decided to go with 'timezone' rather than 'time_zone' or 'time-zone',
> for a flurry of reasons. Saves a character; looks more like the rest of the
> attributes; looks more like DateTime::TimeZone; emphasizes that it's one
> concept and not two; it was already partly that way by mistake. ;-)
>
> Modified: docs/Perl6/Spec/S32-setting-library/Temporal.pod
> ===================================================================
> --- docs/Perl6/Spec/S32-setting-library/Temporal.pod 2010-04-12 13:00:38
> UTC (rev 30369)
> +++ docs/Perl6/Spec/S32-setting-library/Temporal.pod 2010-04-12 13:12:54
> UTC (rev 30370)
> @@ -59,7 +59,7 @@
> calendar and someone's clock. You can create a C<DateTime> object from
> the C<Instant> returned by the C<time> function:
>
> - my $now = DateTime.from_epoch(time);
> + my $now = DateTime.from-epoch(time);
>
> This is such a common use case, that there's a C<DateTime.now>
> constructor that does this for you:
> @@ -114,30 +114,30 @@
>
> There are methods C<year>, C<month>, C<day>, C<hour>, C<minute>, and
> C<second>, giving you the corresponding values of the C<DateTime>
> -object. The C<day> method also has the synonym C<day_of_month>.
> +object. The C<day> method also has the synonym C<day-of-month>.
>
> The method C<week> returns two values, the I<week year> and I<week number>.
> -(These are also available through the methods C<week_year> and
> C<week_number>,
> +(These are also available through the methods C<week-year> and
> C<week-number>,
> respectively.) The first week of the year is defined by ISO as the one which
> contains the fourth day of January. Thus, dates early in January often end
> up in the last week of the prior year, and similarly, the final few days of
> December may be placed in the first week of the next year.
>
> -There's a C<day_of_week> method, which returns the day of the week as a
> +There's a C<day-of-week> method, which returns the day of the week as a
> number 1..7, with 1 being Monday and 7 being Sunday.
>
> -The C<weekday_of_month> method returns a number 1..5 indicating the
> +The C<weekday-of-month> method returns a number 1..5 indicating the
> number of times a particular weekday has occurred so far during that
> month, the day itself included. For example, June 9, 2003 is the second
> Monday of the month, and so this method returns 2 for that day.
>
> The C<quarter> method returns the quarter of the year, a value between 1
> -and 4. The C<day_of_quarter> method returns the day of the quarter.
> +and 4. The C<day-of-quarter> method returns the day of the quarter.
>
> -The C<day_of_year> method returns the day of the year, a value between 1
> +The C<day-of-year> method returns the day of the year, a value between 1
> and 366.
>
> -The method C<whole_second> returns the second truncated to an integer.
> +The method C<whole-second> returns the second truncated to an integer.
>
> The following methods work as a sort of formatting methods:
>
> @@ -150,7 +150,7 @@
> The single argument of each of those methods is optional, but the above
> shows the defaults: C<'-'> for dates and C<':'> for times.
>
> -The C<time_zone> method returns the C<DateTime::TimeZone> object for the
> +The C<timezone> method returns the C<DateTime::TimeZone> object for the
> C<DateTime> object. The method C<offset> returns the offset from UTC, in
> seconds, of the C<DateTime> object according to the time zone.
>
> @@ -165,7 +165,7 @@
>
> The same methods exists for all the values you can set in the
> constructor: C<year>, C<month>, C<day>, C<hour>, C<minute>, C<second>,
> -C<time_zone> and C<formatter>. Also, there's a C<set> method, which
> +C<timezone> and C<formatter>. Also, there's a C<set> method, which
> accepts all of these as named arguments, allowing several values to be
> set at once:
>
> @@ -175,12 +175,12 @@
> values, and an exception is thrown if the result isn't a sensible date
> and time.
>
> -If you use the C<time_zone> public accessor to adjust the time zone, the
> +If you use the C<timezone> public accessor to adjust the time zone, the
> local time zone is adjusted accordingly:
>
> my $dt = DateTime.new('2005-02-01T15:00:00+0900');
> say $dt.hour; # 15
> - $dt.time_zone = '+0600';
> + $dt.timezone = '+0600';
> say $dt.hour; # 12
>
> The C<truncate> method allows you to "clear" a number of time values
>
>
--
Mark J. Reed <markjr...@gmail.com>
