View on
MetaCPAN
search.cpan.org is shutting down
For details read Perl NOC. After June 25th this page will redirect to MetaCPAN.org
Olivier Mengué > DateTime-TimeZone-HPUX > DateTime::TimeZone::HPUX

Download:
DateTime-TimeZone-HPUX-1.04.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  1
View/Report Bugs
Module Version: 1.04   Source  

NAME ^

DateTime::TimeZone::HPUX - Handles timezones defined at the operating system level on HP-UX

VERSION ^

Version 1.04

SYNOPSIS ^

On an HP-UX system ($^O eq 'hpux'):

    my $tz =       DateTime::TimeZone->new(name => 'local');

    my $tz_paris = DateTime::TimeZone::HPUX->new(name => 'MET-1METDST');

DESCRIPTION ^

This distribution implement detection of the local timezone as defined at the operating system level, either in $ENV{TZ} or in /etc/TIMEZONE.

HP-UX has its own system for defining timezones. See tztab(4). This is incompatible with the now common set of timezones known as the Olson DB that is used by DateTime::TimeZone. This module fixes this hole by providing the map between the two systems.

METHODS ^

new(name => $hpux_style_time_zone)

DateTime::TimeZone factory. Throws an exception if the timezone name could not be resolved.

IMPLEMENTATION ^

We are using the mapping provided by HP embedded in the Java Runtime Environment:

We are using the JRE at the module build time to generate a static Perl package DateTime::TimeZone::HPUX::Map that contains a map of the known timezones defined system wide (/usr/lib/tztab) to Olson DB style timezone names that are known to Java and DateTime::TimeZone.

This extraction is done once for all at install time because JVM startup is SLOOOOOW...

CAVEAT ^

SEE ALSO ^

BUGS ^

No known bug at the time of release. The module has an extensive test suite.

Please report any bugs or feature requests to bug-datetime-timezone-hpux at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=DateTime-TimeZone-HPUX. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

However, note that I, Olivier Mengué, will not have access to an HP-UX system past November 30th, 2009. So do not expect any fixes unless you can provide patches yourself.

SUPPORT ^

You can find documentation for this module with the perldoc command.

    perldoc DateTime::TimeZone::HPUX

You can also look for information at:

AUTHOR ^

Olivier Mengué, <dolmen at cpan.org>

COPYRIGHT & LICENSE ^

Copyright 2009 Olivier Mengué.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl 5.10.0 itself.

syntax highlighting: