Skip to main content

Extract datetime objects from strings

Project description

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

.. image:: https://img.shields.io/travis/akoumjian/datefinder/master.svg
:target: https://travis-ci.org/akoumjian/datefinder
:alt: travis 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/gitter/room/nwjs/nw.js.svg
:target: https://gitter.im/datefinder/Lobby
:alt: gitter chat


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 the
`dateparser <https://github.com/scrapinghub/dateparser>`_ package to convert
to the datetime object.


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

.. code-block:: sh

pip install datefinder


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


.. automodule:: datefinder
:members: find_dates


.. 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


Support
-------

You can talk to us on `Gitter <https://gitter.im/datefinder/Lobby>`_ or just submit an issue on `github <https://github.com/akoumjian/datefinder/issues/>`_.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

datefinder-0.6.1-py2.py3-none-any.whl (8.2 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page