date::manip::changes6(3) [suse man page]

Date::Manip::Changes6(3)				User Contributed Perl Documentation				  Date::Manip::Changes6(3)

NAME

       Date::Manip::Changes6 - backward incompatible changes in Date::Manip 6.xx

SYNOPSIS

       This describes all backwards incompatible changes made to the Date::Manip module starting at version 6.00.

DESCRIPTION

       For the most part, Date::Manip has remained backward compatible at every release, but occasionally, a change is made which is backward
       incompatible. These are documented here.  Major changes are marked with asterisks.

6.05
       %z format
	   In Date::Manip 5.xx, the %z format in UnixDate printed the offset in the form -0500. In 6.00, I changed that to -05:00:00, but this
	   broke RFC 822 compliance.

	   I've changed %z back to -0500, and introduced a new format (%N) which returns -05:00:00.

	   Incidentally, this is the LAST unused letter, so I am now going to have to either stop adding formats, or add some extended format
	   syntax. Not sure yet which, but this may involve a backwards incompatible change in the future.

BUGS AND QUESTIONS

       Please refer to the Date::Manip::Problems documentation for information on submitting bug reports or questions to the author.

SEE ALSO

       Date::Manip	  - main module documentation

LICENSE

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

AUTHOR

       Sullivan Beck (sbeck@cpan.org)

perl v5.12.1							    2010-01-12						  Date::Manip::Changes6(3)

Date::Manip::TZdata(3)					User Contributed Perl Documentation				    Date::Manip::TZdata(3)

NAME

       Date::Manip::TZdata -- Internal module for working with the tzdata files

SYNOPSIS

	  use Date::Manip::TZdata;

	  $tzd	= new Date::Manip::TZdata($dir);

DESCRIPTION

       This module is not intended for public use. It is used internally by the scripts used to analyze the time zone database and generate the
       modules for each time zone. The module is included in the distribution solely for the sake of completeness. Currently, no support is
       offered for this module, and it can (and may) change without notice.

       This module consists of routines for working with the tzdata files obtained from ftp://elsie.nci.nih.gov/pub/ . These files are updated
       several times a year and are the basis for time zone descriptions for most computer systems.

       At some point, I am interested in making this module a direct interface to the tzdata files, but in the limited amount of time I have to
       work on perl modules, other modifications to Date::Manip are much higher priority, so I'm not sure when (or if) this will ever happen.

ROUTINES

       new
	      use Date::Manip::TZdata;

	      $tzd  = new Date::Manip::TZdata($dir);

	   This finds and reads in all the tzdata. If $dir is passed in, it is the directory where a tzdata directory is located. It defaults to
	   the current directory.

KNOWN LIMITATIONS

       Some assumptions and limitations are assumed in the logic of this module.

       When a time change occurs, the time may change backwards or forwards.  Time changes rules are listed on a per-year basis.  It is assumed
       that time changes will not occur so close to the end or start of the year as to cross the year boundary (in other words, the year will not
       change as a result of the time change).	This is not accounted for, and it is hoped that this situation will never occur.

       Also, because this module is strictly limited to 4 digit positive years (regardless of whether it is wallclock or universal time), and
       because various parts of the module switch back and forth, valid times for this module are from Jan 2, 0001 to Dec 30, 9999. This ensures
       that conversions from wallclock to universal or vice versa will never make dates occur in the year 0000 or 10000.

KNOWN BUGS

       None known.

BUGS AND QUESTIONS

       Please refer to the Date::Manip man page for information on submitting bug reports or questions to the author.

AUTHOR

       Sullivan Beck (sbeck@cpan.org)

perl v5.12.1							    2010-01-12						    Date::Manip::TZdata(3)