Tiny date, time diff calculator with timers
Project description
pdd
pdd
(Python3 Date Diff) is a small cmdline utility to calculate date and time difference. It can also be used as a timer. If no program arguments are specified it shows the current date, time and timezone.
There are utilities and shell scripts which do what pdd
does. However, pdd
has been written with only one goal - simplicity. Users shouldn't have memorize anything.
Love smart and efficient terminal utilities? Explore my repositories. Buy me a cup of coffee if they help you.
Table of Contents
Features
- easy to use, minimal dependencies
- calculate date and time difference
- calculate diff from today and now
- add, subtract duration (timeslice) to/from date (time)
- countdown timer
- custom resolution stopwatch
- non-verbose mode for background timers
- show current date, time and timezone
Installation
Dependencies
pdd
requires Python 3.5 (or later) and the dateutil
module.
To install dateutil
on Ubuntu, run:
$ sudo apt-get install python3-dateutil
or, using pip3:
$ sudo pip3 install python-dateutil
From a package manager
- AUR (
pacman -S pdd
) - Debian (
apt-get install pdd
) - Fedora (
dnf install pdd
) - NixOS (
nix-env -i pdd
) - PyPi (
pip3 install pdd
) - Ubuntu (
apt-get install pdd
) - Ubuntu PPA (
apt-get install pdd
) - Void Linux (
xbps-install -S pdd
)
Release packages
Packages for Arch Linux, CentOS, Debian, Fedora and Ubuntu are available with the latest stable release.
From source
If you have git installed, clone this repository. Otherwise download the latest latest stable release or development version (risky).
Install to default location (/usr/local
):
$ sudo make install
To remove, run:
$ sudo make uninstall
PREFIX
is supported, in case you want to install to a different location.
Running standalone
pdd
is a standalone utility. From the containing directory, run:
$ ./pdd.py
Usage
cmdline options
usage: pdd [-h] [-d dd mmm yyyy [dd mmm yyyy | d m y]]
[-t hh:mm:ss [hh:mm:ss | h:m:s]] [--add] [--sub]
[--day dd mmm yyyy] [-c hh:mm:ss] [-s [resolution]] [-q]
[keywords [keywords ...]]
Tiny date, time difference calculator with timers.
positional arguments:
keywords diff/add/subtract from today or now
optional arguments:
-h, --help show this help message and exit
-d dd mmm yyyy [dd mmm yyyy | d m y]
calculate date difference
-t hh:mm:ss [hh:mm:ss | h:m:s]
calculate time difference
--add add to date (/today) or time (/now)
--sub subtract from date (/today) or time (/now)
--day dd mmm yyyy show day of the week on a date
-c hh:mm:ss start a countdown timer
-s [resolution] start a stopwatch (default resolution: ms)
-q quiet mode for background timer/stopwatch
Operational notes
- Time is in 24-hr format.
- Month can be specified as month number (e.g. Jan - 1, Dec - 12).
- The absolute difference is shown. Argument order is ignored.
- The end date is excluded in date difference calculations.
- Hour, minute or second can be omitted. Partial inputs are recognized as
mm:ss
orss
. - The keybind to stop timers is Ctrl-C.
Examples
-
Calculate diff from today:
$ pdd 15 Jan 2014
-
Calculate diff from now:
$ pdd 24:00:00 $ pdd 0
-
Calculate date diff:
$ pdd -d 3 jul 1983 15 1 2014
-
Calculate time diff:
$ pdd -t 45:50 6:17:33
-
Show current date, time and timezone:
$ pdd
-
Specify time with roll-over:
$ pdd -t 5:80:75 6:17:33
-
Add a duration (1 day, 2 months, 3 years) to 28 Feb, 2000:
$ pdd -d 28 FEB 2000 1 2 3 --add
-
Add a timeslice (1 hour 2 mins 3 secs) to 23:45:37:
$ pdd -t 23:45:37 1:2:3 --add
-
Add a duration (1 day, 2 months, 3 years) to today:
$ pdd 1 2 3 --add
-
Add a timeslice (1 hour 2 minutes 3 seconds) to now:
$ pdd 1:2:3 --add
-
Subtract a duration (1 day) from 1 Mar, 2000:
$ pdd -d 01 Mar 2000 1 0 0 --sub
-
Subtract a timeslice (1 sec) from midnight:
$ pdd -t 00:00:00 0:0:1 --sub
-
Subtract a duration (1 day, 2 months, 3 years) from today:
$ pdd 1 2 3 --sub
-
Subtract a timeslice (1 hour 2 minutes 3 seconds) from now:
$ pdd 1:2:3 --sub
-
Show the day of the week on 15 Jan 2014:
$ pdd --day 15 Jan 2014
-
Start a countdown timer or stopwatch in quiet mode in the background:
$ pdd -qs & $ pdd -qc 3:0:0 &
To see the final counter run
fg
and press Ctrl-C.
Copyright
Copyright © 2017 Arun Prakash Jana
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.