METADATA 8.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204
  1. Metadata-Version: 2.1
  2. Name: python-dateutil
  3. Version: 2.8.2
  4. Summary: Extensions to the standard Python datetime module
  5. Home-page: https://github.com/dateutil/dateutil
  6. Author: Gustavo Niemeyer
  7. Author-email: gustavo@niemeyer.net
  8. Maintainer: Paul Ganssle
  9. Maintainer-email: dateutil@python.org
  10. License: Dual License
  11. Project-URL: Documentation, https://dateutil.readthedocs.io/en/stable/
  12. Project-URL: Source, https://github.com/dateutil/dateutil
  13. Platform: UNKNOWN
  14. Classifier: Development Status :: 5 - Production/Stable
  15. Classifier: Intended Audience :: Developers
  16. Classifier: License :: OSI Approved :: BSD License
  17. Classifier: License :: OSI Approved :: Apache Software License
  18. Classifier: Programming Language :: Python
  19. Classifier: Programming Language :: Python :: 2
  20. Classifier: Programming Language :: Python :: 2.7
  21. Classifier: Programming Language :: Python :: 3
  22. Classifier: Programming Language :: Python :: 3.3
  23. Classifier: Programming Language :: Python :: 3.4
  24. Classifier: Programming Language :: Python :: 3.5
  25. Classifier: Programming Language :: Python :: 3.6
  26. Classifier: Programming Language :: Python :: 3.7
  27. Classifier: Programming Language :: Python :: 3.8
  28. Classifier: Programming Language :: Python :: 3.9
  29. Classifier: Topic :: Software Development :: Libraries
  30. Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,>=2.7
  31. Description-Content-Type: text/x-rst
  32. License-File: LICENSE
  33. Requires-Dist: six (>=1.5)
  34. dateutil - powerful extensions to datetime
  35. ==========================================
  36. |pypi| |support| |licence|
  37. |gitter| |readthedocs|
  38. |travis| |appveyor| |pipelines| |coverage|
  39. .. |pypi| image:: https://img.shields.io/pypi/v/python-dateutil.svg?style=flat-square
  40. :target: https://pypi.org/project/python-dateutil/
  41. :alt: pypi version
  42. .. |support| image:: https://img.shields.io/pypi/pyversions/python-dateutil.svg?style=flat-square
  43. :target: https://pypi.org/project/python-dateutil/
  44. :alt: supported Python version
  45. .. |travis| image:: https://img.shields.io/travis/dateutil/dateutil/master.svg?style=flat-square&label=Travis%20Build
  46. :target: https://travis-ci.org/dateutil/dateutil
  47. :alt: travis build status
  48. .. |appveyor| image:: https://img.shields.io/appveyor/ci/dateutil/dateutil/master.svg?style=flat-square&logo=appveyor
  49. :target: https://ci.appveyor.com/project/dateutil/dateutil
  50. :alt: appveyor build status
  51. .. |pipelines| image:: https://dev.azure.com/pythondateutilazure/dateutil/_apis/build/status/dateutil.dateutil?branchName=master
  52. :target: https://dev.azure.com/pythondateutilazure/dateutil/_build/latest?definitionId=1&branchName=master
  53. :alt: azure pipelines build status
  54. .. |coverage| image:: https://codecov.io/gh/dateutil/dateutil/branch/master/graphs/badge.svg?branch=master
  55. :target: https://codecov.io/gh/dateutil/dateutil?branch=master
  56. :alt: Code coverage
  57. .. |gitter| image:: https://badges.gitter.im/dateutil/dateutil.svg
  58. :alt: Join the chat at https://gitter.im/dateutil/dateutil
  59. :target: https://gitter.im/dateutil/dateutil
  60. .. |licence| image:: https://img.shields.io/pypi/l/python-dateutil.svg?style=flat-square
  61. :target: https://pypi.org/project/python-dateutil/
  62. :alt: licence
  63. .. |readthedocs| image:: https://img.shields.io/readthedocs/dateutil/latest.svg?style=flat-square&label=Read%20the%20Docs
  64. :alt: Read the documentation at https://dateutil.readthedocs.io/en/latest/
  65. :target: https://dateutil.readthedocs.io/en/latest/
  66. The `dateutil` module provides powerful extensions to
  67. the standard `datetime` module, available in Python.
  68. Installation
  69. ============
  70. `dateutil` can be installed from PyPI using `pip` (note that the package name is
  71. different from the importable name)::
  72. pip install python-dateutil
  73. Download
  74. ========
  75. dateutil is available on PyPI
  76. https://pypi.org/project/python-dateutil/
  77. The documentation is hosted at:
  78. https://dateutil.readthedocs.io/en/stable/
  79. Code
  80. ====
  81. The code and issue tracker are hosted on GitHub:
  82. https://github.com/dateutil/dateutil/
  83. Features
  84. ========
  85. * Computing of relative deltas (next month, next year,
  86. next Monday, last week of month, etc);
  87. * Computing of relative deltas between two given
  88. date and/or datetime objects;
  89. * Computing of dates based on very flexible recurrence rules,
  90. using a superset of the `iCalendar <https://www.ietf.org/rfc/rfc2445.txt>`_
  91. specification. Parsing of RFC strings is supported as well.
  92. * Generic parsing of dates in almost any string format;
  93. * Timezone (tzinfo) implementations for tzfile(5) format
  94. files (/etc/localtime, /usr/share/zoneinfo, etc), TZ
  95. environment string (in all known formats), iCalendar
  96. format files, given ranges (with help from relative deltas),
  97. local machine timezone, fixed offset timezone, UTC timezone,
  98. and Windows registry-based time zones.
  99. * Internal up-to-date world timezone information based on
  100. Olson's database.
  101. * Computing of Easter Sunday dates for any given year,
  102. using Western, Orthodox or Julian algorithms;
  103. * A comprehensive test suite.
  104. Quick example
  105. =============
  106. Here's a snapshot, just to give an idea about the power of the
  107. package. For more examples, look at the documentation.
  108. Suppose you want to know how much time is left, in
  109. years/months/days/etc, before the next easter happening on a
  110. year with a Friday 13th in August, and you want to get today's
  111. date out of the "date" unix system command. Here is the code:
  112. .. code-block:: python3
  113. >>> from dateutil.relativedelta import *
  114. >>> from dateutil.easter import *
  115. >>> from dateutil.rrule import *
  116. >>> from dateutil.parser import *
  117. >>> from datetime import *
  118. >>> now = parse("Sat Oct 11 17:13:46 UTC 2003")
  119. >>> today = now.date()
  120. >>> year = rrule(YEARLY,dtstart=now,bymonth=8,bymonthday=13,byweekday=FR)[0].year
  121. >>> rdelta = relativedelta(easter(year), today)
  122. >>> print("Today is: %s" % today)
  123. Today is: 2003-10-11
  124. >>> print("Year with next Aug 13th on a Friday is: %s" % year)
  125. Year with next Aug 13th on a Friday is: 2004
  126. >>> print("How far is the Easter of that year: %s" % rdelta)
  127. How far is the Easter of that year: relativedelta(months=+6)
  128. >>> print("And the Easter of that year is: %s" % (today+rdelta))
  129. And the Easter of that year is: 2004-04-11
  130. Being exactly 6 months ahead was **really** a coincidence :)
  131. Contributing
  132. ============
  133. 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.
  134. Author
  135. ======
  136. The dateutil module was written by Gustavo Niemeyer <gustavo@niemeyer.net>
  137. in 2003.
  138. It is maintained by:
  139. * Gustavo Niemeyer <gustavo@niemeyer.net> 2003-2011
  140. * Tomi Pieviläinen <tomi.pievilainen@iki.fi> 2012-2014
  141. * Yaron de Leeuw <me@jarondl.net> 2014-2016
  142. * Paul Ganssle <paul@ganssle.io> 2015-
  143. Starting with version 2.4.1 and running until 2.8.2, all source and binary
  144. distributions will be signed by a PGP key that has, at the very least, been
  145. signed by the key which made the previous release. A table of release signing
  146. keys can be found below:
  147. =========== ============================
  148. Releases Signing key fingerprint
  149. =========== ============================
  150. 2.4.1-2.8.2 `6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB`_
  151. =========== ============================
  152. New releases *may* have signed tags, but binary and source distributions
  153. uploaded to PyPI will no longer have GPG signatures attached.
  154. Contact
  155. =======
  156. 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
  157. conduct <https://www.python.org/psf/conduct/>`_.
  158. License
  159. =======
  160. 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.
  161. .. _6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB:
  162. https://pgp.mit.edu/pks/lookup?op=vindex&search=0xCD54FCE3D964BEFB