Metadata-Version: 2.1
Name: datefinder
Version: 0.7.3
Summary: Extract datetime objects from strings
Home-page: https://github.com/akoumjian/datefinder
Author: Alec Koumjian
Author-email: akoumjian@gmail.com
License: MIT
Keywords: datetime parser nlp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 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: Natural Language :: English
License-File: LICENSE
Requires-Dist: regex (>=2017.02.08)
Requires-Dist: python-dateutil (>=2.4.2)
Requires-Dist: pytz
Provides-Extra: dev
Requires-Dist: pytest (>=2.8.5) ; extra == 'dev'
Requires-Dist: mock ; extra == 'dev'
Requires-Dist: pytz (>=2015.7) ; extra == 'dev'
Requires-Dist: pylint (==2.1.1) ; extra == 'dev'
Provides-Extra: test
Requires-Dist: pytest (>=2.8.5) ; extra == 'test'
Requires-Dist: mock ; extra == 'test'
Requires-Dist: pytz (>=2015.7) ; extra == 'test'

datefinder - extract dates from text
====================================

.. image:: https://github.com/akoumjian/datefinder/actions/workflows/python-package.yml/badge.svg
    :target: https://github.com/akoumjian/datefinder
    :alt: Build Status

.. image:: https://img.shields.io/pypi/dm/datefinder.svg
    :target: https://pypi.python.org/pypi/datefinder/
    :alt: pypi downloads per day

.. image:: https://img.shields.io/pypi/v/datefinder.svg
    :target: https://pypi.python.org/pypi/datefinder
    :alt: pypi version

.. image:: https://img.shields.io/conda/v/conda-forge/datefinder?color=blue&logo=anaconda
    :target: https://anaconda.org/conda-forge/datefinder
    :alt: conda version


A python module for locating dates inside text. Use this package to extract all sorts 
of date like strings from a document and turn them into datetime objects.

This module finds the likely datetime strings and then uses  
`dateutil` to convert to the datetime object.


Installation
------------

**With pip**

.. code-block:: sh

    pip install datefinder

**With conda**

.. code-block:: sh

    conda install -c conda-forge datefinder

How to Use
----------


.. code-block:: python

    In [1]: string_with_dates = """
       ...: ...
       ...: entries are due by January 4th, 2017 at 8:00pm
       ...: ...
       ...: created 01/15/2005 by ACME Inc. and associates.
       ...: ...
       ...: """

    In [2]: import datefinder

    In [3]: matches = datefinder.find_dates(string_with_dates)

    In [4]: for match in matches:
       ...:     print match
       ...:
    2017-01-04 20:00:00
    2005-01-15 00:00:00


Demo
----

-  🎞️ `Video demo`_ by Calmcode.io. :star: 

.. _Video demo: https://calmcode.io/shorts/datefinder.py.html