.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Date::Manip::Changes6 3pm"
.TH Date::Manip::Changes6 3pm 2024-03-02 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Date::Manip::Changes6 \- changes in Date::Manip 6.xx
.SH SYNOPSIS
.IX Header "SYNOPSIS"
This describes the changes made to the Date::Manip module in the 6.xx
series of releases.  Major changes are marked with asterisks (*).
.PP
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 marked with an exclamation mark (!).
.PP
#=head1 VERSION 7.00 (expected 2025\-03\-01)
#    Remove DM5
#    Remove TZ variable
#    Remove Jan1Week1 variable
#=head1 VERSION 6.99 (expected )
#=head1 VERSION 6.98 (expected 2024\-12\-01)
#=head1 VERSION 6.97 (expected 2024\-09\-01)
#=head1 VERSION 6.96 (expected 2024\-06\-01)
.SH "VERSION 6.95 (expected 2024\-03\-01)"
.IX Header "VERSION 6.95 (expected 2024-03-01)"
.IP "Better support for weeks of the year" 5
.IX Item "Better support for weeks of the year"
Added the Week1ofYear config variable and deprecated the Jan1Week1 variable.
The first week of the year can now be specified much more easily.
.IP "Support for the standard POSIX strftime directives in printf" 5
.IX Item "Support for the standard POSIX strftime directives in printf"
The Date::Manip::Date::printf method uses a set of directives which is
similar, but not identical, to the POSIX strftime directives.
.Sp
A new config variable Use_POSIX_Printf has been added.  If set, the
printf method will use the POSIX strftime directives more fully (see
the PRINTF DIRECTIVES section in the Date::Manip::Date POD for more
information).
.Sp
Reported in GitHub #48
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2024a).
.SH "VERSION 6.94 (2024\-01\-09)"
.IX Header "VERSION 6.94 (2024-01-09)"
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
The 6.93 release didn't include the windows timezone aliases from GitHub #46.
Pointed out by Mike Capella.
.Sp
Newest zoneinfo data (tzdata 2023d).
.IP "Documentation fixes" 5
.IX Item "Documentation fixes"
Fixed a grammatical issue.  GitHub #49
.SH "VERSION 6.93 (2023\-12\-01)"
.IX Header "VERSION 6.93 (2023-12-01)"
.IP "Bug fixes" 5
.IX Item "Bug fixes"
Bug where Date::Manip::TZ::convert wasn't returning an error code if an
invalid date was passed in.  GitHub #47.
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
Updated the windows timezone aliases.  They were out-of-date.
See GitHub #46.
.IP "Test fixes" 5
.IX Item "Test fixes"
In the test scripts, changed RELEASE_TESTING variable.  Now use a
release-specific testing variable rather than RELEASE_TESTING.
See GitHub #17 in my Locale-Codes module for details.
.SH "VERSION 6.92 (2023\-06\-07)"
.IX Header "VERSION 6.92 (2023-06-07)"
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2023c).
.IP "Documentation fixes" 5
.IX Item "Documentation fixes"
Typo fix.  Reported by Derek Terveer
.SH "VERSION 6.91 (2023\-03\-01)"
.IX Header "VERSION 6.91 (2023-03-01)"
.IP "Fixed bug where timezone alias wasn't handled" 5
.IX Item "Fixed bug where timezone alias wasn't handled"
On linux systems configured to be in a timezone that is an alias, the
system timezone wasn't recognized, and it defaulted to GMT.  This is
now fixed.  Patch supplied by Sandi Wallendahl (GitHub #43)
.SH "VERSION 6.90 (2022\-12\-02)"
.IX Header "VERSION 6.90 (2022-12-02)"
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
Aliases in the tzdata database were not being added to the timezone
data.  Reported in GitHub issue #40.
.Sp
The UTC timezone is now named Etc/UTC instead of UTC to be in line
with the aliases.
.Sp
Newest zoneinfo data (tzdata 2022g).
.IP "Language fixes" 5
.IX Item "Language fixes"
Additions to the Polish translation.  GitHub issue #41.
.Sp
Additions to several languages.  GitHub issue #42.
.Sp
Added some support for per-language parsing rules to respond to GitHub issue #42.
.IP "Documentation fixes" 5
.IX Item "Documentation fixes"
The version numbers in the change log was messed up due to a skipped release (no
new timezone fixes that time).  Fixed.
.SH "VERSION 6.89 (2022\-09\-01)"
.IX Header "VERSION 6.89 (2022-09-01)"
.IP "(!) Date::Manip 5.xx interface to be removed" 5
.IX Item "(!) Date::Manip 5.xx interface to be removed"
The old version of Date::Manip (version 5.xx) has been distributed as part
of the package in order to support versions of perl older than 5.10 .  I see
no valid reason to continue to support that, so as of version 7.00, Date::Manip
will only include the newer interfaces (which require perl 5.10 or newer).
There are no plans to deprecate the functional interface.
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2022c).
.SH "VERSION 6.88 (2022\-06\-02)"
.IX Header "VERSION 6.88 (2022-06-02)"
.IP "Packaging problem." 5
.IX Item "Packaging problem."
I generated a broken MANIFEST file in the previous release.  Reported 
in GitHub issue #39.
.SH "VERSION 6.87 (2022\-06\-01)"
.IX Header "VERSION 6.87 (2022-06-01)"
.IP "Bug fixes" 5
.IX Item "Bug fixes"
The package was being generated with an incorrect MANIFEST file.  This is now
fixed.  RT 140075
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
There were no new timezone fixes on 2022\-03\-01, so no
release made then.
.Sp
Newest zoneinfo data (tzdata 2022a).
.SH "VERSION 6.86 (2021\-11\-15)"
.IX Header "VERSION 6.86 (2021-11-15)"
.IP "Change warn to carp" 5
.IX Item "Change warn to carp"
All warnings are now issued with the carp command rather than warn.  Requested
in GitHub pull request #18, but that request was not used because it only
changed the uses in the Date::Manip::Date module.
.IP "Bug fixes" 5
.IX Item "Bug fixes"
Fixed a bug where the next/prev Date::Manip::Recur methods gave incorrect
results when there are no dates that match the criteria.  (GitHub #36)
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
There were no new timezone fixes on 2021\-06\-01 or 2021\-09\-01, so no
releases made then.
.Sp
Newest zoneinfo data (tzdata 2021e).  (GitHub #37)
.SH "VERSION 6.85 (2021\-03\-01)"
.IX Header "VERSION 6.85 (2021-03-01)"
.IP "Test fixes" 5
.IX Item "Test fixes"
Missed some tests that were failing.
.SH "VERSION 6.84 (2021\-03\-01)"
.IX Header "VERSION 6.84 (2021-03-01)"
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2021a).
.IP "Language fixes" 5
.IX Item "Language fixes"
Corrections and additions to Italian.  Patch supplied by Leo Cacciari (GitHub #33)
.SH "VERSION 6.83 (2020\-12\-01)"
.IX Header "VERSION 6.83 (2020-12-01)"
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
No new zoneinfo data so no release on 2020\-09\-01.
.Sp
Newest zoneinfo data (tzdata 2020d).  Requested by Shawn Carroll (GitHub #32)
.SH "VERSION 6.82 (2020\-06\-01)"
.IX Header "VERSION 6.82 (2020-06-01)"
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2020a).
.SH "VERSION 6.81 (2020\-03\-01)"
.IX Header "VERSION 6.81 (2020-03-01)"
.IP "Messed up the 6.80 package.  This release fixes it." 5
.IX Item "Messed up the 6.80 package. This release fixes it."
.SH "VERSION 6.80 (2020\-03\-01)"
.IX Header "VERSION 6.80 (2020-03-01)"
.PD 0
.IP "Missed Changes entry for previous version." 5
.IX Item "Missed Changes entry for previous version."
.PD
Reported by Tina Muller (GitHub #31)
.SH "VERSION 6.79 (2019\-12\-01)"
.IX Header "VERSION 6.79 (2019-12-01)"
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2019c).
.SH "VERSION 6.78 (2019\-08\-29)"
.IX Header "VERSION 6.78 (2019-08-29)"
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2019b).
.IP "Documentation fixes" 5
.IX Item "Documentation fixes"
Fixed a broken link.  Mohammad S Anwar (GitHub #29)
.SH "VERSION 6.77 (2019\-06\-01)"
.IX Header "VERSION 6.77 (2019-06-01)"
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2019a).
.SH "VERSION 6.76 (2019\-03\-01)"
.IX Header "VERSION 6.76 (2019-03-01)"
.IP "Fixed bug in Date::Manip::Date::list_holidays." 4
.IX Item "Fixed bug in Date::Manip::Date::list_holidays."
It was using 'now' instead of the stored date.  Douglas DeStafeno
.IP "Reordered TZ detection methods" 4
.IX Item "Reordered TZ detection methods"
Moved checking the tzdata files to lower priority to avoid a pretty
unusual situation in docker.  Sven Nierlein (GitHub #20)
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2018i).  Requested by Shawn C Carroll (GitHub #28)
.SH "VERSION 6.75 (2018\-12\-03)"
.IX Header "VERSION 6.75 (2018-12-03)"
.IP "Fixed packaging problems" 4
.IX Item "Fixed packaging problems"
Version 6.74 was not packaged correctly.  Version wasn't set correctly in a few files
and there were invalid entries in Makefile.PL.  RT 127870.
.SH "VERSION 6.74 (2018\-12\-01)"
.IX Header "VERSION 6.74 (2018-12-01)"
.IP "Removed travis file from the tarball" 4
.IX Item "Removed travis file from the tarball"
The tarball had a .travis.yml file in it that wasn't in the MANIFEST file.
Since the MANIFEST file is automatically generated by the perl mkmanifest
tool, since it didn't see the .travis.yml file, I have excluded it from the
tarball.  Reported by Mohammad S Anwar on GitHub (#23)
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2018e)
.SH "VERSION 6.73 (2018\-09\-01)"
.IX Header "VERSION 6.73 (2018-09-01)"
.IP "Fixed math on non\-64\-bit architectures" 4
.IX Item "Fixed math on non-64-bit architectures"
Much of the math in Date::Manip::Base is in a 'use integer' section.  This math
can overflow in some cases in non\-64\-bit architectures.  Fixed the cases where
this would reasonably occur.  Reported by Daniel Albers (GitHub #22).  Also
reported and tested in RT 126052.
.IP "Bug in normalizing estimated business deltas" 4
.IX Item "Bug in normalizing estimated business deltas"
While working on the non\-64\-bit issue, it uncovered a bug where normalizing
estimated business deltas was wrong.  It had never been reported, and it was
only off by a couple seconds in some rare situations.
.SH "VERSION 6.72 (2018\-06\-06)"
.IX Header "VERSION 6.72 (2018-06-06)"
.IP "Fixed recurrence bug" 4
.IX Item "Fixed recurrence bug"
The fix in the previous version for a rare recurrence problem broke
another recurrence form.  It is now corrected.  Michael Schout
(GitHub #20)
.IP "Fixed version problem" 4
.IX Item "Fixed version problem"
The wrong version was included in two files for some reason.  This
is fixed.
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Fixed a grammatical error reported by Xavier Guimard (GitHub #19).
.SH "VERSION 6.71 (2018\-06\-01)"
.IX Header "VERSION 6.71 (2018-06-01)"
.IP "Fixed an extremely rare problem with recurrences" 4
.IX Item "Fixed an extremely rare problem with recurrences"
It is possible to specify a recurrence that never produces a valid
date.  In these cases, looking for dates went into an infinite loop.
The MaxRecurAttempts config variable was added which will stop that
from happening.  If no occurrence was found, an error condition will
be set.  Dean Hamstead (RT 123708)
.IP "Changes file supported" 4
.IX Item "Changes file supported"
It was requested that I include a valid Changes file.  I wrote a
simple script to convert the Change6.pod file into a valid Change
file.  The Changes6.pod file is still the canonical source of this
information!  Requested by H. Merijn Brand
.IP "Fix for timezone determination" 4
.IX Item "Fix for timezone determination"
On MacOS X High Sierra, some of the timezone files were symlinks,
but not properly followed.  This was fixed by Stu Tomlinson (GitHub #15).
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2018e)
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Minor fix provided by Mohammad S Anwar (GitHub #17)
.SH "VERSION 6.70 (2018\-03\-01)"
.IX Header "VERSION 6.70 (2018-03-01)"
.IP "\fB(*) (!) Changes to deltas\fR" 4
.IX Item "(*) (!) Changes to deltas"
Improved handling of deltas to better support the different types of
deltas.  Formalized how the semi-exact portions of the delta are used
to produce the results that most people would expect.
.Sp
The type can now be specified to guarantee several behaviors.
Changed the arguments (in a backward compatible way) to several
methods.  Explicitly added a new type (estimated) which was there
previously, but could not be manually specified.
.Sp
The convert function continues to support converting from a less exact
type to a more exact type, but this is deprecated and will be removed in
version 7.00.
.Sp
This was prompted by a bug reported by Ian Gibbs.
.IP "\fB(*) (!) Deprecated some parts of Date::Manip::Delta\fR" 4
.IX Item "(*) (!) Deprecated some parts of Date::Manip::Delta"
The options passed to the \fBset\fR and \fBparse\fR methods have changed.  The
old style will be removed in version 7.00.
.Sp
Deltas will also no longer support the 'exact' and 'approximate' strings
(which have not been supported for some time).  These will be removed
in 7.00 as well.
.IP "Deprecation of TZ postponed" 4
.IX Item "Deprecation of TZ postponed"
The deprecation of the TZ variable has been postponed to version 7.00.
.IP "Some speed improvements" 4
.IX Item "Some speed improvements"
I converted some of the functions to use faster algorithms.  Previously, the
steps were worked out using logical time/calendar based calculations.  These
were replaced with non-intuitive numerical calculations that gave the same
result faster.
.IP "Changed behavior if timezone not determined" 4
.IX Item "Changed behavior if timezone not determined"
If the system timezone cannot be determined using any of the methods
supplied by Date::Manip, operations will be done in the GMT timezone.
Previously, Date::Manip would simply fail to load.  Based on a report by
Kent Fredric (RT 123229).
.IP "Fixed Makefile.PL" 4
.IX Item "Fixed Makefile.PL"
The list of what what is provided did not include the path to the file
providing each module.  I've fixed the Makefile.PL as well as the META
files.  Graham Knop (GitHub #13)
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2018c)
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Rewrote Date::Manip::Delta page to reflect changes, and clean up the
documentation in general.
.SH "VERSION 6.60 (2017\-09\-01)"
.IX Header "VERSION 6.60 (2017-09-01)"
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug where if a recurrence had no interval, start and end dates passed
in to the dates method would not work.  PJ-DSI-DevOps (GitHub #12).
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Clarified Date::Manip::TZ::all_periods.  Based on discussion with
Peter Pfannenschmid.
.SH "VERSION 6.59 (2017\-06\-01)"
.IX Header "VERSION 6.59 (2017-06-01)"
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2017b)
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Improved some of the documentation.
.SH "VERSION 6.58 (2017\-03\-01)"
.IX Header "VERSION 6.58 (2017-03-01)"
.ie n .IP "Better support for $mode in DateCalc." 4
.el .IP "Better support for \f(CW$mode\fR in DateCalc." 4
.IX Item "Better support for $mode in DateCalc."
DateCalc (in DM6) did not support all values for \f(CW$mode\fR.  Now it does.
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Parsing a date like 01/02/2016 and calling printf with \f(CW%e\fR gave '02' instead
of ' 2'.  Robert Wohlfarth (RT 119787).
.Sp
Fixed a problem where the tzdata method of determining the timezone was
producing an error which wasn't correct.  John (GitHub #8)
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2017a)
.SH "VERSION 6.57 (2016\-12\-01)"
.IX Header "VERSION 6.57 (2016-12-01)"
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2016j)
.IP "Test fixes" 4
.IX Item "Test fixes"
A faulty test was failing in a few places.  RT 118705
.Sp
Another test was failing due to a perl bug that popped up in 5.25.7.  Tweaked
the test to bypass the bug.  Kent Fredric (RT 118862)
.SH "VERSION 6.56 (2016\-09\-09)"
.IX Header "VERSION 6.56 (2016-09-09)"
.IP "Test fixes" 4
.IX Item "Test fixes"
A faulty test was failing most places.  New release to correct that problem.
Slaven Rezic (RT 117404)
.SH "VERSION 6.55 (2016\-09\-01)"
.IX Header "VERSION 6.55 (2016-09-01)"
.ie n .IP "Fixed bug where $::TZ wasn't used" 4
.el .IP "Fixed bug where \f(CW$::TZ\fR wasn't used" 4
.IX Item "Fixed bug where $::TZ wasn't used"
The \f(CW$::TZ\fR variable was not getting interpreted correctly when searching
for a timezone.  Steven Hartland (RT 114949)
.IP "Fixed bug where recurrences were not parsed correctly" 4
.IX Item "Fixed bug where recurrences were not parsed correctly"
Passing in incorrect values for a field was not trapped in all cases
and it led to problems.  All values passed in to a recurrence are now
correctly checked.  Albert Hilazo (GitHub #7).
.IP "Fixed a bug in some methods of creating new objects" 4
.IX Item "Fixed a bug in some methods of creating new objects"
Some methods of creating new objects based on existing objects did not
correctly use the existing object.  Bug has never been reported, but was
discovered when adding tests to get 100% coverage.
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2016f)
.IP "Test fixes" 4
.IX Item "Test fixes"
Added a number of new tests based on Devel::Cover.
.SH "VERSION 6.54 (2016\-05\-31)"
.IX Header "VERSION 6.54 (2016-05-31)"
.IP "Deprecation of Date::Manip 5.xx tests" 4
.IX Item "Deprecation of Date::Manip 5.xx tests"
By default, the Date::Manip 5.xx tests will no longer run.  Changes to
the timezone data can cause failures.  Since Date::Manip 5.xx is no longer
supported in any way, these tests will no longer run on a system where
6.xx can be run.  Richard Jelinek.
.IP "Deprecation of TZ postponed" 4
.IX Item "Deprecation of TZ postponed"
The deprecation of the TZ variable has been postponed to March 2017.  I
decided that 1 year was not enough notice (especially since not everyone
will have updated Date::Manip since March 2015 when the warning was added.
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Changed requirement for ExtUtils::MakeMaker to 6.67_01.  Quin Arnold (RT 112286)
.Sp
Fixed a bug where a timezone abbreviation was not parsed correctly when
passed in as a value to the SetDate, ForceDate, or TZ config variables.
Based on a report in perlmonks.org.
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2016d)
.Sp
Made some improvements to how I handled the timezone data which resulted
in a few of the default timezones being changed.
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Fixed one more typo.  Gregor Herrmann (RT 114095)
.Sp
Clarified the Config document.  Based on a report in perlmonks.org.
.SH "VERSION 6.53 (2016\-03\-02)"
.IX Header "VERSION 6.53 (2016-03-02)"
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Date::Manip::Delta::cmp had a bug in it's comparison.  Ian Gibbs.
.Sp
The secs_since_1970_GMT method was missing a test to see if it was
a valid object.  Michael Stevens (RT 111915)
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2016a)
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Lots of typos fixed.  I was using podspell to do spell checking, but it was
discarding too much real text (which wasn't getting checked as a result).
Switched to pod2text which does a better job.  Gregor Herrmann (RT 110025)
.SH "VERSION 6.52 (2015\-12\-01)"
.IX Header "VERSION 6.52 (2015-12-01)"
.IP "\fBAdded date ranges on unmodified dates in Recur\fR" 4
.IX Item "Added date ranges on unmodified dates in Recur"
The date range can now be specified for either the fully modified dates, or
the unmodified dates.  This will make it easier to work with holidays in some
instances.  Based on <http://perlmonks.org/?node_id=1148735>.
.IP "\fBAdded IWn and NWn recurrence modifiers\fR" 4
.IX Item "Added IWn and NWn recurrence modifiers"
Based on <http://perlmonks.org/?node_id=1148735>.
.IP "\fB(!) Reworked holidays slightly\fR" 4
.IX Item "(!) Reworked holidays slightly"
Previously, every line in the Holidays section defined a unique holiday.
Now, the names determine the list of holidays.
.Sp
It is not allowed to have two separate holidays named exactly the same.
It IS allowed to have complex holidays that require two (or more) lines
in the Holidays section to define them completely.
.Sp
Based on <http://perlmonks.org/?node_id=1148735>.
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug where the RecurRange config variable wasn't getting used.
.Sp
Fixed a bug where some deltas were not parsed correctly as dates.
Salvatore Bonaccorso (RT 109600)
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2015g)
.IP "Test fixes" 4
.IX Item "Test fixes"
Added a number of new tests based on Devel::Cover.
.SH "VERSION 6.51 (2015\-09\-01)"
.IX Header "VERSION 6.51 (2015-09-01)"
.IP "Changes suggested by perlcritic" 4
.IX Item "Changes suggested by perlcritic"
Played with perlcritic and made a few minor changes based on it's suggestions.
I doubt I will use perlcritic significantly.
.IP "\fB(!) Date::Manip::Delta::value now returns an empty string\fR" 4
.IX Item "(!) Date::Manip::Delta::value now returns an empty string"
If a delta has an error, or no valid delta in it, the value method returns
an empty string instead of undef.  This is to be consistent with the
Date::Manip::Date::value method which returns an empty string.
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug where date/delta calculations with deltas that are too
large was not working correctly.  They now set an error condition
and fail.  Jared Selengut (RT 105737)
.Sp
Fixed a bug introduced by the previous patch and luckily discovered
pre-release by Tom Wyant.
.Sp
Fixed code that produced a warning in 5.22.0.  Tom Wyant
.IP "Improved DM6 ParseDate and ParseDateString" 4
.IX Item "Improved DM6 ParseDate and ParseDateString"
Added \f(CW@opts\fR argument.  Based on report by Vitaly Shupak (RT 105622).
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2015f)
.Sp
Now uses /etc/localtime as a method to determine the local timezone.
Patch supplied by Tom Wyant (RT 105159) (modified by me).  The patch uses some
code derived from DateTime::TimeZone .
.Sp
Clearer message when the date is not valid in the timezone.
.IP "Test fixes" 4
.IX Item "Test fixes"
Added a number of new tests based on Devel::Cover.  Over the next several
releases, I intend to continue to add tests until coverage is 100%.
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Fixed a typo.  Gregor Herrmann (RT 105546)
.SH "VERSION 6.50 (2015\-06\-01)"
.IX Header "VERSION 6.50 (2015-06-01)"
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Not really a bug, but 6.49 got a bunch of NYTprof data bundled with it
by mistake.  It's been removed.  Olivier Mengue (RT 103252)
.Sp
Fixed a bug where information about whether a date was complete or
truncated was discarded.  Jim Avera
.Sp
Fixed a bug where SetDate with a zone alias failed.
.Sp
Added the Format_MMMYYYY config variable to allow the truncated format
mmmYYYY to be parsed instead of mmmDDYY.  David W. Morganwalp and
Glenn Golden (RT 103142)
.Sp
Fixed Makefile.PL/Build.PL to correct for a change on perl on windows
which changes a module prereq requirement.  Alexandr Ciornii
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2015d)
.Sp
Added aliases for older HP-UX time zones.  H. Merijn Brand (RT 104141)
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Fixed URL for tzdata.  Mohammad S Anwar (GitHub #3).
.Sp
Better POD formats.
.Sp
Fixed a documentation error.  Glenn Golden (RT 103966)
.SH "VERSION 6.49 (2015\-03\-01)"
.IX Header "VERSION 6.49 (2015-03-01)"
.IP "Added a deprecation warning" 4
.IX Item "Added a deprecation warning"
The TZ config variable is going away.  Added a deprecation warning.
.IP "Some speedups for timezone handling" 4
.IX Item "Some speedups for timezone handling"
Based on a report by Glenn Golden (RT 102284), I have done some
optimization of the timezone handling code.
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Added the missing is_date base method to Date::Manip::Base.  Mario Domgoergen.
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2015a)
.IP "Language fixes" 4
.IX Item "Language fixes"
A number of corrections by Nicholas Riley
.SH "VERSION 6.48 (2014\-12\-01)"
.IX Header "VERSION 6.48 (2014-12-01)"
.IP "Put repository on GitHub" 4
.IX Item "Put repository on GitHub"
Suggested by Gabor Szabo
.IP "parse_time now parses ISO 8601 times" 4
.IX Item "parse_time now parses ISO 8601 times"
The parse_time routine wouldn't correctly parse ISO 8601 times.  This
is now fixed.
.IP "Parsing special dates with timezones now works" 4
.IX Item "Parsing special dates with timezones now works"
Parsing special date formats with timezones is now supported such as:
.Sp
.Vb 4
\&   Christmas at noon PST
\&   in 3 days at noon PST
\&   now PST
\&   epoch 3000000 PST
.Ve
.IP "dm_zdump modified" 4
.IX Item "dm_zdump modified"
To match the newest version of zdump, the gmtoff is now added at the end
of each line.
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug in the printf method that would not handle embedded newlines
correctly (and resulted in an infinite loop if it were preceded by a '%').
Henrique Martins
.Sp
Fixed a bug where '24:00' was not parsed correctly (though '24:00:00' was).
.Sp
Fixed a bug where fractional values separated by a comma weren't parsed
correctly.
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2014j)
.SH "VERSION 6.47 (2014\-09\-01)"
.IX Header "VERSION 6.47 (2014-09-01)"
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2014f)
.IP "Language fixes" 4
.IX Item "Language fixes"
Fixed some encoding errors in the language pod documentation.
.SH "VERSION 6.46 (2014\-07\-08)"
.IX Header "VERSION 6.46 (2014-07-08)"
.IP "Broken distribution" 4
.IX Item "Broken distribution"
The distribution contained an temporary edit file that caused problems.
Alexandr Ciornii (RT 96459)
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2014e)
.IP "Language fixes" 4
.IX Item "Language fixes"
Added some plural abbreviations that were missing.  Glenn Golden (RT 96944)
.SH "VERSION 6.45 (2014\-06\-05)"
.IX Header "VERSION 6.45 (2014-06-05)"
.IP "Fixed a test" 4
.IX Item "Fixed a test"
One test was failing (reported by Constantine Peresypkin (RT 96249) as
well as several CPAN Tester reports).
.SH "VERSION 6.44 (2014\-06\-01)"
.IX Header "VERSION 6.44 (2014-06-01)"
.IP "\fB(*) Improvements to UTF8 handling\fR" 4
.IX Item "(*) Improvements to UTF8 handling"
A number of changes based on a report and other discussion with Yuri
Nikulin (RT 93545) including:
.Sp
Case insensitive matching of UTF8 strings should work all the time.
.Sp
Fixed two significant bugs in regexps for parsing dates.
.Sp
Improvements to UTF8 handling.
.Sp
Corrected some problems with Russian and added the cp1251 encoding.
.Sp
One correction to Romanian.
.Sp
Added several new test scripts.
.Sp
Preliminary patches were supplied by Yuri.
.IP "New features" 4
.IX Item "New features"
Modified the parse_format function to return %+ if desired.  Mike Cappella
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2014c)
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Clarified some DM6 functions.  David Close.
.Sp
Fixed a typo.  Mike Cappella (RT 95619)
.SH "VERSION 6.43 (2014\-03\-03)"
.IX Header "VERSION 6.43 (2014-03-03)"
.IP "Several changes to distribution files" 4
.IX Item "Several changes to distribution files"
I made several changes to Build.PL, Makefile.PL, META.yml in order to
improve the quality (or kwalitee) of the module.  None of these should
impact anyone using the module.
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2013i)
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Cleaned up some of the Recur documentation.  Suggested by Warren Young (RT 92794)
.SH "VERSION 6.42 (2013\-12\-02)"
.IX Header "VERSION 6.42 (2013-12-02)"
.IP "Added ParseDateFormat function" 4
.IX Item "Added ParseDateFormat function"
Added the ParseDateFormat function to the DM6 functional interface
in response to Eli Lindsey (RT 89286).
.IP "Added Common Log format" 4
.IX Item "Added Common Log format"
Added the date format used in apache logs: 11/Oct/2000:13:55:36 \-0700
Eli Lindsey (RT 89286).
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2013h)
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug where dates of the form of a delta with a timezone attached
(i.e. "1 day ago at midnight UTC") failed.  Ludovic Lange (RT 89256)
.Sp
Fixed a bug where events handling gave a warning if there were no events
that applied.  RT 90344
.SH "VERSION 6.41 (2013\-09\-05)"
.IX Header "VERSION 6.41 (2013-09-05)"
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Removed a .swp file accidentally left in the package.  RT 85845
.Sp
Fixed a bug in parse_format where times between 00:00:00 and 01:00:00 weren't
parsed correctly.  Ole Nomann Thomsen
.Sp
Fixed generated META.* files to not require Module::Build 0.39.
Carsten Wolff (RT 86137)
.Sp
Fixed a bug where parse_format did not work with a '%s' format.  Mark
Keisler (RT 87498)
.Sp
Fixed a bug where find_encoding wasn't imported from the Encode
module.  Krishna Subramanian (RT 87665)
.Sp
Fixed a bug where recurrences with no interval did not work if a start and
end date were specified, and no dates fell in that range.  Jan Pradac
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2013d)
.SH "VERSION 6.40 (2013\-06\-01)"
.IX Header "VERSION 6.40 (2013-06-01)"
.IP "Removed PODs" 4
.IX Item "Removed PODs"
POD documentation is no longer generated for Date::Manip::TZ::* and
Date::Manip::Offset::* modules.
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2013c)
.SH "VERSION 6.39 (2013\-03\-01)"
.IX Header "VERSION 6.39 (2013-03-01)"
.ie n .IP "Added the $mode argument to ParseDateDelta" 4
.el .IP "Added the \f(CW$mode\fR argument to ParseDateDelta" 4
.IX Item "Added the $mode argument to ParseDateDelta"
The ParseDateDelta function (in functional interface) did not allow you
to force a parsed delta to semi or approx where appropriate.  This
was added.  Based on RT 82991.
.IP "Added get_config method" 4
.IX Item "Added get_config method"
The get_config method was added to all classes.  Suggested by Philippe Poilbarbe.
.IP "Language fixes" 4
.IX Item "Language fixes"
Fixed a German language problem.  Gosta Oelstrom
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Documented workaround for dmake problem in strawberry perl.  Discussed on
perlmonks and Martin Thurn (RT 79837).
.Sp
Clarified the Examples page.  Winston Heng
.SH "VERSION 6.38 (2013\-01\-08)"
.IX Header "VERSION 6.38 (2013-01-08)"
.IP "\fB(*) Tar file format corrected\fR" 4
.IX Item "(*) Tar file format corrected"
Problems were reported on several OSes by people unable to install Date::Manip
(and other modules).  It turns out that the version of tar distributed by
my linux distro (OpenSuSE) uses the 'posix' format instead of the traditional
\&'gnu' format by default.  This causes problems for some versions of tar.  I
have had reports from OSX, Windows, and SunOS.  Future versions of
Date::Manip will be explicitly distributed in the 'gnu' tar archive format.
.Sp
Reported by Jay Allen and John Ralls (RT 80594).
.IP "\fB(*) Date::Manip 5.xx end-of-life\fR" 4
.IX Item "(*) Date::Manip 5.xx end-of-life"
Date::Manip 5.xx is now officially out of support.  I will not be doing
any further work on it.  The only exception is that I will consider
adding user supplied patches on a case-by-case basis.
.Sp
If at all possible, please use Date::Manip 6.xx instead.
.IP "\fB(!) Removed some deprecated config variables\fR" 4
.IX Item "(!) Removed some deprecated config variables"
The following config variables have been removed.
.Sp
.Vb 2
\&   IntCharSet
\&   RecurNumFudgeDays
.Ve
.SH "VERSION 6.37 (2012\-12\-01)"
.IX Header "VERSION 6.37 (2012-12-01)"
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug where ISO 8601 format YYYY-WXX-D didn't work if the week ended
up in December.  Gordon Lugauer.
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2012j)
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Spelling error fixed.  RT 80621
.SH "VERSION 6.36 (2012\-10\-31)"
.IX Header "VERSION 6.36 (2012-10-31)"
.IP "Fix version numbers" 4
.IX Item "Fix version numbers"
This was an interim release to fix the version numbers (6.35 was
released with all of the version numbers 6.34).
.SH "VERSION 6.35 (2012\-10\-31)"
.IX Header "VERSION 6.35 (2012-10-31)"
.IP "Fix PATH" 4
.IX Item "Fix PATH"
This version was an interim release to fix the problem with the PATH being
replaced.
.IP "Removed dependency on YAML" 4
.IX Item "Removed dependency on YAML"
I've reverted the language data files to perl literals instead of YAML.  Though
not quite as easy to maintain, it solves a few problems.  Patch provided by
Christopher Madsen.
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Last versions fix for RT 78566 overrode the PATH even when that wasn't
appropriate.  This is fixed.  Report and patch supplied by Tom Wyant (RT 80435).
.SH "VERSION 6.34 (2012\-09\-04)"
.IX Header "VERSION 6.34 (2012-09-04)"
This is a bug fix so that the PATH won't break non-unix installs.
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Put the PATH inside the Unix section so it doesn't affect non-unix
environments.  Geoff Rowell
.SH "VERSION 6.33 (2012\-09\-01)"
.IX Header "VERSION 6.33 (2012-09-01)"
.IP "Improvements to Date::Manip::Delta" 5
.IX Item "Improvements to Date::Manip::Delta"
Added convert method.  This had been planned since 6.30, but based on
a discussion with Henrique Martins, I moved it up in priority.
.Sp
Cleaned up handling of delta field lengths (they are now only calculated
once.
.Sp
Added cmp method.  Henrique Martins
.IP "Bug fixes" 5
.IX Item "Bug fixes"
The language modules read from the DATA section, but I never closed the
filehandle.  This is fixed now.  Patch by Doru Theodor Petrescu
.Sp
Added better loading of DM5/DM6 modules.  Evan Carroll (RT 78152)
.Sp
Added a secure PATH to TZ.pm for taint reasons.  In response to Dan
Pritts (RT 78566)
.IP "Time zone fixes" 5
.IX Item "Time zone fixes"
Now supports timezones in files with spaces where there should be
underscores.  This occurs in RHEL desktop.  Dan Pritts (RT 78566)
.Sp
Newest zoneinfo data (tzdata 2012e)
.IP "Documentation fixes" 5
.IX Item "Documentation fixes"
Minor fix.  Henrique Martins
.SH "VERSION 6.32 (2012\-06\-01)"
.IX Header "VERSION 6.32 (2012-06-01)"
.IP "Modified Build.PL" 4
.IX Item "Modified Build.PL"
Build.PL now has better support for building (or not building) HTML files.
Apparently this is slow on Windows.  Patch provide by Manoj Kumar (RT 75118)
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug in business day calculations.  Frederic Briere (RT 76336)
.Sp
Fixed a bug where Delta/Recur objects weren't correctly created.  Zsban Ambrus
.Sp
Fixed a bug where SetDate/ForceDate config variables could not be included
in a file.  Jerry Wilcox
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2012c).
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Better support for UTF\-8 in autogenerated language module pod files.
.SH "VERSION 6.31 (2012\-03\-01)"
.IX Header "VERSION 6.31 (2012-03-01)"
.IP "Added extended formats to printf method." 4
.IX Item "Added extended formats to printf method."
These include the %<A=NUM>, %<a=NUM>, %<v=NUM>, %<B=NUM>, %<b=NUM>,
%<p=NUM>, and %<E=NUM> formats.  Chris Jackson
.IP "Can now parse formats where the time and zone are not adjacent" 4
.IX Item "Can now parse formats where the time and zone are not adjacent"
A string like 'Jan 21 17:13:27 2010 \-0400' can now be parsed.  Requested
on perlmonks ('Can Date::Manip parse a unix timestamp' thread).
.IP "Added PeriodTimeSep config variable." 4
.IX Item "Added PeriodTimeSep config variable."
This allows you to use a period as a time separator.  Ed Avis
.IP "Holidays can be used as date strings" 4
.IX Item "Holidays can be used as date strings"
You can now parse a holiday name in the Date::Manip::Date::parse method.
For example, parse('Christmas').  Requested by Abigail.
.IP "Added new recur modifiers" 4
.IX Item "Added new recur modifiers"
Added WDn, IBD, and NBD modifiers.
.IP "Added a new date format" 4
.IX Item "Added a new date format"
You can now parse '2nd day in May' formats. Randy Harmon
.IP "More flexibility in parsing timezones with both offset and abbrev" 4
.IX Item "More flexibility in parsing timezones with both offset and abbrev"
If you include both the offset and abbreviation in the timezone portion
of a date, the parenthesis around the abbreviation are now optional, so
you can parse both:
.Sp
.Vb 2
\&   \-04:00 (EDT)
\&   \-04:00 EDT
.Ve
.Sp
Requested by Steven Melendez.
.IP "Deltas now support fractional values." 4
.IX Item "Deltas now support fractional values."
You can now use a delta of 1.5 days.  Martin Thurn (RT 42699)
.IP "Multiple holidays supported" 4
.IX Item "Multiple holidays supported"
A date may now have multiple holidays.  Keith Minkler
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug where abbreviations were not being examined case insensitively.
Jurgen Muck
.Sp
The Holidays section may be safely split across multiple config files.
A bug prevented this from working before.
.IP "Language fixes" 4
.IX Item "Language fixes"
The Norwegian translation was broken due to a typo in the language module.
.Sp
Included complete documentation for each language.
.Sp
Fixed a couple problems with Danish.  Nicholas Oxhaj
.Sp
Added Finnish (from a VERY old mail that I overlooked somehow).  Iikka
Virkkunen
.Sp
Cleaned up the values used by printf directives to give the expected
result.
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Fixed a typo.  Nicholas Bamber
.SH "VERSION 6.30 (2012\-01\-11)"
.IX Header "VERSION 6.30 (2012-01-11)"
.IP "\fB(*) (!) Reworked deltas\fR" 4
.IX Item "(*) (!) Reworked deltas"
Much of the delta code was reworked.
.Sp
The constraint that a day is treated as 24 hours was removed (by
adding the concept of semi-exact deltas) to better handle daylight
saving time calculations.
.Sp
Made cosmetic changes to which signs will be included in a delta to
make the deltas more readable.  Signs which are the same as the next
higher field will be omitted, even if they cross set boundaries.
.Sp
Added support for non-normalized deltas.  See the \f(CW$no_normalize\fR
option for the parse and set methods.
.Sp
Removed limitations on subtract=2 not working with business
calculations.
.Sp
Thanks to discussion on perlmonks, and RT 65774 that prompted me to do
this.  I'd been wanting to do it for some time, but the discussion on
perlmonks made me realize that this needed to be much higher priority.
.IP "\fB(!) Modified Delta_Format\fR" 4
.IX Item "(!) Modified Delta_Format"
In conjunction with the above work, added the 'semi' mode to
Delta_Format.
.IP "\fB(!) Removed some deprecated config variables\fR" 4
.IX Item "(!) Removed some deprecated config variables"
The following config variables have been removed.
.Sp
.Vb 5
\&   GlobalCnf
\&   IgnoreGlobalCnf
\&   PersonalCnf
\&   PersonalCnfPath
\&   PathSep
\&
\&   Internal
\&   DeltaSigns
\&   UpdateCurrTZ
\&   ConvTZ
\&   OldConfigFiles
\&   ResetWorkDay
.Ve
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2011n).  RT 71595
.Sp
Corrects a bug where +0000 and \-0000 offsets were not parsed correctly.
Aaron Hall
.Sp
The zoneinfo data includes rules more than 20 years in the future, so we
now store 30 years of future dates instead of 20 to catch these rules.
.Sp
When parsing the timezone portion of the date, timezone abbreviations
now take higher precedence than zone names (since that is how timezone
information is typically specified).  That only impacts dates where
the a timezone name is the same as an abbreviation, such as 'CET'.
.Sp
Previously, a date with CET in it was interpreted as in the CET timezone.
Now it is interpreted as in a timezone with the CET abbreviation.
.IP "Better handling of undef in DM6" 4
.IX Item "Better handling of undef in DM6"
The date/delta parsing routines in DM6 will now handle an undef argument
without issuing a warning.  Earl C. Ruby III
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug with the parse_format \f(CW%f\fR and \f(CW%i\fR formats.  Tommi Rintala
.Sp
Fixed a bug where the Date::Manip::Delta::set function didn't work
to set the month value.
.Sp
Fixed a bug where parsing some dates near during a DST change failed.
.Sp
Minor bug fix when using Delta_Format.  Prompted while investigating
RT 41095.
.SH "VERSION 6.25 (2011\-08\-31)"
.IX Header "VERSION 6.25 (2011-08-31)"
.IP "Relaxed one constraint in ISO 8601 dates" 4
.IX Item "Relaxed one constraint in ISO 8601 dates"
A time separated by whitespace from the date can use a single digit hour.
Yuming Philip Xiang
.IP "\fB(*) Set official removal dates for old config variables\fR" 4
.IX Item "(*) Set official removal dates for old config variables"
Config variables will be removed 2 years after they are deprecated (except
for the TZ variable which, due to it's wide use, will be kept for 4 years).
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2011i)
.SH "VERSION 6.24 (2011\-06\-13)"
.IX Header "VERSION 6.24 (2011-06-13)"
.IP "New features" 4
.IX Item "New features"
Spaces are ignored in the SetDate/ForceDate config values.  Zsban Ambrus
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug where 'in one week' wasn't correctly parsed.  E. M. Shtern
.Sp
Fixed a bug where options passed in to the 'new' as a listref weren't handled
properly.  Zsban Ambrus
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2011g)
.SH "VERSION 6.23 (2011\-04\-15)"
.IX Header "VERSION 6.23 (2011-04-15)"
.IP "\fB(!) Renamed one Date::Manip::Recur method\fR" 4
.IX Item "(!) Renamed one Date::Manip::Recur method"
The Date::Manip::Recur::base method has been renamed to basedate .  The
Date::Manip::Recur::base method should return the Date::Manip::Base object
like all the other Date::Manip modules.
.IP "\fB(*) Reworked holidays defined as recurrences\fR" 4
.IX Item "(*) Reworked holidays defined as recurrences"
Improved dealing with the bootstrap problem of defining holidays, especially
those that contain business day flags.  Mike Tonks
.IP "New features" 4
.IX Item "New features"
The printf function will now take multiple format strings and return a list
of values.  Zsban Ambrus
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug where GlobalCnf wasn't working.  Peter Edwards
.Sp
Improved error messages in a few cases.
.Sp
Fixed a bug where one invalid date/timezone check was ignored.  Morten Bjornsvik
.Sp
Fixed a bug where '$base2 = new Date::Manip::Base \f(CW$base1\fR' wasn't working.  RT 67143
.Sp
Fixed a bug where passing dates in to the Recur\->dates method failed.  RT 67144
.Sp
Fixed a bug where the mode wasn't being preserved correctly for a delta.  RT 67150
.Sp
Fixed a bug in recurrences where a base date outside of a date range with a very
uncommon recurrence format would not work correctly.
.Sp
Fixed a problem where the '%s' printf option didn't work in GMT.
Jean-Michel Hiver
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2011f)
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Fixed two bad recurrence examples in the documentation.  Peter Edwards
and Mike Tonks
.SH "VERSION 6.22 (2011\-03\-07)"
.IX Header "VERSION 6.22 (2011-03-07)"
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2011b)
.Sp
Fixed a bug where the gmtoff method of getting the local timezone was broken.
Martin Zinser.
.Sp
Fixed the 'env' method of determining the local time zone to allow the
value to be an offset of seconds since UTC.  This allows the VMS
SYS$TIMEZONE_DIFFERENTIAL variable to work correctly.  Martin Zinser.
.Sp
Removed the SYS$TIMEZONE_RULE method from VMS since the value stored there
is not the name of a timezone (it's a rule in a non-standard format).  Based
on discussion with Martin Zinser.
.Sp
Improved the order in which aliases, abbreviations, etc., are tested
to test current usage before non-current usage (there were a few cases
where old usages were getting tested before current usage.
.IP "Language fixes" 4
.IX Item "Language fixes"
The module will now die if a language module cannot be loaded (most
likely due to a YAML::Syck issue).  Based on discussion with Martin Zinser.
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Added a sample config file document.  Based on discussion with Rich Duzenbury.
.SH "VERSION 6.21 (2011\-01\-10)"
.IX Header "VERSION 6.21 (2011-01-10)"
.IP "New features" 4
.IX Item "New features"
Deltas may now contain spelled out numbers, so 'in 2 weeks' and 'in two weeks'
will both work.  Daniel Shahaf
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug where week_of_year didn't work in some cases.  Chris Eveland.
.Sp
Fixed a minor potential bug.  Geraint Edwards.
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Updated windows time zone aliases.  Daniel Harding
.IP "Language fixes" 4
.IX Item "Language fixes"
Added Norwegian.  Glenn Sogn
.SH "VERSION 6.20 (2010\-12\-01)"
.IX Header "VERSION 6.20 (2010-12-01)"
.IP "\fB(*) (!) Reworked recurrences\fR" 4
.IX Item "(*) (!) Reworked recurrences"
Recurrences were reworked in a (slightly) backward incompatible way to
improve their usefulness (and to make them conform to the expected
results). Most recurrences will work the same as previously, but a few will
differ. Most of this was suggested by Jay Jacobs.
.Sp
A recurring event is now calculated relative to the base date, NOT relative
to a previous event. For example, if a recurrence occurs every month, and
the base date was Jan 31, then previously, recurring events would have
been (in a non-leap year):
.Sp
.Vb 4
\&   D(0)                   = Jan 31
\&   D(1)  = D(0) + 1 month = Feb 28
\&   D(2)  = D(1) + 1 month = Mar 28
\&   ...
.Ve
.Sp
The new behavior is:
.Sp
.Vb 4
\&   D(0)                       = Jan 31
\&   D(1)  = D(0) + 1*(1 month) = Feb 28
\&   D(2)  = D(0) + 2*(1 month) = Mar 31
\&   ...
.Ve
.Sp
Previously, if a base date were not specified, it was not determined
from the date range. Now, the start date of the date range acts as the
base date.
.Sp
The meaning of the base date has changed slightly. It is much more
meaningful and useful now.
.Sp
Added iterator functions.  Daniel LaLiberte
.Sp
The RecurNumFudgeDays variable is no longer used and is deprecated.
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2010o)
.SH "VERSION 6.14 (2010\-10\-20)"
.IX Header "VERSION 6.14 (2010-10-20)"
.IP "\fB(*) Date::Manip 5.xx fully integrated with 6.xx\fR" 4
.IX Item "(*) Date::Manip 5.xx fully integrated with 6.xx"
Date::Manip 5.xx and 6.xx are both installed automatically, and the
correct one will be chosen.
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug where recurrence handling was broken.  RT 62128
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
A lot of documentation was cleaned up to be easier to read, and better
organized.
.SH "VERSION 6.13 (2010\-10\-13)"
.IX Header "VERSION 6.13 (2010-10-13)"
.IP "New features" 4
.IX Item "New features"
Added the input methods to Date::Manip::Date and Date::Manip::Delta.  Ed Avis.
.Sp
The 'date +%z' command will also be used to determine the timezone.  Oliver Schulze
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Several changes to try to get rid of a memory leaks reported in RT
54937.  Huge thanks to BrowserUK on perlmonks for help.  Unfortunately, it
ended up being a bug in perl, and will only be resolved when that bug is
fixed. See the Date::Manip::Problems document for more information.
.Sp
.Vb 3
\&   Reorganized Base/TZ to get rid of circular references.
\&   Added end blocks to clean some global variables.
\&   Got rid of switch/given structures.
.Ve
.Sp
Fixed a bug where an incomplete date with 'last' in it was causing an
error.  RT 60138
.Sp
Fixed a bug where 'Sunday, 9th Jan 1972' wasn't parsed correctly.  RT 57832
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Fixed a bug where Zones.pm was generated with the abbreviations in the wrong
order.  Amish Chana.
.IP "Language fixes" 4
.IX Item "Language fixes"
French month abbreviations now support periods.  Bernard Haerri
.IP "Test fixes" 4
.IX Item "Test fixes"
Added tests from RT 29655 to make sure that the problem never recurs.
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Fixed documentation problem with the new_* methods in Date::Manip::Obj.  Options
must be passed in as \e@opts rather than \f(CW@opts\fR.
.Sp
Cleaned up some of the documentation.
.SH "VERSION 6.12 (2010\-09\-27)"
.IX Header "VERSION 6.12 (2010-09-27)"
.IP "\fB(!) IntCharSet config variable deprecated\fR" 4
.IX Item "(!) IntCharSet config variable deprecated"
With better support for international character sets, the old IntCharSet
config variable (which was a bandaid at best) is deprecated. Currently, the
functionality still exists, but it will be removed at some point.
.IP "New features" 4
.IX Item "New features"
Added the Encoding config variable.
.Sp
Now supports parsing the EXIF date format.  Rhesa Rozendaal
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed Build.PL to not require perl 5.010 since the distribution as a whole
does not require that (and I want that fact to be in META.yml).
.Sp
Fixed a bug where the Date::Manip::Date::set method was broken when setting
individual fields.  Helmut A. Bender
.Sp
Fixed a bug where set didn't work in Date::Manip::Delta. Patch provided in
RT 59096.
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2010m)
.IP "Language fixes" 4
.IX Item "Language fixes"
\&\fB(*) Converted all language files to UTF\-8 and added rudimentary support for
character encodings. Some assistance by Stephen Ostermiller.\fR
.Sp
Fixed problem in Polish, Dutch.  Stephen Ostermiller
.Sp
Extended support for 'nth' up to 53rd.  Paco Regodon
.Sp
Added some corrections to German.  Dieter Lange
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Clarified Date::Manip::Recur documentation based on RT 59132.
.SH "VERSION 6.11 (2010\-04\-30)"
.IX Header "VERSION 6.11 (2010-04-30)"
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a problem in Build.PL that had an incorrect module requirement.
.SH "VERSION 6.10 (2010\-04\-29)"
.IX Header "VERSION 6.10 (2010-04-29)"
.IP "\fB(*) Combined 5.xx and 6.xx releases into one distribution\fR" 4
.IX Item "(*) Combined 5.xx and 6.xx releases into one distribution"
Because the automatic module management tools cpan/cpanp would try
to upgrade Date::Manip to the most recent version, and the most
recent version will only work if perl 5.10.0 or higher is installed,
both the 5.xx and 6.xx releases are now combined into a single
distribution.
.Sp
This is described more fully in the Date::Manip::Problems document.
.IP "\fB(!) Zones specified by offset\fR" 4
.IX Item "(!) Zones specified by offset"
In all operations involving time zones, the time zone must be determined.
By default, it would take all of the information available (date, ISDST,
etc.) and determine the most likely time zone. It would take every time zone
that matched each piece of information, starting with those that matched
in a standard time followed by those that matched in a daylight saving
time.
.Sp
When zones are specified by an offset, a standard time would always match
since there are standard time zones that match all year long (the military
time zones A\-Z and the standard time zones of the form Etc/GMT+01). As a
result, a daylight saving time match would never occur.
.Sp
Since (if the date falls during a daylight saving time period) you usually
want to use a time zone that has that offset in daylight saving time,
the default is now to check daylight saving time zones first, followed
by standard times.
.Sp
See the Date::Manip::TZ manual (under the zone method) for more
information.
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug where Date_ConvTZ not working correctly with time zones
specified by offset.  Chris Butler
.Sp
Fixed a bug where business mode calculations involving minutes was not
handled correctly.  Damien Moore
.Sp
Fixed a bug where business mode calculations failed in some cases.  RT
56638
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2010i)
.Sp
Changed Date::Manip::TZ::zone so "dst" is sometimes the default
\&\f(CW$dstflag\fR.  Based on the bug report by Chris Butler.
.Sp
OpenUNIX puts a colon at the start of some time zones. It's removed.
Jean Hassler
.IP "Test fixes" 4
.IX Item "Test fixes"
Converted tests to Test::Inter
.IP "Documentation fixes" 4
.IX Item "Documentation fixes"
Fixed a documentation bug in Date::Manip::TZ where "stdonly" was
listed as the default value for \f(CW$dstflag\fR, but in actuality, "std" is
the default.
.SH "VERSION 6.07 (2010\-02\-05)"
.IX Header "VERSION 6.07 (2010-02-05)"
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed bug in Date_TimeZone where it wasn't returning the time zone.
Robert Eden
.SH "VERSION 6.06 (2010\-02\-05)"
.IX Header "VERSION 6.06 (2010-02-05)"
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Minor bug where \f(CW%Z\fR printf format didn't always work.
.Sp
Added support for 5pm back in (it was omitted accidentally).  Mark Kennedy
.Sp
Fixed a minor warning.  Morten Bjoernsvik
.Sp
Some additional speedups.
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Newest zoneinfo data (tzdata 2010b)
.Sp
Added dm_zdump example script.
.Sp
Improved TZ::periods functionality
.Sp
Fixed bug in Date_ConvTZ where empty values weren't defaulting to local time zone.
Robert Eden
.Sp
Fixed a couple of problems in the generated time zones for some odd
cases (America/Resolute and Asia/Tehran).
.SH "VERSION 6.05 (2009\-12\-09)"
.IX Header "VERSION 6.05 (2009-12-09)"
.ie n .IP "\fB(!) \fR\fB%z\fR\fB format\fR" 4
.el .IP "\fB(!) \fR\f(CB%z\fR\fB format\fR" 4
.IX Item "(!) %z format"
In Date::Manip 5.xx, the \f(CW%z\fR 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.
.Sp
I've changed \f(CW%z\fR back to \-0500, and introduced a new format (%N) which
returns \-05:00:00.
.Sp
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.
.IP "\fB(*) Significant speedups.\fR" 4
.IX Item "(*) Significant speedups."
Thanks to Moritz Lenz and BrowserUK on perlmonks for suggestions (and
a number of other people on perlmonks for suggestions that I did not
end up using, but which provided a great discussion).
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug in parse_date where the current time was getting used
instead of the documented 00:00:00
.Sp
Bug fix where DateCalc didn't work with \f(CW$mode\fR in some cases.
.Sp
Fixed Makefile.PL/Build.PL to handle Win32::TieRegistry requirement.
.Sp
Changed \f(CW%z\fR printf behavior back to 5.xx and added \f(CW%N\fR format. Gilles
Lamiral
.Sp
Added dm_date example script.
.IP "Time zone fixes" 4
.IX Item "Time zone fixes"
Fixed bug where non-English Windows versions didn't get the
time zone. Thanks to Rene Schickbauer for testing.
.IP "Test fixes" 4
.IX Item "Test fixes"
Reduced the precision of 1 test to avoid a rounding difference when
using a perl compiled with uselongdouble.  Andreas Koenig
.SH "VERSION 6.04 (2009\-11\-25)"
.IX Header "VERSION 6.04 (2009-11-25)"
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Fixed a bug where events were not interpreted in the correct time zone
if SetDate/ForceDate used.
.SH "VERSION 6.03 (2009\-11\-24)"
.IX Header "VERSION 6.03 (2009-11-24)"
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Corrects a backward incompatibility with UnixDate. Rene Schickbauer
.IP "Test fixes" 4
.IX Item "Test fixes"
A couple more corrections to the tests.
.SH "VERSION 6.02 (2009\-11\-24)"
.IX Header "VERSION 6.02 (2009-11-24)"
.IP "Bug fixes" 4
.IX Item "Bug fixes"
Disabled curr_zone_methods when taint checking on. I believe that Date::Manip
is completely taint friendly at this point.
.IP "Test fixes" 4
.IX Item "Test fixes"
A quick fix to make sure that the tests run correctly in other time zones.
.SH "VERSION 6.01 (2009\-11\-23)"
.IX Header "VERSION 6.01 (2009-11-23)"
.IP "Bug fixes" 4
.IX Item "Bug fixes"
\&\fB(*) Fixed a bug where dates were sometimes getting the wrong time zone when
SetDate/ForceDate in effect.\fR
.SH "VERSION 6.00 (2009\-11\-23)"
.IX Header "VERSION 6.00 (2009-11-23)"
.IP "First release of the 6.xx series" 4
.IX Item "First release of the 6.xx series"
Date::Manip 6.00 is a total rethink of the module, and a nearly complete
rewrite. Please refer to the Date::Manip::Changes5to6 document for a list
of incompatible changes.
.IP Reorganization 4
.IX Item "Reorganization"
\&\fB(*) Massive reorganization and near total rewrite.\fR
.Sp
\&\fB(*) Broke into several smaller modules\fR
.IP "New Features" 4
.IX Item "New Features"
\&\fB(*) Full time zone support (using tzdata 2009s)\fR
.Sp
Added some functionality (suggested by James Elson to improve setting
the "current time".  Done with the ForceDate config variable.
.Sp
\&\fB(*) Converted languages to YAML for much easier maintenance. Patch and
suggestion provided by Evan Carroll\fR
.Sp
Added much better formats for deltas. Suggested by Jim Hranicky.
.Sp
Borrowed the _FindWindowsTZName function from the DateTime-TimeZone
module.
.Sp
Added SetDate config variable (based on a suggestion by Christian Campbell).
.Sp
Added parse_format which was first suggested by Kim Ryan.
.IP "Other changes" 4
.IX Item "Other changes"
Several config variables deprecated
.Sp
Thanks to Jonathan Hogue for helping test Windows additions.
.IP "Bug fixes (correcting problems in the 5.xx releases)" 4
.IX Item "Bug fixes (correcting problems in the 5.xx releases)"
Fixed a bug where "YYtoYYYY=c" wouldn't work.
.Sp
VMS bugfix to not call `date` command.  Lane
.Sp
New Year's Day defined using a recurrence which might push the observed
day to the previous year was broken. Reported by Jerry Wilcox.
.IP "Language fixes" 4
.IX Item "Language fixes"
Fixed typo in Turkish translation.
.Sp
Spelling fix in Dutch. Bart Van Loon
.IP "Additional credits" 4
.IX Item "Additional credits"
I have received many suggestions over time which were automatically
handled during the 6.00 rewrite. Although the changes weren't made
because of the suggestions specifically, I wanted to acknowledge
them since I appreciate the suggestions.
.Sp
I believe the first person to suggest writing Date::Manip as an OO
module was Eduard Derksen.
.Sp
Delta_Format initialization done outside of the function.  Eric Boehm
.Sp
Added \f(CW$subtract\fR to calculation routines. First suggested by Steve Berlage.
.Sp
Added ability to set individual parts of the date (Date::Manip::Date::set).
First suggested by Martin Thurn.
.Sp
UnixDate (i.e. Date::Manip::Date::printf) only calculates formats when
they are needed.  Eduard Derksen
.Sp
Parsing will skip some date/time formats if requested. This was first
suggested by Eduard Derksen.
.Sp
It has been suggested several times to support multiple languages,
multiple config files, or multiple sets of Date_Init
options. These suggestions (by Meng Fang, Ed Avis, Christian
Campbell, and perhaps others) were at the back of my mind as I
developed the Date::Manip::Base class.
.Sp
The regular expressions are all i18n friendly in anticipation of much
better support for localization. First suggested by Alex Kapranoff.
.Sp
Parsing a date ('today', 'Monday') gives a time of '00:00:00'. Suggested
by Mark Aitchison.
.Sp
Working with fractional days was suggested by Peter van Hardenberg.
This is implemented in Date::Manip::Base::day_of_year method.
.SH "BUGS AND QUESTIONS"
.IX Header "BUGS AND QUESTIONS"
Please refer to the Date::Manip::Problems documentation for
information on submitting bug reports or questions to the author.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Date::Manip       \- main module documentation
.SH LICENSE
.IX Header "LICENSE"
This script is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
.SH AUTHOR
.IX Header "AUTHOR"
Sullivan Beck (sbeck@cpan.org)