205 lines
		
	
	
		
			8.0 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			205 lines
		
	
	
		
			8.0 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
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
 | 
						|
 | 
						|
 |