Skip to content

PyTime is an easy-use Python module which aims to operate date/time/datetime by string.

License

Notifications You must be signed in to change notification settings

shinux/PyTime

Repository files navigation

PyTime

Build StatusPyPI versionSupported Python versions

PyTime is an easy-use Python module which aims to operate date/time/datetime by string.

PyTime allows you using nonregular datetime string to generate and calculate datetime at most situation.

It Also provides you some simple useful methods for getting datetime you want.

Install

pipinstallpytime

Sample Usage

Calculate datetime all by string, accept unit for short or overall length, support out of order or in capital unit:

>>>frompytimeimportpytime>>>>>>pytime.before('2015.5.17', '2years 3mon 23week 3d 2hr') # 2years 3months 23weeks 3days 2hours before 2015.5.17datetime.datetime(2012, 9, 5, 22, 0) >>>>>>pytime.after(pytime.tomorrow('15.5.17'), '23month3dy29minu') # 23months 3days 29minutes after 2015-5-17's next daydatetime.datetime(2017, 4, 21, 0, 29)

Parse nonregular datetime string to datetime:

>>>pytime.parse('April 3rd 2015') datetime.date(2015, 4, 3) >>>pytime.parse('Oct, 1st. 2015') datetime.date(2015, 10, 1) >>>pytime.parse('NOV21th2015') datetime.date(2015, 11, 21) >>>>>>pytime.parse('2015517') datetime.date(2015, 5, 17) >>>>>>pytime.parse('5/17/15') datetime.date(2015, 5, 17) >>>>>>pytime.parse('92-11-2') datetime.date(1992, 11, 2) >>>>>>pytime.parse(1432310400) # support datetimestamp for all functiondatetime.datetime(2015, 5, 23, 0, 0)

Calculate week and month in a easy way. Normally we want to use these binate date in script, from Monday to next Monday which means 00:00:00-23:59:59, and Month from 1st to next 1st in the same way, but if you want clean date interval, you could set pytime.next_week(clean=True) to get the clean date for next week etc.

>>>pytime.this_week() (datetime.date(2015, 5, 11), datetime.date(2015, 5, 18)) >>>pytime.next_week('2015-6-14') # 2015-6-14's next week for script (datetime.date(2015, 6, 15), datetime.date(2015, 6, 23)) >>>pytime.last_week(pytime.mother(2013), True) # 2013 Mother's Day's last week (datetime.date(2013, 5, 13), datetime.date(2013, 5, 20)) >>>pytime.next_month('2015-10-1') (datetime.date(2015, 11, 1), datetime.date(2015, 12, 1))

Pytime support calculate timedelta by string even between date and datetime, merely set the date to that day's midnight:

>>>pytime.count('2015-5-17 23:23:23', pytime.tomorrow()) datetime.timedelta(1, 84203)

Get common festivals for designated year:

>>>pytime.father() # Father's Daydatetime.date(2015, 6, 21) >>>>>>pytime.mother(2016) # 2016 Mother's Daydatetime.date(2016, 5, 8) >>>>>>pytime.easter(1999) # 1999 Easterdatetime.date(1999, 4, 4) >>>pytime.vatertag(2020) # Fater's Day in Germanydatetime.date(2020, 5, 21)

Get days between two date.

>>>pytime.days_range('2015-5-17', '2015-5-23') [datetime.date(2015, 5, 23), datetime.date(2015, 5, 22), datetime.date(2015, 5, 21), datetime.date(2015, 5, 20), datetime.date(2015, 5, 19), datetime.date(2015, 5, 18), datetime.date(2015, 5, 17)]

...

and other useful methods.

Contributors

License

MIT

About

PyTime is an easy-use Python module which aims to operate date/time/datetime by string.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 6