kuzmoyev/beautiful-date

Simple and beautiful way to create date and datetime objects in Python.

Beautiful Date

Simple and beautiful way to create date and datetime objects in Python.

Before:

from datetime import date, datetime

d = date(year=2018, month=3, day=25)
t = datetime(year=2018, month=3, day=25, hour=23, minute=45)

After:

from beautiful_date import *

d = 25/Mar/2018
t = (25/Mar/2018)[23:45]

Installation

pip install beautiful-date

Examples

Create Date

Using months names:

>>> from beautiful_date import *

>>> 25/Mar/2018  # European format
BeautifulDate(2018, 3, 25)
>>> Mar/25/2018  # US format
BeautifulDate(2018, 3, 25)

Using months numbers:

>>> 25/M[3]/2018  # European format
BeautifulDate(2018, 3, 25)
>>> M[3]/25/2018  # US format
BeautifulDate(2018, 3, 25)

Or alternatively:

>>> D @ 25/3/2018  # European format (default)
BeautifulDate(2018, 3, 25)

>>> D = MDY()  # Add this at the top of your script to use US format. 
>>> d = D @ 3/25/2018  # US format
BeautifulDate(2018, 3, 25)

You can also easily retrieve current date as a BeautifulDate object and current time using:

>>> D.today()
BeautifulDate(2020, 8, 24)

>>> D.now()
datetime.datetime(2020, 8, 24, 0, 59, 12, 451363)

>>> D.tomorrow()
BeautifulDate(2020, 8, 25)

>>> D.yesterday()
BeautifulDate(2020, 8, 23)

Create Datetime

Previous methods create BeautifulDate objects which are inherited from date but can be easily extended to datetime using indexing/slicing:

>>> (Oct/16/1995)[:]
datetime.datetime(1995, 10, 16, 0, 0)

>>> (Oct/16/1995)[23]
datetime.datetime(1995, 10, 16, 23, 0)

>>> (Oct/16/1995)[23:14]
datetime.datetime(1995, 10, 16, 23, 14)

>>> (Oct/16/1995)[23:14:10]
datetime.datetime(1995, 10, 16, 23, 14, 10)

You can also use prefix D @ if you need months by their numbers:

>>> (D @ 16/10/1995)[:]
datetime.datetime(1995, 10, 16, 0, 0)

>>> (D @ 16/10/1995)[23]
datetime.datetime(1995, 10, 16, 23, 0)

>>> (D @ 16/10/1995)[23:14]
datetime.datetime(1995, 10, 16, 23, 14)

>>> (D @ 16/10/1995)[23:14:10]
datetime.datetime(1995, 10, 16, 23, 14, 10)

Date/Datetime manipulations:

This library also provides simple interface for relativedelta from dateutil

Notice that singular time unit (year, month, ...) sets given value, plural (years, months,) adds it.

Shortcuts:

>>> 5*days.from_today
BeautifulDate(2023, 9, 17)

>>> 1*hours.from_now
datetime.datetime(2023, 9, 12, 12, 53, 56)

>>> 3*days.since(15/Mar/2023)
BeautifulDate(2023, 3, 18)

>>> 5*days.until_today
BeautifulDate(2023, 9, 7)

>>> 1*hours.until_now
datetime.datetime(2023, 9, 12, 11, 13, 4)

>>> 3*days.until(15/Mar/2023)
BeautifulDate(2023, 3, 12)

Adding/Subtracting/Setting timedeltas:

>>> d = 26/Mar/2018
>>> t = d[12:23:15]

>>> d + 2 * years
BeautifulDate(2020, 3, 26)
>>> d - 2 * days
BeautifulDate(2018, 3, 24)

>>> t + 25 * hours
datetime.datetime(2018, 3, 27, 13, 23, 15)

Available deltas: years, months, weeks, days, hours, minutes, seconds, microseconds, leapdays (see relativedelta).

>>> d = 26/Mar/2018
>>> t = d[12:23:15]

>>> d + 2022 * year
BeautifulDate(2022, 3, 26)
>>> d += 2 * day
>>> d
BeautifulDate(2018, 3, 2)

>>> t + 22 * hour
datetime.datetime(2018, 3, 26, 22, 23, 15)
>>> t += 22 * hour
>>> t
datetime.datetime(2018, 3, 26, 22, 23, 15)

Available setters: year, month, day, hour, minute, second, microsecond, yearday and nlyearday (see relativedelta).

Weekdays:

Get next Monday:

>>> d = 29/Mar/2018  # Thursday
>>> d + MO  # Equivalent to MO(1)
BeautifulDate(2018, 4, 2)

Get second to next Monday:

>>> d = 29/Mar/2018
>>> d + MO(2)
BeautifulDate(2018, 4, 9)

Get last Saturday:

>>> d = 29/Mar/2018
>>> d - SA
BeautifulDate(2018, 3, 24)

Get second to last Saturday:

>>> d = 29/Mar/2018
>>> d - SA(2)
BeautifulDate(2018, 3, 17)

Get second to last Saturday (same as previous):

>>> d = 29/Mar/2018
>>> d + SA(-2)
BeautifulDate(2018, 3, 17)

Util

drange:

You can use drange to generate ranges of dates:

>>> for d in drange(27/Mar/1994, 5/Apr/1994):
...     print(d)
1994-03-27
1994-03-28
1994-03-29
1994-03-30
1994-03-31
1994-04-01
1994-04-02
1994-04-03
1994-04-04

>>> for d in drange(27/Mar/1994, 5/Apr/1994, 2*days):
...     print(d)
1994-03-27
1994-03-29
1994-03-31
1994-04-02
1994-04-04

and datetimes:

>>> for dt in drange((27/Mar/1994)[10:25], (4/Apr/1994)[10:10]):
...     print(dt)
1994-03-27 10:25:00
1994-03-28 10:25:00
1994-03-29 10:25:00
1994-03-30 10:25:00
1994-03-31 10:25:00
1994-04-01 10:25:00
1994-04-02 10:25:00
1994-04-03 10:25:00

>>> for dt in drange((27/Mar/1994)[10:25], (4/Apr/1994)[10:10], 20*hours):
...     print(dt)
1994-03-27 10:25:00
1994-03-28 06:25:00
1994-03-29 02:25:00
1994-03-29 22:25:00
1994-03-30 18:25:00
1994-03-31 14:25:00
1994-04-01 10:25:00
1994-04-02 06:25:00
1994-04-03 02:25:00
1994-04-03 22:25:00

beautiful-date's Issues

Remove coverage.xml

Add today and now

Make date sortable

I tried to merge events from two calendars retrieved with https://github.com/kuzmoyev/google-calendar-simple-api like this:

events = list(feries[1 / Nov / 2020 : 30 / Nov / 2020])
events.extend(cours[1 / Nov / 2020 : 30 / Nov / 2020])
for event in sorted(events):

sorted fails. This may be solved with https://docs.python.org/3/library/functools.html#functools.total_ordering

What do you think about this idea?

Remove tests from the package

Change to parameters with default None

https://github.com/beautiful-everything/beautiful-date/blob/e7a46cd792ad374e8d89f60d8fb2e13972b61658/beautiful_date/date_range.py#L26

Use tox

Simplify drange __next__

https://github.com/beautiful-everything/beautiful-date/blob/e7a46cd792ad374e8d89f60d8fb2e13972b61658/beautiful_date/date_range.py#L57

Python code highlight in README

Support python 3.9-3.11

Simplify to one line

https://github.com/beautiful-everything/beautiful-date/blob/e7a46cd792ad374e8d89f60d8fb2e13972b61658/beautiful_date/date_range.py#L45

issue: Date should be rounder when added days

today = D.today()
print(today)
print(today + 5*day )

results
2021-08-29
2021-08-05 # should be 2021-09-05

Just a humble request to implement this if possible.

Format methods

Rails like syntax possible?

In Rails you can call datetime methods on integers that return datetime objects such as 1.month.from_now.

Would the package benefit from some addition like that? Perhaps add an option to enable/disable rails like datetime monkeypatching.

issue: possible feature list in error

D.today() + 0 # this cause error 

TypeError: unsupported operand type(s) for +: 'BeautifulDate' and 'int'

This can just return the same value, which makes it more dynamic
because I was using a variable in adding date D.today() + inputFromUser*days which can be zero
although I can check It before, but it will be better if beautiful-date do this 😌😄😁

Change to TypeError

TypeError: list indices must be integers or slices, not {type}

https://github.com/beautiful-everything/beautiful-date/blob/e7a46cd792ad374e8d89f60d8fb2e13972b61658/beautiful_date/beautiful_date.py#L32

Use GH actions for CI

Return `date` instead of `BeautifulDate` when timedeltas are used with `date`

`_RelativeDelta` should have user-friendly name

beautiful-date/beautiful_date/beautiful_timedelta.py

Line 7 in 5e16466

class _RelativeDelta(relativedelta):

Add to_date method to BeautifulDate

drange(start, count)

Timezone aware datetimes methods

E.x. datetime.now(timezone.utc) for D.now()
And .__contains__