Current Path :
/
usr
/
share
/
doc
/
perl-DateTime-1.01
/
Or
Select Your Path :
Upload File :
New :
File
Dir
//usr/share/doc/perl-DateTime-1.01/Changes
1.01 2013-04-01 - Fixed test failures on older Perls. 1.00 2013-03-31 - Bumped the version to 1.00. This is mostly because my prior use of both X.YY and X.YYYY versions causes trouble for some packaging systems. Plus after 10 years it's probably ready to be called 1.00. Requested by Adam. RT #82800. - The %j specifier for strftime was not zero-padding 1 and 2 digit numbers. Fixed by Christian Hansen. RT #84310. - The truncate method was sloppy about validating its "to" parameter, so you could pass things like "years" or "month whatever anything goes". The method would accept the parameter but then not actually truncate the object. RT #84229. - Previously, if a call to $dt->set_time_zone() failed it would still change the time zone of the object, leaving it in a broken state. Reported by Bill Moseley. RT #83940. - DateTime::Infinite objects should no longer die when methods that require a locale are called. Instead, these methods return undef for names and Inf/-Inf for numbers. This affects methods such as day_name() as well as CLDR and strftime formats. When a locale-specific format is used (like the "full" datetime format) it uses the en_US format. Reported by Paul Boldra. RT #67550. 0.78 2012-11-16 - Reverted the change to round nanoseconds up or down in various situtations. Now we always round down. This avoids the case where rounding up would require us to then increment the second value (which could then require us to increment the minute, which could then require us to increment the hour, which could then ...). In other words, we don't want to round 2011-12-31T23:59:59.999999 up to 2012-01-01T00:00:00, because that would be insane. This applies to the return values for ->microsecond, ->millisecond, and the %N specifier for strftime. Patch by Martin Hasch. RT #79845. 0.77 2012-09-25 - POD changes that should make the documentation look better, especially on the web. 0.76 2012-07-01 - The DateTime->subtract method ignored the end_of_month parameter. Patch by Chris Reinhardt. RT #77844. 0.75 2012-06-11 - The epoch for years 1-999 was broken because Time::Local is "clever". A pox on all clever APIs, I say! Reported by Christian Hansen. RT #77719. - Shut up compilation warning from 5.17.x. Reported by Tom Wyant. RT #77490. 0.74 2012-03-22 - Small packaging fix for metacpan's benefit. No need to upgrade. 0.73 2012-03-17 - Change tests to work with Zefram's entirely rebuilt DateTime::TimeZone distribution, which will replace the current implementation. Patch by Zefram. RT #75757. 0.72 2012-01-05 - Remove Test::DependentModules from the dep list. This is used by some author-only tests. Reported by Zefram. 0.71 2012-01-05 - There will be a new leap second on June 30, 2012. 0.70 2011-05-09 - Really fix %N, finally. This was breaking the DateTime::Event::Recurrence test suite. Patch by Dagfinn Ilmari Mannsåker. 0.69 2011-05-03 - When a DateTime object had nanoseconds == 0, the %N strftime specifier always returned "0" regardless of the precision requested. Reported by John Siracusa. RT #67928. 0.68 2011-04-25 - The tests for %N in the last release relied on the vagaries of floating point math on a 64-bit system. Now the from_epoch() method just uses string operations to separate the epoch into an integer value and a mantissa. This avoids floating point insanity. Reported by zefram. RT #67736. 0.67 2011-04-24 - The %N strftime specifier simply truncated nanoseconds, rather than rounding them. Reported by Michael R. Davis. RT #66744. - The %U strftime specifier was off by one in years where January 1st was a Sunday. Patch by Christian Hansen. RT #67631. - The %W strftime specifier was off by one in years where January 1st was a Sunday or Monday. Patch by Christian Hansen. RT #67631. - Some small optimizations from Christian Hansen. The biggest impact is for calculating week_of_month, week_number, and week_year. - This distro now requires Perl 5.8.1+ (it implicitly did this anyway now that Params::Validate is 5.8.1+). 0.66 2010-11-26 - A bunch of documentation cleanup. No code changes. 0.65 2010-10-25 - Actually put the right $VERSION in every package. No other changes. 0.64 2010-10-25 * All the constructors besides new() ended up calling new(), which meant that these constructors went through the parameter validation code twice. Avoiding this should make everything that constructs a new object (besides new() itself) a little faster. ** This change breaks DateTime::Fiscal::Retail454, but no other modules, to the best of my knowledge. ** - The t/39no-so.t test failed for some people. I can't reproduce it, but this release will hopefully fix the problem. Patch by Tokuhiro Matsuno. RT #62061. - Added a section on the DateTime Project ecosystem to the docs. Addresses RT #60930. - Fixed wiki links in the docs now that the wiki has moved to a new wiki platform. - Restored some of the dzil-ification. The repo now has a very minimal Build.PL file which is just enough to build the XS code and run the tests. This fixes the total lack of prereqs in the META.* files. Reported by Bjørn-Olav. RT #62427. 0.63 2010-09-24 - Actually bump the version in the module files. Oops. Reported by bricas. 0.62 2010-09-23 - Don't try to test with DateTime::Format::Strptime unless we have a relatively recent version. Should fix some test failures. 0.61 2010-07-16 - Switching to dzil in 0.56 broke the --pp flag for the Build.PL. Reported by Jonathan Noack. RT #59421. 0.60 2010-07-03 - By default, Dist::Zilla generates a Build.PL that requires Module::Build 0.3601+, but this distro really doesn't need any particular version. 0.59 2010-06-29 - More packaging fixes. This release makes sure that POD only shows up in the right files. In 0.56 through 0.58, some POD in the wrong place confused the search.cpan.org POD display code, and the main module's documentation wasn't viewable. 0.58 2010-06-28 - Versions 0.56 and 0.57 did not build XS properly when installing. 0.57 2010-06-26 - Make DateTime::LeapSecond have the same $VERSION as every other .pm file. 0.56 2010-06-26 - The set_formatter() method did not return the DateTime object, and did not actually validate the value provided for the formatter. Based on a patch by Andrew Whatson. RT #58506. - Improved docs on floating time zone. Based on suggestions by Michael Svoboda. RT #56389. - Added mention of end-of-month algorithms to docs on DateTime math. Based on a patch by Michael R. Davis. RT #58533. - License is now Artistic 2.0. 0.55 2010-03-16 - Get all tests passing on 5.6.2. Thanks to Zefram for help spotting the problems. - Moved code to my hg repo at http://hg.urth.org/hg/DateTime.pm. 0.54 2010-03-14 - Bumped the DateTime::TimeZone prereq to 1.09 to force people to use a modern version. Previously the minimum version was 0.59, and there have been a lot of bug fixes since then. - String overloading now extends to string comparison, so a DateTime object can be compared to any string. In other words if ( $dt eq $string ) { ... } will simply stringify $dt and then do a normal string-is-equals check. Previously, this would blow up unless both operands were a DateTime object. Note that future versions of Test::More (0.95_01+) will no longer stringify arguments to is(), which means that older versions of DateTime may cause new test failures when you upgrade Test::More. It is highly recommended that you upgrade DateTime before upgrading to Test::More 0.95_01+. Patch by Michael Schwern. RT #55453. - Allow passing end_of_month setting to $duration->inverse(). Requested by John Siracusa. RT #53985. 0.53 2009-12-06 - Added Test::Exception to build_requires. 0.52 2009-12-05 - Numeric to ->new() are now all validated to make sure they are integers. Previously, things like "month => 11.2" would have been allowed. Based on a bug report from Max Kanat-Alexandar. RT #45767. - Added a warning to the docs suggesting that you cache the locale time zone if you need to make many DateTime objects in the local zone. Looking up the local zone can be fairly expensive. RT #46753. 0.51 2009-11-01 - Switched to Module::Build. To force a non-XS build, start the build process with "perl Build.PL --pp". - POD-related tests are only run for the maintainer now. - Fixed handling of negative years in CLDR formatting for "y" and "u" patterns. Note that the LDML spec says nothing about how this should work, so I took my best guess. 0.50 2009-05-11 - Tests were failing on Win32 because they attempted to use a negative epoch. Fixed so that these tests are skipped. Fixes RT #45966. 0.49 2009-05-04 - A bug in the test code for handling overloaded objects in from_epoch resulted in a test failure on Perl 5.8.x. This release contains no changes besides a test code fix. 0.48 2009-05-04 - Some of the accessors (the "main" ones like year(), month(), day(), etc) now warn if they are passed a value. Patch from Shawn Moore. Fixes RT #6979. - DateTime::Duration expected DateTime to be loaded and used some constants from it, but did not explicitly "use DateTime". Reported by Jeff Kubina. RT #44740. - The CLDR formatting for "c" and "cc" was incorrectly using the local day of the week. This meant that it gave the wrong result for locales where Monday is not considered the first day of the week. Reported by Maros Kollar. RT #45007. - DateTime->from_epoch did not allow an object which overloaded numification as the epoch value. Patch by Michael Schwern. RT #45653. - Fixed how datetime subtraction is handled for some cases around DST changes. This had been improved back in 0.30, but there were still bugs. RT #45235. 0.47 2009-03-01 - The handling of CLDR format 'j' and 'jj' was backwards, using 24 hour time for locales that wanted 12 hour, and vice versa. Reported by Maros Kollar. - The CLDR formatting was missing support for lower-case "q" patterns. Reported by Maros Kollar. 0.46 2009-02-28 - Added a duration_class method for the benefit of DateTime.pm subclasses. Patch by Shawn Moore. 0.4501 2008-11-25 - The epoch() method got broken in the recent shuffling between Time::Local and Time::y2038. Unfortunately, the tests to catch this also got lost in the shuffle. Reported by Avianna Chao. 0.45 2008-11-11 - Reverted the changes to use Time::y2038, on the recommendation of Michael Schwern (the author of said module), because it is not yet stable. This may come back in a future release. 0.4401 2008-11-03 - In order to handle epochs > 2**32 properly on a 32-bit machine, we also need to import gmtime from Time::y2038. This changes fixes a whole bunch of test failures seen with 0.44. 0.44 2008-11-01 - XS-capable DateTime.pm now uses Time::y2038 instead of Time::Local. This lets it handle epochs up to 142 million years before and after the Unix epoch. - Fixed a compiler warning with Perl 5.10.0. - Fixed docs for year_with_era, which had AD and BC backwards. Reported by Vynce Montgomery. RT #39923. - The format_cldr() method did not format the "yy" format properly when the year ended in "0X". Reported by Wilson Santos. RT #40555. 0.4305 2008-10-03 - The pure Perl version of this module did not know about the end of 2008 leap second. Reported by James T Monty. 0.4304 2008-07-13 - Fix test failures when tests are run with DateTime::Locale 0.41. Reported by David Cantrell via CPAN Testers. 0.4303 2008-07-12 - There is a new leap second coming at the end of 2008. 0.4302 2008-05-20 [ BUG FIXES ] - The 41cldr_format.t test blew up on Perl 5.6.x, because of a bug in the test code. 0.4301 2008-05-18 [ BUG FIXES ] - In the 0.43 release, I forgot to change the DateTime::Locale dependency to require DT::Locale 0.40. 0.43 2008-05-18 [ *** BACKWARDS INCOMPATIBILITIES *** ] * Dropped support for Perl 5.005. [ ENHANCEMENTS ] - Added support for formatting the CLDR date pattern language, which is much more powerful than strftime. This, combined with the latest DateTime::Locale, makes the localized output much more correct. [ BUG FIXES ] - The hour_1() method was returning the real hour + 1, rather than just representing midnight as 24 instead of 0. This bug fix will probably break someone's code. 0.42 2008-02-29 [ BUG FIXES ] - The 17set_return.t tests failed on leap days, like today. Reported by Duncan Ferguson. RT #33695. 0.41 2007-09-10 [ BUG FIXES ] - The 13strftime.t test was failing when DateTime::Locale 0.35 was installed. The test has been adjusted and we now list DT::Locale 0.35 as the minimum version. Reported by David Cantrell. 0.40 2007-08-30 [ BUG FIXES ] - A custom formatter would be lost after a call to set() or truncate(). Reported by Kjell-Magne Øierud. RT #28728. - The truncate() method docs said it accepted "second" as a parameter, but it didn't actually do the right thing with it. Now it always truncates nanoseconds to 0 for any parameter it is passed. 0.39 2007-07-17 [ BUG FIXES ] - Yet more changes to how infinity is handled and tested. This passes for me on 32-bit Win XP and 64-bit Linux, which is promising. Patch by Yitzchak Scott-Thoennes. RT #22392. 0.38 2007-06-30 [ BUG FIXES ] - Require Test::Pod::Coverage 1.08 in pod-coverage.t, since we use all_modules, which was only exported as of version 1.08. Reported by MATSUNO Tokuhiro. Fixes RT #26594. - Fixed a bad link to the old FAQ location in the docs. Reported by Ric Signes. Fixes RT #26846. [ ENHANCEMENTS ] - DateTime.pm now explicitly overloads string comparison. This was done so that comparing a DateTime.pm object to a string returns false, rather than throwing an exception. Reported by Chris Dolan. Addresses RT #26085. 0.37 2007-03-30 [ BUG FIXES ] - Require DateTime::Locale 0.34, which fixes a problem that manifested when thawing a DateTime.pm object. See http://www.mail-archive.com/datetime@perl.org/msg05633.html for some discussion of this. - Added pod coverage tests, and added some POD for undocumented methods as a result. [ ENHANCEMENTS ] - This distro is now GPG-signed, per RT #24776. 0.36 2007-01-18 [ BUG FIXES ] - For infinity, use 100 ** 1000 instead of 100 ** 100 ** 100. This may fix the problems with infinity on some platforms (or may not). Suggested by Bjorn Tackmann. See RT #17390, #19626, and #22392. - Require DateTime::TimeZone 0.59, which includes a similar fix. 0.35 2006-10-22 [ ENHANCEMENTS ] - Added several new methods for getting locale-based data, era_abbr(), era_name(), quarter_abbr(), and quarter_name(). The era() method returns the same data as era_abbr(), but is deprecated. 0.34 2006-08-11 [ BUG FIXES ] - DateTime's code to fall back to the pure Perl implementation was broken in most cases, making it fairly useless. Reported by Adam Kennedy and Brendan Gibson. - Under Perl 5.6.2 (and presumably 5.6.x), some of the tests mysteriously failed. I tracked this down to a weird interaction between DateTime's string overloading and Test::Builder->cmp_ok(). See RT 19626. 0.33 2006-08-09 (the "Asia/Kaohsiung" release) [ ENHANCEMENTS ] - Attempting to do an overloaded operation (add, subtract, compare) with an inappropriate argument (like $dt + 1) gives a more useful error message. [ BUG FIXES ] - The fixes in 0.30 for subtract_datetime() crossing a DST change had a bug. When subtracting two dates, both occurring on a DST change date, but where the dates did not cross the change, the answer was off by an hour. Reported by Chris Prather. See RT 20697. - Borrowed a tweak from version.pm's Makefile.PL to make compiler detection work with MSVC. 0.32 2006-07-24 [ BUG FIXES ] - Change how C compiler detection is done in the Makefile.PL so it does not rely on having make on the system. The new way should work on (most?) Unix and Win32 systems. Suggested by David Golden. See RT 18969. 0.31 2006-05-21 [ ENHANCEMENTS ] - Switched some uses of die() to Carp::croak(), where appropriate. This should make error messages more useful in many cases. Based on a suggestion by Max Maischein. See RT tickets 11692 & 18728. [ BUG FIXES ] - Removed all uses of UNIVERSAL::isa and UNIVERSAL::can as functions. - Tweaked 20infinite.t test to give more useful output for some failures, though it probably doesn't fix them. See RT 17390. 0.30 2005-12-22 [ ENHANCEMENTS ] - Expanded and rewrote the docs on date math to try to explain exactly how DateTime.pm works, and in particular cover the problems DST introduces to various types of date math. The docs now also include some specific recommendations on getting sane results from datetime math. - Added calendar_duration() and clock_duration() methods to DateTime::Duration - Explicitly override the stringification method for DateTime::Infinite objects. They now stringify as whatever the IEEE infinity and negative infinity numbers stringify to on your platform. On Linux this is "inf" and "-inf". CPAN RT #16632. [ BUG FIXES ] - delta_md() and delta_days() did not always return correct values when crossing a DST change. - The pure Perl version of the code had a dependency ordering problem where DateTime::LeapSecond depended on other pure Perl code that wasn't yet available. I'm not sure how this ever worked. - Remove mentions of leap second on 1971-12-31 from the docs, because there was no leap second that day. Reported by Mike Schilli. - If you added a second to a datetime that was on a leap second (like 2005-12-31T23:59:60) it got "stuck" and kept returning the same datetime. Reported by Mike Schilli. - Changes to the tests in 20infinite.t may fix failures seen on some platforms and with new versions of Test::More (0.62 was known to cause failures) [ *** BACKWARDS INCOMPATIBILITIES *** ] - The subtract_datetime() method switched back to using the local portion of the date _and_ time, but it now accounts for days with DST changes specially. This produces results that fix the bugs that were fixed by previous subtraction changes in 0.28 and 0.29, but without introducing even more bugs. The overall result should be sane, but please see the docs for details. 0.2901 2005-07-04 - A leap second for the end of 2005 was announced. 0.29 2005-06-03 [ *** BACKWARDS INCOMPATIBILITIES *** ] - When adding/subtracting a duration with months or days that crossed a DST change, the result was based on the local time, not the UTC time. For consistent results, it is necessary to use the UTC time (but local date) for all date math. Reported by J. Alexander Docauer. 0.28 2005-02-27 [ ENHANCEMENTS ] - The era names for the era() method are now retrieved from the DateTime.pm object's associated locale. The old era() method, which was hard-coded to use BCE and CE, is renamed secular_era(). The christian_era() method remains the same. [ BUG FIXES ] - Fixed an embarassing bug in the subtract_datetime() method. It was subtracting local times, not UTC, which caused bugs when doing subtraction across a DST change. This method is used to implement subtraction overloading, so that was affected as well. Reported by Mike Schilli. - The docs for the %U and %W strftime specifiers implied that these should be zero-padded, but the code was not doing so. Reported by J Docauer. 0.27 2005-01-31 [ ENHANCEMENTS ] - Added local_rd_values() method for the benefit of other modules like DateTime::Event::Recurrence. 0.26 2005-01-27 [ BUG FIXES ] - The docs claimed that the delta_ms(), delta_md(), delta_days() methods always returned a positive duration, but this was not true for delta_md() or delta_days(). 0.25 2005-01-10 (the "new year, new bugs" release) [ BUG FIXES ] - Calling set_time_zone() for a datetime very close to a time zone change died for many of the Olson time zones. - The docs for the from_object constructor said that by default, new objects were in the UTC time zone, but in reality the default was the floating time zone. The docs were changed to match the code. Ticket 9278 on rt.cpan.org. 0.24 2004-12-10 (the "have I mentioned I hate leap seconds" release) [ BUG FIXES ] - Fixed even more bugs related to leap seconds and time zones. Reported by Eugene van der Pijll. [ KNOWN BUGS ] - Offsets with a seconds portion (like "+00:00:30") act strangely near leap seconds. Reported by Eugene van der Pijll. This will be fixed in a future release. 0.23 2004-12-09 (the "oh how I hate leap seconds" release) [ ENHANCEMENTS ] - Added a number of convenience "set" methods: set_year, set_month, set_day, set_hour, set_minute, set_second, set_nanosecond, and set_locale. Suggested by Michael Schwern. - Added christian_era and year_with_christian_era methods. - Clarified that from_epoch(), today(), and now() all return objects in the UTC time zone. Suggested by Sagar Shah and others. - Added formatter parameter to constructor, which allows per-object stringification. Based on a patch from Daisuke Maki. [ BUG FIXES ] - Trying to serialize DateTime::Infinite objects with Storable blew up. Patch by Daisuke Maki. - Require Test::More 0.34+, since I use a function introduced in that version in the tests. Suggested by Jean Forget. - Fix a bug in strftime() which could cause weirdness with pathological specifiers like "%%{day_name}%n". Reported by Jean Forget. - Fixed a number of bugs related to leap seconds and time zones. Reported by Eugene van der Pijll. 0.22 2004-07-23 [ *** BACKWARDS INCOMPATIBILITIES *** ] - The leap second table we were using mistakenly included a leap second on December 31, 1971. This will break all versions of the DateTime::Format::Epoch::TAI64 module up to and including version 0.06. Most users of DateTime.pm will not be affected. Patch by Joshua Hoblitt. 0.2101 2004-06-10 [ BUG FIXES ] - There was a bug in the date math code that occurred if you tried to add enough days, minutes or seconds to generate a datetime 10 years in the future (or so). If the the DateTime object had a a time zone with recurring DST changes, then the date math operation would cause a fatal error "Invalid local time for date in time zone ...". Reported by Dave Faraldo. 0.21 2004-03-28 (The "Another YAPC::Taipei release party release" release) [ *** BACKWARDS INCOMPATIBILITIES *** ] - When given mixed positive & negative arguments, DateTime::Duration no longer forces all arguments to be negative. - For mixed durations, the is_positive, is_zero, and is_negative methods all return false. - Brought back stringification overloading. As of version 1.06, Devel::StackTrace will ignore this overloading when displaying a trace. [ ENHANCEMENTS ] - Add a new in_units() method to DateTime::Duration. Patch by Andrew Pimlott. - Rely on DateTime::TimeZone and DateTime::Locale having their own Storable hooks, as opposed to handling them in DateTime.pm's own Storable hooks. This should fix RT ticket #5542, reported by Dan Rowles (I hope). - More docs on how date math is done. See the new section "The Results of Date Math". [ BUG FIXES ] - DateTime::Duration's is_positive, is_zero, and is_negative methods could incorrectly return true if a duration contained mixed positive and negative units. - Better normalization of nanoseconds in DateTime::Duration. Patch by Andrew Pimlott. 0.20 2004-02-12 [ IMPROVEMENTS ] - Tweaked the "How Date Math is Done" section in DateTime.pm to provide some more explicit examples. [ BUG FIXES ] - If seconds are not negative, DateTime::Duration will try to keep nanoseconds >= 0 when normalizing them to seconds, as long as this doesn't make seconds become negative. Suggested by Andrew Pimlott. - In the datetime subtraction code, there was an off-by-one error in the code to determine if one of the datetimes occurred in a minute containing a leap second. This led to the result of the subtraction being off by one second. Patch by Andrew Pimlott. - A duration's nanoseconds weren't normalized after multiplication. Patch by Andrew Pimlott. 0.1901 2004-01-07 (the "people care about ancient history?" release) [ BUG FIXES ] - The day of week was totally busted for dates before 0000-12-25. Reported by Flavio Glock. 0.19 2003-12-01 (the "never look before a leap second" release) [ IMPROVEMENTS ] - DateTime::Duration now provides a compare() class method. - DateTime::Duration now overloads comparison to throw an exception, because comparison requires a base DateTime object. Note that previous versions of DateTime::Duration _did not_ overload comparison, so if you were comparing them, you were just comparing the value of the object references. Thanks to Rick Measham, Jon Swartz, and Max Maischein for contributing to the discussion on datetime@perl.org about how to implement this feature. - Added DateTime::Duration->multiply to complement multiplication overloading. - Added a leap_seconds method. - Added a section to the docs about floating datetimes. - DateTime::LeapSecond no longer contains code copied from DateTime.pm, instead it just uses DateTime.pm directly. Patch by Joshua Hoblitt. [ BACKWARDS INCOMPATIBILITIES ] - DateTime::LeapSecond's leap_seconds() function now returns the number of leap seconds that have occurred, as opposed to the difference between TAI and UTC for a given Rata Die day, which is what it was returning previously. This means that the values it returns are 9 second less than the previous version. This does not affect DateTime.pm because it never looke at the actual value, just the difference between two leap second values, which remains the same. 0.18 2003-10-26 (the "delta, delta, delta, can I help ya, help ya, help ya?" release) [ IMPROVEMENTS ] - Added several new methods for calculating the difference between two datetime objects. These are delta_md(), delta_days(), and delta_ms(). Each of these methods returns the difference as a duration containing just certain units. [ BUG FIXES ] - Require Pod::Man 1.14+, so that head3/head4 markup doesn't cause installation to die. [ BACKWARDS INCOMPATIBILITIES ] - The local_rd_as_seconds method is deprecated, as it doesn't really serve much purpose. 0.1705 2003-10-07 [ BUG FIXES ] - Subtracting one datetime from another was still broken, and my fix in 0.1704 broke many other subtractions. Reported by Pierre Denis again. Many thanks to Pierre for paying attention. - Subtracting datetimes where the subtraction crossed a leap second was also broken. 0.1704 2003-10-07 [ IMPROVEMENTS ] - Documented the behavior of strftime() when given an invalid format. [ BUG FIXES ] - The DateTime::Duration synopsis showed a sign() method that doesn't exist, so I removed it from the synopsis. Reported by Flavio Glock. - Subtracting one datetime from another was seriously broken. The values for days & weeks were wrong in many cases. Reported by Pierre Denis. 0.1703 2003-09-22 [ BUG FIXES ] - truncate( to => 'week' ) caused a fatal error when the beginning of the week was in the previous month. Reported by R. Mathews (rt.cpan.org #3843). 0.1702 2003-09-18 [ IMPROVEMENTS ] - Added truncate( to => 'week' ). Suggested by Flavio Glock. 0.1701 2003-09-15 [ BUG FIXES ] - If from_epoch was given a fractional epoch with a floating point value with more than 9 digits after the decimal point, the object ended up containing a floating point number of nanoseconds. We now truncate this number to an integer. Fixed by Joshua Hoblitt. - The %V strftime specifier was documented, but not implemented. Reported by Joshua Hoblitt. - Test #56 in 03components.t would die with "Invalid offset: -124" when run with DateTime::TimeZone 0.2502+. Next time, I'll read my own docs ;) 0.17 2003-08-29 (the "math is hard" release) [ BACKWARDS INCOMPATIBILITIES ] - The default end_of_month mode for negative durations is now "preserve". This makes more sense, as the previous default meant that the following code: print DateTime->new( year => 2003, month => 5, day => 31 ) ->subtract( months => 1 )->ymd; printed "2003-05-01" as opposed to "2003-04-30". Thanks to Thomas Klausner for starting a discussion on this problem. - The subtract_datetime method now returns different results, as does subtraction overloading when both sides of the subtraction are DateTime objects. The subtract_datetime_absolute method returns results similar to what was previously returned from subtract_datetime. Thanks to Matthew McGillis for bringing this up, and Joshua Hoblitt and Eugene van der Pijll for contributing to the ensuing discussion. [ IMPROVEMENTS ] - DateTime.pm compare() method is now documented to work with any other calendar class that provides a utc_rd_values() method. - Added the subtract_datetime_absolute method. See the docs for details. - Documented the inverse() method in DateTime::Duration. 0.1601 2003-08-07 [ BUG FIXES ] - On platforms like Win32, where we can't find a finite() or isfinite() function/macro, the DateTime::LeapSecond code wasn't being loaded, so many tests failed. Reported by Ron Hill. 0.16 2003-08-06 [ IMPROVEMENTS ] - The XS code now implements leap second-related calculations. However, this is only used on platforms where we can find a usable finite() or isfinite() function/macro, so it isn't used on Win32. - This distro has now borged the DateTime::LeapSecond module. It is only loaded when the XS leap second code cannot be used. - Other miscellaneous performance improvements. 0.1503 2003-07-31 [ BUG FIXES ] - Adding a duration with delta months to an infinite DateTime was quite broken. Reported by Eugene van der Pijll. 0.1502 2003-07-31 [ BUG FIXES ] - XSLoader wasn't the problem on Solaris, so it's back. - Now loading the XS version of DateTime.pm is wrapped in an eval block. If it fails with an error about the object version not matching, the pure Perl version is loaded instead. This should fix Solaris. Thanks to Joshua Hoblitt for identifying this bug. 0.1501 2003-07-30 [ BUG FIXES ] - Fixed the from_object() method to set the returned object's time zone to the floating time zone if the source object did not have a time zone, as specified in the docs. Previously, the returned object's time zone was UTC. Patch by Eugene van der Pjill. - For this release, at least, the module always uses Dynaloader. This is in order to see if this fixes a problem on Solaris where the install library version of the DateTime .so file is loaded instead of the newly compiled version in the blib directory. 0.15 2003-07-29 [ IMPROVEMENTS ] - The utc_rd_values() method now returns nanoseconds in addition to Rata Die days and seconds. Based on a patch by Joshua Hoblitt. - The from_object() method expects objects to return the same values from their utc_rd_values() methods. Based on a patch by Joshua Hoblitt. [ BUG FIXES ] - Fixed a bug in the pure Perl version of _normalize_tai_seconds that caused very weird results from datetime math. This version may be used on platforms where the XS code compiles, so it can affect quite a number of systems. Reported by Dan Sully. 0.1402 2003-07-24 [ BUG FIXES ] - Fix DefaultLocale method, which didn't work at all. Reported by Serge Leger. 0.1401 2003-07-24 [ BUG FIXES ] - Fix a test failure in 13strftime.t under Perl 5.6.1 (and probably 5.6.0). 0.14 2003-07-23 [ BACKWARDS INCOMPATIBILITIES ] - The DateTime::Language modules are no longer being developed or distributed as part of the DateTime.pm distribution. Because of this, all "language" parameters should now be replaced by "locale" parameter. The "language" parameter is deprecated and will be removed in a future release. Also note that locales should be specified via ISO codes, not names like "English". The old DateTime::Language names will continue to work indefinitely, but they load DateTime::Locale objects instead. Locale-specific data will be returned in utf8 when necessary. - Similarly, the "language" and "DefaultLanguage" methods are now deprecated in favor of "locale" and "DefaultLocale". [ IMPROVEMENTS ] - DateTime::Duration now returns the object from mutator methods, in order to make method chaining possible. Suggested by Ben Bennett. - If the value for second given to new() is 60 or 61, then it must be a valid leap second. - DateTime now uses DateTime::Locale for localization, which allows for real language and territory based localization. The locale code is generated from the ICU project's data, and is much more complete than the DateTime::Language modules. However, we are losing (hopefully only temporarily) support for the various African languages contributed by Daniel Yacob. Support for those languages should return in a future release of DateTime::Locale. - Support for the '%c', '%x', and '%X' strftime format specifiers, which output localized date and time strings. - Added the time_zone_long_name method, primarily for the benefit of DateTime::Locale. - Added a note to the DateTime::Infinite docs warning that it may not work well on Win32. [ BUG FIXES ] - DateTime::Duration was not consistent in how it handled mixed positive and negative constructor parameters. Reported by Ben Bennett. 0.13 2003-05-05 [ IMPROVEMENTS ] - DateTime now does more validation of parameters given to constructors and to the set() method, so bogus values like a month of 13 are a fatal error. - Added a new constructor, from_day_of_year(). - Added a number of new "get" methods, including era, year_with_era, hour_1, hour_12, hour_12_0, weekday_of_month, and week_of_month. Based in part on a patch from Rick Measham. - Now any object method can be called in strftime format by using "%{method}" as a format specifier. Patch from Rick Measham - Added an is_zero method to DateTime::Duration, for objects of zero length. - DateTime->from_epoch will now accept a floating point epoch and turn the post-decimal portion into nanoseconds. This was done in order to interface more accurately with Time::HiRes. - Added a DateTime->hires_epoch method that returns a floating point value for epoch, also for compatibility with Time::HiRes. - DateTime.pm now implements Storable hooks to reduce the size of serialized DateTime objects. In particular, the contained time zone object is not serialized along with the DateTime object. - It is now possible to create arbitrary DateTime::Language subclasses in any namespace. [ BUG FIXES ] - "Fixed" 20infinite.t failures on Windows with 2 icky hacks. The first simply doesn't compile the XS code that deals with infinite numbers on Win32, so the pure Perl version is used instead. However, the rest of the XS code is still compiled on Win32. The other hack is to simply skip a failing test in 20infinite.t on Win32. Hopefully, this will eventually be fixed but given that this is not core functionality for most users, I'd rather get this release out the door now. - Fix epoch() method to work properly with dates greater than 50 years ago. Apparently, if Time::Local is given a year less than 100, it tries to guess the century, and it doesn't do this by simply adding 1900. Numbers less than 53 (for the year 2003) are treated as being in the current century. Ugh. - Fixed compilation on HPUX. Patch from Dan Sully. - The last_day_of_month() method did not accept a nanosecond parameter. - A DT::Duration object created with just nanoseconds was always positive, regardless of the value given for nanoseconds. - Fixed a serious bug when subtracting one datetime from another that could cause the result to be off by up to a second, and negative when it should be positive. This was caused by the introduction of nanoseconds in 0.10. - A zero length duration reported itself as positive when it should be neither positive nor negative. - In Perl 5.6.1/Red Hat Linux 7.2, multiplying a variable with value zero by -1 gives negative-zero, which breaks tests. perl -e ' $x=0; $x*=-1; print $x ' -0 Patch by Flavio Glock. - Comparing a DateTime::Infinite object to a regular datetime could cause a fatal error. Reported by John Peacock. - Fixed a failure in the 04epoch.t tests on Win32. Negative epoch values don't work on Win32. [ BACKWARDS INCOMPATIBILITIES ] - The "Portugese" language module has been renamed to "Portuguese". I'm so embarassed! Reported by Richard Evans. - DateTime::Infinite objects no longer die if "set" methods are called. Instead, these methods are now no-op methods that simply return the original object. This makes these objects more usable when mixed with regular datetime objects. - Removed the fractional_second constructor parameter. It was incorrectly documented anyway. The fractional_second _accessor_ is still there. - DateTime::Duration objects of zero length no longer return true for is_positive. 0.12 2003-05-05 [ BUG FIXES ] - Make sure tests always run with warnings on. - Fix line that had "$] >= 5.6.0" to be "$] >= 5.006". This caused warnings and was just wrong. Reported by John Siracusa. - Quiet warnings from pure Perl implementation. - Quiet warnings from language modules with Unicode when used with Perl 5.00503. 0.11 2003-05-03 [ IMPROVEMENTS ] - Moved a little bit of the leap second code to XS, so DateTime.pm may be a tiny bit faster. - Added name() method to DateTime::Language. Suggested by Rick Measham. - Use XSLoader with Perl 5.6.0+, which according to ancient perl5-porters discussions saves some memory. - Added infinite DateTime objects. See the DateTime::Infinite docs for details. [ BUG FIXES ] - The %I and %l strftime formats were formatting hours as 0-11, not 1-12 as documented. Patch by Simon Newton. - A DateTime::Duration object created only with weeks as a parameter always was positive. Fixed by Flavio Glock. [ BACKWARDS INCOMPATIBILTIES ] - Because of changes in DateTime::TimeZone 0.13, which this version now requires, when a local time is ambiguous, the latest UTC time is used, rather than the earliest, as was done previously. - The Brazilian language module has been renamed as Portugese. - Removed DateTime::Duration->compare (which I forgot to document anyway ;) and comparison overloading for DT::Duration. There's no meaningful way to compare 60 days to 2 months. 0.10 2003-04-19 (the "I'm sure the new regime will be spiffy" release) [IMPROVEMENTS] - Added Tigre language module. Contributed by Daniel Yacob. - DateTime::Duration objects now overload multiplication. Implemented by Flavio Glock. - Added support for nanoseconds in DateTime.pm and DateTime::Duration. Implemented by Flavio Glock. - Added complete support for leap seconds (through use of DateTime::LeapSecond). Mostly implemented by Flavio Glock. [ BACKWARDS INCOMPATIBILTIES ] - Because of the addition of leap seconds to the mix, we are now forced to handle seconds separately from minutes when doing date math. This means that several aspects of the DateTime::Duration API have changed. Specifically: -- There is now an additional delta_minutes() method. -- The hash returned by the deltas() method now includes a "minutes" key. -- The seconds delta may be greater than 59. -- The seconds() method may return a number greater than 59. 0.09 2003-04-05 (the "liberation through violence" release) [IMPROVEMENTS] - As requested by numerous people, there is now a pure Perl implementation of DateTime.pm included with this distribution. If you don't have a C compiler it will be used instead of the XS implementation. - Document how floating time zones are handling in comparisons, and add the compare_ignore_floating method. Based on a patch from Eugene van der Pijll. - Allow from_epoch(), now(), and today() to accept a time_zone parameter. Based on suggestions from Tim Bunce and Joshua Hoblitt. - Allow extraction of AM/PM string list from DateTime::Language classes. - Added quarter() and day_of_quarter() methods. Based on a patch from Tim Allwine. [BUG FIXES] - If a datetime had the floating timezone and then set_time_zone was used to set it to something else, the internal UTC time of the object was not changed, meaning that its offset could be calculated incorrectly. Patch by Eugene van der Pijll. - If datetime math was done with hours, minutes, or seconds, the return value of ->epoch would be wrong after this. Based on report and patch from Iain Truskett. 0.08 2003-03-21 (the "anti-war" release) [IMPROVEMENTS] - All set/modify methods now return the datetime object, in order to make method chaining possible. Patch by Iain Truskett. - The _greg2rd and _rd2greg methods have been renamed _ymd2rd and _rd2ymd, so as to make them look more normal when used in subclasses. - Added a truncate() method. Suggested by Flavio Glock. - Added Swedish language module. Contributed by Christian Hansen. - Added language modules for Afar, Amharic, Gedeo, Oromo, Sidama, Somali, and Tigrinya (Eritrean and Ethiopian), all courtesy of Daniel Yacob. - Various doc improvements, including a section on invalid local times. [BUG FIXES] - The week() method was wrong for many dates. Reported by Christian Hansen. - The last_day_of_month() method had the DateTime class hard-coded in it. Reported by Eugene van der Pijll. - Fixed a bug when comparing a datetime object to infinity (or negative infinity). Fixed by Flavio Glock. - Date math has been fixed so that it affects the _local_ times. This means that sometimes 1 day is not equal to 24 hours when the addition/subtraction crosses over a Daylight Saving Time change. See the "How Date Math is Done" section of the docs for more details. [BACKWARDS INCOMPATIBILITIES] - Objects constructed via the new() method now have a "floating" time zone by default, instead of using the "local" time zone. This is just simpler to deal with, and for code where time zones are unimportant, this is the most appropriate default. 0.07 2003-02-26 [IMPROVEMENTS] - Added a small hack to the compare() method so that this module can be used with Set::Infinite. - Changed compare so that it can be used to compare two objects from different calendars that conform to the DateTime::Calendar interface. - Added explanation of exactly what calendar this module represents ("proleptic Gregorian calendar") to docs. - Added a Spanish language DateTime::Language subclass. Implemented by Flavio S. Glock. - Added support for specifying a language by ISO code ("en" or "pt-br") as well as the subclass name. Based on a patch from Eric Cholet. - Revamped the externally visible DateTime::Language API. - Objects created via the from_object() method are set to the time zone of the object from which they were created, if it has one, or UTC otherwise. [BUG FIXES] - The from_object() method was broken because it retrieved a UTC datetime from the object passed in, and then created a new DateTime object using that UTC time as a _local_ time. [BACKWARDS INCOMPATIBILITIES] - Removed stringification overloading. Having this in place made it impossible to create a strack trace in much of the time zone code. - Renamed the DateTime::Language->subclasses method as languages. - It is no longer possible to directly instantiate a DateTime::Language subclass, instead use: my $en = DateTime::Language->new( language => 'English' ); - The from_object() method no longer accepts a "time_zone" parameter. 0.06 2003-02-16 - The docs said that there was no year 0 in the Gregorian calendar, but that was wrong. The year() method can now return 0. The year_0() method has been removed. - Added jd() and mjd() methods. - Re-implemented some of the core code in XS for speed. 0.05 2003-02-13 - Fix handling and reporting of epoch times. Epoch times are, by definition, UTC times, so any time created from an epoch should always have its time zone set to "UTC". This can be changed after the object is created. Similarly, value returned by the epoch() method needs to be based on the object's UTC time, not it's local time. Bug reported by Kellan Elliott-McCrea. - Change year_0 so that -1 BCE is 0, not 1 CE. This corresponds to astronomical years. - Change ymd, dmy, mdy, and iso8601 to use Gregorian years (..., -2, -1, 1, 2, ... ) as opposed to astronomical years. Also make sure all negative years are formatted as 4 digits. 0.04 2003-02-10 - Explicitly set time zone for objects created during tests. 0.03 2003-02-09 - Giving a language parameter to a constructor method didn't load the language class. - Test that all language classes are at least loadable. - Added Brazilian (not quite a language ;) and Danish, again stolen from Graham Barr's TimeDate suite. - Added is_dst method. Requested by Matt Sergeant. 0.02 2003-02-09 - Fixed a bug in calculating day of year in leap years (it was +1 off starting in February). Reported by Matt Sergeant. - Subtracting one datetime from another was broken in most cases. Improved the tests for this quite a bit. Reported by Eric Cholet. - Made the version number a non-dev-release so it's visible when CPAN.pm tries to install it as a prereq for something else. 0.01_00 2003-02-04 - The first alpha release. This module draws on Date::ICal for much of its internals, so it has more history than a normal alpha release.
