view release on metacpan or  search on metacpan

lib/DateTime/Lite/JA.pod  view on Meta::CPAN

=item 通常の処理ではdie()しないこと

L<Module::Generic> / L<Locale::Unicode>のエラー処理方針に従い、C<DateTime::Lite>は通常のエラーパスでC<die()>を呼び出しません。

代わりにL<DateTime::Lite::Exception>オブジェクトを設定し、スカラコンテキストではC<undef>、リストコンテキストでは空リストを返します。

ただし、エラー時にこのモジュールを本当にC<die>させたい場合は、オブジェクト生成時に真の値を持つC<fatal>オプションを渡すことができます。

=back

=head1 DateTimeとの既知の相違点

=over 4

=item バリデーション

C<DateTime>はコンストラクタのバリデーションにL<Specio> / L<Params::ValidationCompiler>を使用します。C<DateTime::Lite>は同等のチェックを手動で行います。エラーメッセージは似ていますが、完全にã...

=item warnings::register の濫用なし

C<DateTime::Lite>はC<warnings::enabled>を一貫して使用し、ユーザー向けの出力にC<warnings::register>の仕組みへ依存しません。

=back

=head1 未実装のメソッド

現時点ではありません。L<DateTime>APIに存在するメソッドで、このモジュールに不足しているものを見つけた場合は、報告してください。

=head1 CONSTRUCTORS

=head2 new

受け付けるパラメータは次のとおりです。

=over 4

=item * C<year>（必須）

=item * C<month>

=item * C<day>

=item * C<hour>

=item * C<minute>

=item * C<second>

=item * C<nanosecond>

=item * C<time_zone>

日時に使用するタイムゾーンです。次の形式を受け付けます。

=over 8

=item * C<Asia/Tokyo>のようなゾーン名文字列、C<+09:00>のような固定オフセット文字列、C<UTC>、C<floating>、またはC<local>。

=item * L<DateTime::Lite::TimeZone>オブジェクト。

=item * キーがそのままL<DateTime::Lite::TimeZone/new>に渡されるハッシュリファレンス。これにより、文字列形式では指定できないオプションを渡せます。たとえば、C<JST>ã‚„C<CET>のようなタイムã...

    time_zone => { name => 'JST', extended => 1 }
    time_zone => { latitude => 35.658558, longitude => 139.745504 }

=back

省略された場合で、C<locale>引数にC<he-IL-u-ca-hebrew-tz-jeruslm>のようなBCP47 C<-u-tz->拡張が含まれているときは、対応するIANAの正規タイムゾーンが自動的に解決されます。どちらも指定されてã...

=item * C<locale>

Unicode CLDR（Common Locale Data Repository）およびBCP47で定義される、有効な任意のロケールです。L<Locale::Unicode>を参照してください。

=item * C<formatter>

=item * C<fatal>

=back

成功時には新しいオブジェクトを返します。失敗時にはL<error|DateTime::Lite::Exception>を設定し、スカラコンテキストではC<undef>、リストコンテキストでは空リストを返します。チェーン呼びå...

=head2 from_day_of_year

    my $dt2 = DateTime::Lite->from_day_of_year(
        year        => 2026,
        day_of_year => 100,
        time_zone   => 'UTC',
        locale      => 'fr-FR',
    );

年と年内通算日（1-366）からオブジェクトを構築します。

成功時には新しいオブジェクトを返します。失敗時にはL<error|DateTime::Lite::Exception>を設定し、スカラコンテキストではC<undef>、リストコンテキストでは空リストを返します。チェーン呼びå...

=head2 from_epoch

    my $dt = DateTime::Lite->from_epoch(
        epoch     => 1775769030,
        time_zone => 'Asia/Tokyo',
        locale    => 'ja-JP',
        formatter => $formatter,
    );

ユニックスエポック値（整数または浮動小数点数）からオブジェクトを構築します。整数でない値は、最も近いマイクロ秒に丸められます。

C<time_zone>、C<locale>、C<formatter>パラメータを受け付けます。

返されるオブジェクトはC<UTC>タイムゾーンになります。

C<time_zone>引数を指定した場合、それはオブジェクトの生成I<後>に適用されます。したがって、渡されたエポック値は常にUTCタイムゾーンの値として設定されます。

例：

    my $dt = DateTime::Lite->from_epoch(
        epoch     => 0,
        time_zone => 'Asia/Tokyo'
    );
    say $dt; # Asia/TokyoはUTCから+09:00のため、1970-01-01T09:00:00を出力します。
    $dt->set_time_zone('UTC');
    say $dt; # 1970-01-01T00:00:00を出力します。