A handy python function to parse and convert to and between datetime.datetime, int, and string objects
Project description
date_to - A light-weight, handy date converter
Convert any date to another with just one friendly function
date_to()
will convert your dates between datetime objects, unix timestamps, and strings. No more boilerplate and headaches of trying to keep track of your dates and their (lack) of timezones.
date_to
utilises the dateparser library for string parsing, enabling many kinds of string representations of time to be converted into machine interpretable dates.
All output dates are rounded to second precision. Default conversion is to the UTC timezone.
If you wish to change this conversion behaviour you can add a dict of keyword arguments to the function's parser_settings=
optional keyword argument. Please refer to the dateparser documentation for possible settings
Basic Use
from date_to import date_to
some_date = "2001-09-11 17:20 EDT"
a = date_to(some_date, str)
b = date_to(some_date, int)
c = date_to(some_date, "datetime")
print(type(a), a)
print(type(b), b)
print(type(c), c)
Output:
<class 'str'> "2001-09-11T21:20:00+00:00"
<class 'int'> 1000243200
<class 'datetime.datetime'> 2001-09-11 21:20:00+00:00
Installation
The date_to
library is available on PyPi and easily installed using pip:
pip install date_to
Accepted Inputs
from datetime import datetime
accepted_object_inputs = int | str | datetime.date
accepted_string_inputs = {
"str": ["str", "string", "text",],
"date": ["date", "datetime.date", "datetime",],
"int": ["int", "timestamp", "epoch", "unix", "float",],
}
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.