date-time-literal 1.1.0

date-time-literal is a python module that helps convert date-time or date to literal days, hours, seconds, or even minutes. Compare two DateTime or Date objects, by converting the objects to literal days, hours, minutes, or even seconds if you want to be precise.

date_literal

A package/module for converting date or date-time formats to literal days, hours, minutes, or seconds for comparison or whatever. For example, you can convert DateTime objects to know just how much of a difference there is between them, or you just want to get the human-readable format of DateTime or Date objects.

Installation

pip install date_time_literal

Usage

IMPORTANT

DateTime or Date objects must be in the default 'Y-M-D Hr:Min:Sec' and 'Y-M-D' formats respectively.

Converts Date Time Literal

from django.utils import timezone
time = timezone.now()
from date_time_literal import ConvertTime
convert_time = ConvertTime(time).convert_time

Converts Date Literal

convert_time = ConvertTime(time).convert This returns the date or date_time in seconds. You can add an optional parameter to specify what you want.

Note: You can use the convert class function on a DateTime object if you wish to use only the date part of the DateTime object, but cannot use the convert_time class function on a Date object, only on DateTime objects.

Specific conversion to days

from django.utils import timezone
from datetime import datetime
from date_time_literal import ConvertTime

time2 = datetime.now()
time = timezone.now()

convert_time = ConvertTime(time, 'd').convert_time
convert_time2 = ConvertTime(time2, 'd').convert

Specific conversion to hours

from date_time_literal import ConvertTime
from datetime import datetime
time = datetime.now()
convert_time = ConvertTime(time, 'd').convert_time # Converts the DateTime object to days
convert_time1 = ConvertTime(time, 'h').convert_time # Converts the DateTime object to hours
convert_time2 = ConvertTime(time, 'm').convert_time # Converts the DateTime object to minutes

# The default conversion if none is specified is to seconds

CHECK DATE-TIME OR DATE DIFFERENCE BETWEEN TWO DATE-TIME OR DATE OBJECTS

from date_time_literal import ConvertTime
from datetime import datetime
from django.utils import timezone
time = datetime.now()
convert_time = ConvertTime(time, 'h').convert_time
from date_time_literal import date_time_diff, date_diff
convert_time2 = ConvertTime(time, 'm').convert_time
date1 = '2021-05-31'
date2 = '2021-03-21'
date_time1 = timezone.now()
date_time2 = '2021-03-21 23:16:45.735963'
date_l = date_diff(date1, date2, 'd')
date_time_l = date_time_diff(date_time1, date_time2, 'd')

# date_time_l will return the difference in value between date_time1 and date_time2 in days. You can use the 
# corresponding string literal to get for minutes, hours and seconds which is the default value.
# date_time_diff returns the difference in two dateTimes to the second. This should be used when you need to get 
# date time difference to the last second

Convert between time and date objects

You can also use the convert_time function to convert between times

from date_time_literal import convert_time

# Converts between years, days, hours, minutes, and seconds
print(convert_time(365, 'd', 'y')) # Converts 365 days to years
print(convert_time(5, 'y', 'd')) # Converts 5 years to days
print(convert_time(5, 'y', 'h')) # Converts 5 years to hours
print(convert_time(5, 'd', 's')) # Converts 5 days to seconds
# etc

Some Basic use cases

To get a rather comprehensive idea of how the package works, copy the code below and run it. The convert_time function was updated to be more efficient and now allows for week conversion as well in version 1.0.8

from date_time_literal import ConvertTime, DateDiff, date_diff, convert_time, date_time_diff
from datetime import datetime

t = ConvertTime('2021-05-31 23:16:55.321568', 'd')
p = ConvertTime(datetime.now(), 'd')
i = ConvertTime('2021-05-31 23:16:55+00:00', 'd')
d = ConvertTime('2021-05-31', time_format='d')
e = DateDiff('2021-05-31', '2021-04-31', 'd')
print(t.convert_time)
print(i.convert_time)
print(d.convert)
print(e.date_diff)
print(date_diff('2021-08-31', '2021-05-30', 'D'))
print(date_time_diff('2021-04-30 21:58:50+00:00', '2021-04-30 10:58:55+00:00', 'H'))
print(convert_time(1, "y", 'h'))
print(convert_time(365, 'd', 'y'))