123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204 |
- Metadata-Version: 2.1
- Name: python-dateutil
- Version: 2.8.2
- Summary: Extensions to the standard Python datetime module
- Home-page: https://github.com/dateutil/dateutil
- Author: Gustavo Niemeyer
- Author-email: gustavo@niemeyer.net
- Maintainer: Paul Ganssle
- Maintainer-email: dateutil@python.org
- License: Dual License
- Project-URL: Documentation, https://dateutil.readthedocs.io/en/stable/
- Project-URL: Source, https://github.com/dateutil/dateutil
- Platform: UNKNOWN
- Classifier: Development Status :: 5 - Production/Stable
- Classifier: Intended Audience :: Developers
- Classifier: License :: OSI Approved :: BSD License
- Classifier: License :: OSI Approved :: Apache Software License
- Classifier: Programming Language :: Python
- Classifier: Programming Language :: Python :: 2
- Classifier: Programming Language :: Python :: 2.7
- Classifier: Programming Language :: Python :: 3
- Classifier: Programming Language :: Python :: 3.3
- Classifier: Programming Language :: Python :: 3.4
- Classifier: Programming Language :: Python :: 3.5
- Classifier: Programming Language :: Python :: 3.6
- Classifier: Programming Language :: Python :: 3.7
- Classifier: Programming Language :: Python :: 3.8
- Classifier: Programming Language :: Python :: 3.9
- Classifier: Topic :: Software Development :: Libraries
- Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,>=2.7
- Description-Content-Type: text/x-rst
- License-File: LICENSE
- Requires-Dist: six (>=1.5)
- dateutil - powerful extensions to datetime
- ==========================================
- |pypi| |support| |licence|
- |gitter| |readthedocs|
- |travis| |appveyor| |pipelines| |coverage|
- .. |pypi| image:: https://img.shields.io/pypi/v/python-dateutil.svg?style=flat-square
- :target: https://pypi.org/project/python-dateutil/
- :alt: pypi version
- .. |support| image:: https://img.shields.io/pypi/pyversions/python-dateutil.svg?style=flat-square
- :target: https://pypi.org/project/python-dateutil/
- :alt: supported Python version
- .. |travis| image:: https://img.shields.io/travis/dateutil/dateutil/master.svg?style=flat-square&label=Travis%20Build
- :target: https://travis-ci.org/dateutil/dateutil
- :alt: travis build status
- .. |appveyor| image:: https://img.shields.io/appveyor/ci/dateutil/dateutil/master.svg?style=flat-square&logo=appveyor
- :target: https://ci.appveyor.com/project/dateutil/dateutil
- :alt: appveyor build status
- .. |pipelines| image:: https://dev.azure.com/pythondateutilazure/dateutil/_apis/build/status/dateutil.dateutil?branchName=master
- :target: https://dev.azure.com/pythondateutilazure/dateutil/_build/latest?definitionId=1&branchName=master
- :alt: azure pipelines build status
- .. |coverage| image:: https://codecov.io/gh/dateutil/dateutil/branch/master/graphs/badge.svg?branch=master
- :target: https://codecov.io/gh/dateutil/dateutil?branch=master
- :alt: Code coverage
- .. |gitter| image:: https://badges.gitter.im/dateutil/dateutil.svg
- :alt: Join the chat at https://gitter.im/dateutil/dateutil
- :target: https://gitter.im/dateutil/dateutil
- .. |licence| image:: https://img.shields.io/pypi/l/python-dateutil.svg?style=flat-square
- :target: https://pypi.org/project/python-dateutil/
- :alt: licence
- .. |readthedocs| image:: https://img.shields.io/readthedocs/dateutil/latest.svg?style=flat-square&label=Read%20the%20Docs
- :alt: Read the documentation at https://dateutil.readthedocs.io/en/latest/
- :target: https://dateutil.readthedocs.io/en/latest/
- The `dateutil` module provides powerful extensions to
- the standard `datetime` module, available in Python.
- Installation
- ============
- `dateutil` can be installed from PyPI using `pip` (note that the package name is
- different from the importable name)::
- pip install python-dateutil
- Download
- ========
- dateutil is available on PyPI
- https://pypi.org/project/python-dateutil/
- The documentation is hosted at:
- https://dateutil.readthedocs.io/en/stable/
- Code
- ====
- The code and issue tracker are hosted on GitHub:
- https://github.com/dateutil/dateutil/
- Features
- ========
- * Computing of relative deltas (next month, next year,
- next Monday, last week of month, etc);
- * Computing of relative deltas between two given
- date and/or datetime objects;
- * Computing of dates based on very flexible recurrence rules,
- using a superset of the `iCalendar <https://www.ietf.org/rfc/rfc2445.txt>`_
- specification. Parsing of RFC strings is supported as well.
- * Generic parsing of dates in almost any string format;
- * Timezone (tzinfo) implementations for tzfile(5) format
- files (/etc/localtime, /usr/share/zoneinfo, etc), TZ
- environment string (in all known formats), iCalendar
- format files, given ranges (with help from relative deltas),
- local machine timezone, fixed offset timezone, UTC timezone,
- and Windows registry-based time zones.
- * Internal up-to-date world timezone information based on
- Olson's database.
- * Computing of Easter Sunday dates for any given year,
- using Western, Orthodox or Julian algorithms;
- * A comprehensive test suite.
- Quick example
- =============
- Here's a snapshot, just to give an idea about the power of the
- package. For more examples, look at the documentation.
- Suppose you want to know how much time is left, in
- years/months/days/etc, before the next easter happening on a
- year with a Friday 13th in August, and you want to get today's
- date out of the "date" unix system command. Here is the code:
- .. code-block:: python3
- >>> from dateutil.relativedelta import *
- >>> from dateutil.easter import *
- >>> from dateutil.rrule import *
- >>> from dateutil.parser import *
- >>> from datetime import *
- >>> now = parse("Sat Oct 11 17:13:46 UTC 2003")
- >>> today = now.date()
- >>> year = rrule(YEARLY,dtstart=now,bymonth=8,bymonthday=13,byweekday=FR)[0].year
- >>> rdelta = relativedelta(easter(year), today)
- >>> print("Today is: %s" % today)
- Today is: 2003-10-11
- >>> print("Year with next Aug 13th on a Friday is: %s" % year)
- Year with next Aug 13th on a Friday is: 2004
- >>> print("How far is the Easter of that year: %s" % rdelta)
- How far is the Easter of that year: relativedelta(months=+6)
- >>> print("And the Easter of that year is: %s" % (today+rdelta))
- And the Easter of that year is: 2004-04-11
- Being exactly 6 months ahead was **really** a coincidence :)
- Contributing
- ============
- We welcome many types of contributions - bug reports, pull requests (code, infrastructure or documentation fixes). For more information about how to contribute to the project, see the ``CONTRIBUTING.md`` file in the repository.
- Author
- ======
- The dateutil module was written by Gustavo Niemeyer <gustavo@niemeyer.net>
- in 2003.
- It is maintained by:
- * Gustavo Niemeyer <gustavo@niemeyer.net> 2003-2011
- * Tomi Pieviläinen <tomi.pievilainen@iki.fi> 2012-2014
- * Yaron de Leeuw <me@jarondl.net> 2014-2016
- * Paul Ganssle <paul@ganssle.io> 2015-
- Starting with version 2.4.1 and running until 2.8.2, all source and binary
- distributions will be signed by a PGP key that has, at the very least, been
- signed by the key which made the previous release. A table of release signing
- keys can be found below:
- =========== ============================
- Releases Signing key fingerprint
- =========== ============================
- 2.4.1-2.8.2 `6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB`_
- =========== ============================
- New releases *may* have signed tags, but binary and source distributions
- uploaded to PyPI will no longer have GPG signatures attached.
- Contact
- =======
- Our mailing list is available at `dateutil@python.org <https://mail.python.org/mailman/listinfo/dateutil>`_. As it is hosted by the PSF, it is subject to the `PSF code of
- conduct <https://www.python.org/psf/conduct/>`_.
- License
- =======
- All contributions after December 1, 2017 released under dual license - either `Apache 2.0 License <https://www.apache.org/licenses/LICENSE-2.0>`_ or the `BSD 3-Clause License <https://opensource.org/licenses/BSD-3-Clause>`_. Contributions before December 1, 2017 - except those those explicitly relicensed - are released only under the BSD 3-Clause License.
- .. _6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB:
- https://pgp.mit.edu/pks/lookup?op=vindex&search=0xCD54FCE3D964BEFB
|