dte 0.0.7

Date Time Expressions

Date Time Expression

dte is a WIP date-time processing language with focus on broad interpretation and simplicity.

If you don't think it's intuitive, it's most likely unfinished.

It is strongly inspired by pdd.

How to use & What to know

Install

pip install dte

Conventions

• Dates are always interpreted with highest units appearing before, e.g.: %Y-%m-%d or %Y %b %d formats, although the unit separator doesn't have to be "-" for the former
• Unix timestamps are both interpreted and output in seconds
• When using timedeltas, you should remember that m is for month and M is for minute
• When writing time, remember to use 24-hour clock

Dependencies

• dateutil, which handles month and year's complex operations
• ply, which is a python implementation of lex and yacc
• appdirs, for reading config file in a cross-platform manner

Examples

date and difference

dte 1957-12-26 - today in days - returns -23041.0

time and difference

dte 12h:00 AM + 4h - returns 16:00:00

dte '12h:00 AM == 12h:00 PM' - returns True

dte 23h:23 - returns 23:23:00

dte 23M:23 - returns 00:23:23

week days

dte monday - returns the closest weekday date

dte last tuesday - returns last tuesday's date

dte next tue - returns next tuesday's date

dte 1611193453.dow - returns wednesday in UTC-03:00

the in keyword

dte 1d in hours - returns the amount of hours in a day

dte 1959 Jan 26 in unix - returns the unix timestamp for the date

operators

dte '2018 Jan 28 + 3y > 2021 Jan 26' - returns True

delta declaration and operations

dte 1d - declares a one day timedelta

dte 7y6m5w4d3h2M1s - represents 2776 days, 3:02:00

dte 1d2M+2M+3h - results in 1 day, 3:04:00

dte -100.5d - accepts negative and/or floating point values

and in case you need it

dte help - prints a detailed manual

Configuration File

dte tries to read a config.json file under config directory (~/.config/dte/ on Linux). In it you can set the following options:

{
  "timestamp_unit": "<seconds|milliseconds>"
  "datetime_output_format": "<ISO8601|<format>>"
}

To do

• floating-point time units
• subtract delta from date
• add delta week month year
• help
• closest weekday
• python-like comparison
• wait(x)
• timestamp object
• next/last(weekday)
• in keyword
  • add geolocation? 18H:00 in England?
  • last friday in 2014
  • last friday in April
  • last friday in April 2014
• format(timepoint, fmt) (in keyword)units given current time field
• add option
  • to use locale and custom formats for i/o
  • to set unix timestamp format (seconds, millis, etc)
• add tab-completion for:
  • months
  • units given current time field or second hand of in keyword
• continuous integration
• parse month & abbrev
• parse weekday & abbrev