/ 
Astro-App-Satpass2-0.054
River stage zero No dependents
/ Astro::App::Satpass2::FormatTime::Cldr

NAME

Astro::App::Satpass2::FormatTime::CLDR - Provide common functionality for CLDR-type time formatters.

SYNOPSIS

 package MyTimeFormatter;
 use Astro::App::Satpass2::FormatTime::Cldr;
 use DateTime;
 use DateTime::TimeZone;

 my $gmt = DateTime::TimeZone->new( name => 'UTC' );
 
 sub iso8601 {
     my ( $time ) = @_;
     my $dt = DateTime->from_epoch(
         epoch => $time,
	 time_zone => $gmt, 
     );
     return $dt->format_cldr( ISO_8601_FORMAT );
 }

NOTICE

This package is private to the Astro::App::Satpass2 package. The author reserves the right to revoke it or change it without notice.

DESCRIPTION

This package provides common functionality for CLDR-based time formatters. Since the actual implementation may vary, what we really have here is a repository for common formats. These are implemented as manifest constants (i.e. use constant), but are documented below as methods.

MANIFEST CONSTANTS

This class supports the following manifest constants, which are all exported by default:

DATE_FORMAT

This manifest constant returns a date format designed to produce a numeric date in the format year-month-day. Since this format is intended to be used with CLDR, it is 'yyyy-MM-dd'.

FORMAT_TYPE

This manifest constant returns the type of format expected by the formatter. This class returns 'CLDR'.

ISO_8601_FORMAT

This manifest constant returns a date format designed to produce a date and time in ISO 8601 format, in the Universal/GMT time zone. Since this format is intended to be used with CLDR, it is q{yyyy-MM-dd'T'HHmmss'Z'}.

TIME_FORMAT

This manifest constant returns a date format designed to produce a time in the format hour:minute:second. Since this format is intended to be used with CLDR, it is 'HH:mm:ss'.

SUPPORT

Support is by the author. Please file bug reports at https://rt.cpan.org/Public/Dist/Display.html?Name=Astro-App-Satpass2, https://github.com/trwyant/perl-Astro-App-Satpass2/issues, or in electronic mail to the author.

AUTHOR

Thomas R. Wyant, III wyant at cpan dot org

COPYRIGHT AND LICENSE

Copyright (C) 2010-2024 by Thomas R. Wyant, III

This program is free software; you can redistribute it and/or modify it under the same terms as Perl 5.10.0. For more details, see the full text of the licenses in the directory LICENSES.

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.