All Versions
10
Latest Version
Avg Release Cycle
121 days
Latest Release
1309 days ago
Changelog History
Changelog History
-
v2.8.1 Changes
November 03, 2019๐ Version 2.8.1 (2019-11-03)
โก๏ธ Data updates
- โก๏ธ Updated tzdata version to 2019c.
๐ Bugfixes
- ๐ Fixed a race condition in the
tzoffset
andtzstr
"strong"
caches on Python 2.7. Reported by @kainjow (gh issue #901). - ๐ Parsing errors will now raise
ParserError
, a subclass of
ValueError
, which has a nicer string representation. Patch by
@gfyoung (gh pr #881). - ๐
parser.parse
will now raiseTypeError
whentzinfos
is passed a
type that cannot be interpreted as a time zone. Prior to this
๐ change, it would raise anUnboundLocalError
instead. Patch by
@jbrockmendel (gh pr #891). - ๐ Changed error message raised when when passing a
bytes
object as
๐ the time zone name to gettz in Python 3. Reported and fixed by
@labrys () (gh issue #927, gh pr #935). - ๐ Changed compatibility logic to support a potential Python 4.0
๐ release. Patch by Hugo van Kemenade (gh pr #950). - โก๏ธ Updated many modules to use
tz.UTC
in favor oftz.tzutc()
internally, to avoid an unnecessary function call. (gh pr #910). - ๐ Fixed issue where
dateutil.tz
was using a backported version of
contextlib.nullcontext
even in Python 3.7 due to a malformed
import statement. (gh pr #963).
โ Tests
- โ
Switched from using assertWarns to using pytest.warns in the test
suite. (gh pr #969). - ๐ Fix typo in setup.cfg causing PendingDeprecationWarning to not be
โ explicitly specified as an error in the warnings filter. (gh pr
#966) - Fixed issue where
test_tzlocal_offset_equal
would fail in certain
environments (such as FreeBSD) due to an invalid assumption about
๐ what time zone names are provided. Reported and fixed by Kubilay
Kocak (gh issue #918, pr #928). - ๐ Fixed a minor bug in
test_isoparser
related tobytes
/str
๐ handling. Fixed by @fhuang5 (gh issue #776, gh pr #879). - ๐ง Explicitly listed all markers used in the pytest configuration. (gh
pr #915) - โ
Extensive improvements to the parser test suite, including the
๐ adoption ofpytest
-style tests and the addition of parametrization
โ of several test cases. Patches by @jbrockmendel (gh prs #735,
#890, #892, #894). - โ Added tests for tzinfos input types. Patch by @jbrockmendel (gh pr
#891). - ๐ Fixed failure of test suite when changing the TZ variable is
forbidden. Patch by @shadchin (gh pr #893). - โ Pinned all test dependencies on Python 3.3. (gh prs #934, #962)
๐ Documentation changes
- ๐ Fixed many misspellings, typos and styling errors in the comments
๐ and documentation. Patch by Hugo van Kemenade (gh pr #952).
Misc
- โ Added Python 3.8 to the trove classifiers. (gh pr #970)
- ๐ Moved as many keys from
setup.py
tosetup.cfg
as possible. Fixed
by @FakeNameSE, @aquinlan82, @jachen20, and @gurgenz221 (gh
issue #871, gh pr #880). - ๐ Reorganized
parser
methods by functionality. Patch by
@jbrockmendel (gh pr #882). - ๐ Switched
release.py
over to usingpep517.build
for creating
๐ releases, rather than direct invocations ofsetup.py
. Fixed by
@smeng10 (gh issue #869, gh pr #875). - โ Added a "build" environment into the tox configuration, to handle
๐ dependency management when making releases. Fixed by @smeng10 (gh
issue #870,r gh pr #876). - GH #916, GH #971
-
v2.8.0
February 05, 2019 -
v2.7.5 Changes
October 27, 2018โก๏ธ Data updates
- โก๏ธ Update tzdata to 2018g
-
v2.7.4 Changes
October 25, 2018โก๏ธ Data updates
- โก๏ธ Updated tzdata version to 2018f.
-
v2.7.3 Changes
May 10, 2018โก๏ธ Data updates
- โก๏ธ Update tzdata to 2018e. (gh pr #710)
๐ Bugfixes
- ๐ Fixed an issue where decimal.Decimal would cast
NaN
or infinite value in a
๐ parser.parse, which will raise decimal.Decimal-specific errors. Reported and
๐ fixed by @amureki (gh issue #662, gh pr #679). - ๐ Fixed a ValueError being thrown if tzinfos call explicity returns
None
.
๐ Reported by @pganssle (gh issue #661) Fixed by @ParseThis (gh pr #681) - ๐ Fixed incorrect parsing of certain dates earlier than 100 AD when repesented
in the form "%B.%Y.%d", e.g. "December.0031.30". (gh issue #687, pr #700) - ๐ Fixed a bug where automatically generated DTSTART was naive even if a
specified UNTIL had a time zone. Automatically generated DTSTART will now
take on the timezone of an UNTIL date, if provided. Reported by @href (gh
๐ issue #652). Fixed by @absreim (gh pr #693).
๐ Documentation changes
- โก๏ธ Corrected link syntax and updated URL to https for ISO year week number
notation in relativedelta examples. (gh issue #670, pr #711) - โ Add doctest examples to tzfile documentation. Done by @weatherpattern and
@pganssle (gh pr #671) - ๐ Updated the documentation for relativedelta. Removed references to tuple
๐ arguments for weekday, explained effect of weekday(_, 1) and better explained
๐ the order of operations that relativedelta applies. Fixed by @kvn219
@huangy22 and @ElliotJH (gh pr #673) - โ Added changelog to documentation. (gh issue #692, gh pr #707)
- ๐ Changed order of keywords in rrule docstring. Reported and fixed by
@rmahajan14 (gh issue #686, gh pr #695). - โ Added documentation for
dateutil.tz.gettz
. Reported by @pganssle (gh
๐ issue #647). Fixed by @weatherpattern (gh pr #704) - ๐ Cleaned up malformed RST in the
tz
documentation. (gh issue #702, gh pr
#706) - Changed the default theme to sphinx_rtd_theme, and changed the sphinx
๐ง configuration to go along with that. (gh pr #707) - ๐ Reorganized
dateutil.tz
documentation and fixed issue with the
๐dateutil.tz
docstring. (gh pr #714)
Misc
-
v2.7.2 Changes
March 26, 2018๐ Bugfixes
- ๐ Fixed an issue with the setup script running in non-UTF-8 environment.
๐ Reported and fixed by @gergondet (gh pr #651)
Misc
- GH #655
- ๐ Fixed an issue with the setup script running in non-UTF-8 environment.
-
v2.7.1 Changes
March 24, 2018โก๏ธ Data updates
- โก๏ธ Updated tzdata version to 2018d.
๐ Bugfixes
- ๐ Fixed issue where parser.parse would occasionally raise
decimal.Decimal-specific error types rather than ValueError. Reported by
๐ @amureki (gh issue #632). Fixed by @pganssle (gh pr #636). - ๐ Improve error message when rrule's dtstart and until are not both naive or
๐ both aware. Reported and fixed by @ryanpetrello (gh issue #633, gh pr #634)
Misc
-
v2.7.0 Changes
March 11, 2018- โฌ๏ธ Dropped support for Python 2.6 (gh pr #362 by @jdufresne)
- โฌ๏ธ Dropped support for Python 3.2 (gh pr #626)
- โก๏ธ Updated zoneinfo file to 2018c (gh pr #616)
- ๐ Changed licensing scheme so all new contributions are dual licensed under
Apache 2.0 and BSD. (gh pr #542, issue #496) - Added all variable to the root package. Reported by @tebriel
๐ (gh issue #406), fixed by @mariocj89 (gh pr #494) - โ Added python_requires to setup.py so that pip will distribute the right
๐ version of dateutil. Fixed by @jakec-github (gh issue #537, pr #552) - โ Added the utils submodule, for miscellaneous utilities.
- โ Added within_delta function to utils - added by @justanr (gh issue #432,
gh pr #437) - โ Added today function to utils (gh pr #474)
- โ Added default_tzinfo function to utils (gh pr #475), solving an issue
reported by @nealmcb (gh issue #94) - โ Added dedicated ISO 8601 parsing function isoparse (gh issue #424).
๐ Initial implementation by @pganssle in gh pr #489 and #622, with a
๐ pre-release fix by @kirit93 (gh issue #546, gh pr #573). - ๐ Moved parser module into parser/_parser.py and officially deprecated the use
of several private functions and classes from that module. (gh pr #501, #515) - ๐ Tweaked parser error message to include rejected string format, added by
@pbiering (gh pr #300) - โ Add support for parsing bytesarray, reported by @uckelman (gh issue #417) and
๐ fixed by @uckelman and @pganssle (gh pr #514) - โ Started raising a warning when the parser finds a timezone string that it
cannot construct a tzinfo instance for (rather than succeeding with no
๐ indication of an error). Reported and fixed by @jbrockmendel (gh pr #540) - โฌ๏ธ Dropped the use of assert in the parser. Fixed by @jbrockmendel (gh pr #502)
- ๐ Fixed to assertion logic in parser to support dates like '2015-15-May',
๐ reported and fixed by @jbrockmendel (gh pr #409) - ๐ Fixed IndexError in parser on dates with trailing colons, reported and fixed
by @jbrockmendel (gh pr #420) - ๐ Fixed bug where hours were not validated, leading to improper parse. Reported
๐ by @heappro (gh pr #353), fixed by @jbrockmendel (gh pr #482) - ๐ Fixed problem parsing strings in %b-%Y-%d format. Reported and fixed by
@jbrockmendel (gh pr #481) - ๐ Fixed problem parsing strings in the %d%B%y format. Reported by @asishm
๐ (gh issue #360), fixed by @jbrockmendel (gh pr #483) - ๐ Fixed problem parsing certain unambiguous strings when year <99 (gh pr #510).
Reported by @alexwlchan (gh issue #293). - ๐ Fixed issue with parsing an unambiguous string representation of an ambiguous
๐ datetime such that if possible the correct value for fold is set. Fixes
issue reported by @JordonPhillips and @pganssle (gh issue #318, #320,
gh pr #517) - ๐ Fixed issue with improper rounding of fractional components. Reported by
๐ @dddmello (gh issue #427), fixed by @m-dz (gh pr #570) - ๐ Performance improvement to parser from removing certain min() calls. Reported
๐ and fixed by @jbrockmendel (gh pr #589) - ๐จ Significantly refactored parser code by @jbrockmendel (gh prs #419, #436,
#490, #498, #539) and @pganssle (gh prs #435, #468) - Implementated of hash for relativedelta and weekday, reported and fixed
by @mrigor (gh pr #389) - Implemented abs for relativedelta. Reported by @binnisb and @pferreir
(gh issue #350, pr #472) - ๐ Fixed relativedelta.weeks property getter and setter to work for both
๐ negative and positive values. Reported and fixed by @souliane (gh issue #459,
pr #460) - ๐ Fixed issue where passing whole number floats to the months or years
arguments of the relativedelta constructor would lead to errors during
โ addition. Reported by @arouanet (gh pr #411), fixed by @lkollar (gh pr #553) - โ Added a pre-built tz.UTC object representing UTC (gh pr #497)
- โ Added a cache to tz.gettz so that by default it will return the same object
for identical inputs. This will change the semantics of certain operations
between datetimes constructed with tzinfo=tz.gettz(...). (gh pr #628) - ๐ Changed the behavior of tz.tzutc to return a singleton (gh pr #497, #504)
- ๐ Changed the behavior of tz.tzoffset to return the same object when passed the
๐ same inputs, with a corresponding performance improvement (gh pr #504) - ๐ Changed the behavior of tz.tzstr to return the same object when passed the
same inputs. (gh pr #628) - โ Added .instance alternate constructors for tz.tzoffset and tz.tzstr, to
๐ allow the construction of a new instance if desired. (gh pr #628) - โ Added the tz.gettz.nocache function to allow explicit retrieval of a new
instance of the relevant tzinfo. (gh pr #628) - Expand definition of tz.tzlocal equality so that the local zone is allow
equality with tzoffset and tzutc. (gh pr #598) - ๐ Deprecated the idiosyncratic tzstr format mentioned in several examples but
evidently designed exclusively for dateutil, and very likely not used by
any current users. (gh issue #595, gh pr #606) - โ Added the tz.resolve_imaginary function, which generates a real date from
an imaginary one, if necessary. Implemented by @Cheukting (gh issue #339,
gh pr #607) - ๐ Fixed issue where the tz.tzstr constructor would erroneously succeed if
๐ passed an invalid value for tzstr. Fixed by @pablogsal (gh issue #259,
gh pr #581) - ๐ Fixed issue with tz.gettz for TZ variables that start with a colon. Reported
๐ and fixed by @lapointexavier (gh pr #601) - โ Added a lock to tz.tzical's cache. Reported and fixed by @Unrud (gh pr #430)
- ๐ Fixed an issue with fold support on certain Python 3 implementations that
๐ used the pre-3.6 pure Python implementation of datetime.replace, most
notably pypy3 (gh pr #446). - โ Added support for VALUE=DATE-TIME for DTSTART in rrulestr. Reported by @potuz
๐ (gh issue #401) and fixed by @Unrud (gh pr #429) - Started enforcing that within VTIMEZONE, the VALUE parameter can only be
omitted or DATE-TIME, per RFC 5545. Reported by @Unrud (gh pr #439) - โ Added support for TZID parameter for DTSTART in rrulestr. Reported and
๐ fixed by @ryanpetrello (gh issue #614, gh pr #624) - Added 'RRULE:' prefix to rrule strings generated by rrule. str , in
๐ compliance with the RFC. Reported by @AndrewPashkin (gh issue #86), fixed by
@jarondl and @mlorant (gh pr #450) - Switched to setuptools_scm for version management, automatically calculating
๐ a version number from the git metadata. Reported by @jreback (gh issue #511),
implemented by @Sulley38 (gh pr #564) - ๐ฆ Switched setup.py to use find_packages, and started testing against pip
๐ installed versions of dateutil in CI. Fixed issue with parser import
discovered by @jreback in pandas-dev/pandas#18141. (gh issue #507, pr #509) - โ Switched test suite to using pytest (gh pr #495)
- ๐ท Switched CI over to use tox. Fixed by @gaborbernat (gh pr #549)
- โ Added a test-only dependency on freezegun. (gh pr #474)
- โฌ๏ธ Reduced number of CI builds on Appveyor. Fixed by @kirit93 (gh issue #529,
gh pr #579) - 0๏ธโฃ Made xfails strict by default, so that an xpass is a failure. (gh pr #567)
- โ Added a documentation generation stage to tox and CI. (gh pr #568)
- โ Added an explicit warning when running python setup.py explaining how to run
โ the test suites with pytest. Fixed by @lkollar. (gh issue #544, gh pr #548) - โ Added requirements-dev.txt for test dependency management (gh pr #499, #516)
- ๐ Fixed code coverage metrics to account for Windows builds (gh pr #526)
- ๐ Fixed code coverage metrics to NOT count xfails. Fixed by @gaborbernat
(gh issue #519, gh pr #563) - ๐
Style improvement to zoneinfo.tzfile that was confusing to static type
๐ checkers. Reported and fixed by @quodlibetor (gh pr #485) - ๐ Several unused imports were removed by @jdufresne. (gh pr #486)
- Switched isinstance(*, collections.Callable) to callable, which is available
๐ on all supported Python versions. Implemented by @jdufresne (gh pr #612) - โ Added CONTRIBUTING.md (gh pr #533)
- โ Added AUTHORS.md (gh pr #542)
- ๐ Corrected setup.py metadata to reflect author vs. maintainer, (gh issue #477,
gh pr #538) - โ
Corrected README to reflect that tests are now run in pytest. Reported and
๐ fixed by @m-dz (gh issue #556, gh pr #557) - โก๏ธ Updated all references to RFC 2445 (iCalendar) to point to RFC 5545. Fixed
by @mariocj89 (gh issue #543, gh pr #555) - ๐ Corrected parse documentation to reflect proper integer offset units,
๐ reported and fixed by @abrugh (gh pr #458) - ๐ Fixed dangling parenthesis in tzoffset documentation (gh pr #461)
- ๐ Started including the license file in wheels. Reported and fixed by
@jdufresne (gh pr #476) - ๐ Indendation fixes to parser docstring by @jbrockmendel (gh pr #492)
- ๐ Moved many examples from the "examples" documentation into their appropriate
๐ module documentation pages. Fixed by @Tomasz-Kluczkowski and @jakec-github
(gh pr #558, #561) - ๐ Fixed documentation so that the parser.isoparse documentation displays.
๐ Fixed by @alexchamberlain (gh issue #545, gh pr #560) - ๐ Refactored build and release sections and added setup instructions to
๐ CONTRIBUTING. Reported and fixed by @kynan (gh pr #562) - ๐ Cleaned up various dead links in the documentation. (gh pr #602, #608, #618)
-
v2.6.1 Changes
July 10, 2017- โก๏ธ Updated zoneinfo file to 2017b. (gh pr #395)
- โ Added Python 3.6 to CI testing (gh pr #365)
- โ Removed duplicate test name that was preventing a test from being run.
๐ Reported and fixed by @jdufresne (gh pr #371) - ๐ Fixed testing of folds and gaps, particularly on Windows (gh pr #392)
- ๐ Fixed deprecated escape characters in regular expressions. Reported by
๐ @nascheme and @thierryba (gh issue #361), fixed by @thierryba (gh pr #358) - ๐
Many PEP8 style violations and other code smells were fixed by @jdufresne
(gh prs #358, #363, #364, #366, #367, #368, #372, #374, #379, #380, #398) - ๐ Improved performance of tzutc and tzoffset objects. (gh pr #391)
- ๐ Fixed issue with several time zone classes around DST transitions in any
zones with +0 standard offset (e.g. Europe/London) (gh issue #321, pr #390) - ๐ Fixed issue with fuzzy parsing where tokens similar to AM/PM that are in the
end skipped were dropped in the fuzzy_with_tokens list. Reported and fixed
by @jbrockmendel (gh pr #332). - ๐ Fixed issue with parsing dates of the form X m YY. Reported by @jbrockmendel.
(gh issue #333, pr #393) - โ Added support for parser weekdays with less than 3 characters. Reported by
๐ @arcadefoam (gh issue #343), fixed by @jonemo (gh pr #382) - ๐ Fixed issue with the addition and subtraction of certain relativedeltas.
๐ Reported and fixed by @kootenpv (gh issue #346, pr #347) - ๐ Fixed issue where the COUNT parameter of rrules was ignored if 0. Fixed by
@mshenfield (gh pr #330), reported by @vaultah (gh issue #329). - ๐ Updated documentation to include the new tz methods. (gh pr #324)
- ๐ Update documentation to reflect that the parser can raise TypeError, reported
๐ and fixed by @tomchuk (gh issue #336, pr #337) - ๐ Fixed an incorrect year in a parser doctest. Fixed by @xlotlu (gh pr #357)
- ๐ Moved version information into _version.py and set up the versions more
granularly.
-
v2.6.0 Changes
November 08, 2016- โ Added PEP-495-compatible methods to address ambiguous and imaginary dates in
time zones in a backwards-compatible way. Ambiguous dates and times can now
be safely represented by all dateutil time zones. Many thanks to Alexander
Belopolski (@abalkin) and Tim Peters @tim-one for their inputs on how to
โ address this. Original issues reported by Yupeng and @zed (lP: 1390262,
gh issues #57, #112, #249, #284, #286, prs #127, #225, #248, #264, #302). - โ Added new methods for working with ambiguous and imaginary dates to the tz
module. datetime_ambiguous() determines if a datetime is ambiguous for a given
zone and datetime_exists() determines if a datetime exists in a given zone.
This works for all fold-aware datetimes, not just those provided by dateutil.
(gh issue #253, gh pr #302) - ๐ Fixed an issue where dst() in Portugal in 1996 was returning the wrong value
in tz.tzfile objects. Reported by @abalkin (gh issue #128, pr #225) - ๐ Fixed an issue where zoneinfo.ZoneInfoFile errors were not being properly
deep-copied. (gh issue #226, pr #225) - ๐จ Refactored tzwin and tzrange as a subclass of a common class, tzrangebase, as
there was substantial overlapping functionality. As part of this change,
tzrange and tzstr now expose a transitions() function, which returns the
DST on and off transitions for a given year. (gh issue #260, pr #302) - ๐ Deprecated zoneinfo.gettz() due to confusion with tz.gettz(), in favor of
get() method of zoneinfo.ZoneInfoFile objects. (gh issue #11, pr #310) - ๐ For non-character, non-stream arguments, parser.parse now raises TypeError
instead of AttributeError. (gh issues #171, #269, pr #247) - ๐ Fixed an issue where tzfile objects were not properly handling dst() and
tzname() when attached to datetime.time objects. Reported by @ovacephaloid.
(gh issue #292, pr #309) - /usr/share/lib/zoneinfo was added to TZPATHS for compatibility with Solaris
systems. Reported by @dhduvall (gh issue #276, pr #307) - tzoffset and tzrange objects now accept either a number of seconds or a
datetime.timedelta() object wherever previously only a number of seconds was
๐ allowed. (gh pr #264, #277) - datetime.timedelta objects can now be added to relativedelta objects. Reported
and added by Alec Nikolas Reiter (@justanr) (gh issue #282, pr #283 - ๐จ Refactored relativedelta.weekday and rrule.weekday into a common base class
to reduce code duplication. (gh issue #140, pr #311) - An issue where the WKST parameter was improperly rendering in str(rrule) was
๐ reported and fixed by Daniel LePage (@dplepage). (gh issue #262, pr #263) - A replace() method has been added to rrule objects by @jendas1, which creates
๐ new rrule with modified attributes, analogous to datetime.replace (gh pr #167) - ๐ Made some significant performance improvements to rrule objects in Python 2.x
(gh pr #245) - All classes defining equality functions now return NotImplemented when
๐ compared to unsupported classes, rather than raising TypeError, to allow other
๐ classes to provide fallback support. (gh pr #236) - Several classes have been marked as explicitly unhashable to maintain
identical behavior between Python 2 and 3. Submitted by Roy Williams
(@rowillia) (gh pr #296) - ๐ Trailing whitespace in easter.py has been removed. Submitted by @OmgImAlexis
(gh pr #299) - ๐ Windows-only batch files in build scripts had line endings switched to CRLF.
(gh pr #237) - ๐ @adamchainz updated the documentation links to reflect that the canonical
location for readthedocs links is now at .io, not .org. (gh pr #272) - ๐ท Made some changes to the CI and codecov to test against newer versions of
Python and pypy, and to adjust the code coverage requirements. For the moment,
๐ full pypy3 compatibility is not supported until a new release is available,
๐ due to upstream bugs in the old version affecting PEP-495 support.
(gh prs #265, #266, #304, #308) - ๐จ The full PGP signing key fingerprint was added to the README.md in favor of
the previously used long-id. Reported by @valholl (gh issue #287, pr #304) - โก๏ธ Updated zoneinfo to 2016i. (gh issue #298, gh pr #306)
- โ Added PEP-495-compatible methods to address ambiguous and imaginary dates in