https://github.com/akoumjian/datefinder

Find dates inside text using Python and get back datetime objects
https://github.com/akoumjian/datefinder

datetime nlp parser

Last synced: about 2 months ago
JSON representation

Find dates inside text using Python and get back datetime objects

• Host: GitHub
• URL: https://github.com/akoumjian/datefinder
• Owner: akoumjian
• License: mit
• Created: 2016-01-02T22:23:12.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-05-13T14:05:22.000Z (4 months ago)
• Last Synced: 2024-05-17T16:49:29.100Z (4 months ago)
• Topics: datetime, nlp, parser
• Language: HTML
• Homepage: http://datefinder.readthedocs.org/en/latest/
• Size: 524 KB
• Stars: 625
• Watchers: 18
• Forks: 165
• Open Issues: 100
• Metadata Files:
  • Readme: README.rst
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
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

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

**Note:  I do not publish the version on conda forge and cannot verify its integrity.**

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