=encoding utf-8

=head1 名前

Time::Seconds - 他の日付の値を秒に変換する簡単なAPI

=head1 概要

    use Time::Piece;
    use Time::Seconds;
    
    my $t = localtime;
    $t += ONE_DAY;
    
    my $t2 = localtime;
    my $s = $t - $t2;
    
    print "Difference is: ", $s->days, "\n";

=head1 説明

This module is part of the Time::Piece distribution. It allows the user
to find out the number of minutes, hours, days, weeks or years in a given
number of seconds. It is returned by Time::Piece when you delta two
Time::Piece objects.

このモジュールは、Time::Piece ディストリビューションの一部です。
このモジュールは、ユーザが、分、時間、日、週、年の数を、
与えられた秒数に見つけ出すことを可能にします。
2つのTime::Pieceオブジェクトの差異を出すときに、
Time::Piece オブジェクトによって、返されます。

Time::Seconds also exports the following constants:

Time::Seconds はまた、下記の内容をイクスポートします:

    ONE_DAY
    ONE_WEEK
    ONE_HOUR
    ONE_MINUTE
	ONE_MONTH
	ONE_YEAR
	ONE_FINANCIAL_MONTH
    LEAP_YEAR
    NON_LEAP_YEAR

Since perl does not (yet?) support constant objects, these constants are in
seconds only, so you cannot, for example, do this: C<print ONE_WEEK-E<gt>minutes;>

Perlは、(まだ?)定数オブジェクトをサポートしないので、
これらの定数は秒数だけです。
ですので、たとえば、次のようにはできません: C<print ONE_WEEK-E<gt>minutes;>

=head1 メソッド

The following methods are available:

下記のメソッドが使えます:

    my $val = Time::Seconds->new(SECONDS)
    $val->seconds;
    $val->minutes;
    $val->hours;
    $val->days;
    $val->weeks;
	$val->months;
	$val->financial_months; # 30 days
    $val->years;

The methods make the assumption that there are 24 hours in a day, 7 days in
a week, 365.24225 days in a year and 12 months in a year.
(from The Calendar FAQ at http://www.tondering.dk/claus/calendar.html)

メソッドは、一日に24時間、一週に7日、一年に365.24225日、一年に12ヵ月であると想定しています。
(from The Calendar FAQ at http://www.tondering.dk/claus/calendar.html)

=head1 著者

Matt Sergeant, matt@sergeant.org

Tobias Brox, tobiasb@tobiasb.funcom.com

Bal�zs Szab� (dLux), dlux@kapu.hu

=head1 ライセンス

Please see Time::Piece for the license.

=head1 バグ

Currently the methods aren't as efficient as they could be, for reasons of
clarity. This is probably a bad idea.

=head1 翻訳について

翻訳者：加藤敦 (ktat.is@gmail.com)

Perlドキュメント日本語訳 Project にて、
Perlモジュール、ドキュメントの翻訳を行っております。

 http://perldocjp.sourceforge.jp/
 http://sourceforge.jp/projects/perldocjp/
 http://freeml.com/ctrl/html/MLInfoForm/perldocjp@freeml.com
 http://www.perldoc.jp