<h1 align="center">pdd</h1>
<p align="center">
<a href="https://github.com/jarun/pdd/releases/latest"><img src="https://img.shields.io/github/release/jarun/pdd.svg?maxAge=600" alt="Latest release" /></a>
<a href="https://repology.org/project/pdd/versions"><img src="https://repology.org/badge/tiny-repos/pdd.svg" alt="Availability"></a>
<a href="https://pypi.org/project/pdd/"><img src="https://img.shields.io/pypi/v/pdd.svg?maxAge=600" alt="PyPI" /></a>
<a href="https://circleci.com/gh/jarun/workflows/pdd"><img src="https://img.shields.io/circleci/project/github/jarun/pdd.svg" alt="Build Status" /></a>
<a href="https://github.com/jarun/pdd/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-GPLv3-yellowgreen.svg?maxAge=2592000" alt="License" /></a>
</p>
<p align="center">
<a href="https://asciinema.org/a/189581"><img src="https://asciinema.org/a/189581.svg" alt="Asciicast" width="650"/></a>
</p>
`pdd` (Python3 Date Diff) is a tiny command line 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.
`pdd` has been written with only one goal - simplicity. Users shouldn't have to memorize anything.
### Table of Contents
- [Features](#features)
- [Installation](#installation)
- [Dependencies](#dependencies)
- [From a package manager](#from-a-package-manager)
- [Release packages](#release-packages)
- [From source](#from-source)
- [Running standalone](#running-standalone)
- [Usage](#usage)
- [cmdline options](#cmdline-options)
- [Operational notes](#operational-notes)
- [Examples](#examples)
- [Copyright](#copyright)
### 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 with command piggybacking
- custom resolution stopwatch
- non-verbose mode for background timers
- show current date, time and timezone
- follows ISO 8601
### Installation
#### Dependencies
`pdd` requires Python 3.7 (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
Install `pdd` from your package manager. If the version available is dated try an alternative installation method.
<details><summary>Packaging status (expand)</summary>
<p>
<br>
<a href="https://repology.org/project/pdd/versions"><img src="https://repology.org/badge/vertical-allrepos/pdd.svg" alt="Packaging status"></a>
</p>
Unlisted packagers:
<p>
<br>
● <a href="https://pypi.org/project/pdd/">PyPI</a> (<code>pip3 install pdd</code>)<br>
● Termux (<code>pip3 install pdd</code>)<br>
</p>
</details>
#### Release packages
Packages for Arch Linux, CentOS, Debian, Fedora and Ubuntu are available with the [latest stable release](https://github.com/jarun/pdd/releases/latest).
#### From source
If you have git installed, clone this repository. Otherwise download the latest [latest stable release](https://github.com/jarun/pdd/releases/latest) or [development version](https://github.com/jarun/pdd/archive/master.zip) (*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:
$ chmod +x pdd
$ ./pdd
### Usage
#### cmdline options
```
usage: pdd [-h] [-d yyyy mmm dd [yyyy mmm dd | y m d]]
[-t hh:mm:ss [hh:mm:ss | h:m:s]] [--add] [--sub]
[--day yyyy mmm dd] [-c hh:mm:ss] [-r command] [-s [resolution]] [-q]
[keywords ...]
Tiny date, time difference calculator with timers.
positional arguments:
keywords diff/add/subtract from today or now
options:
-h, --help show this help message and exit
-d yyyy mmm dd [yyyy mmm dd | y m d], --date yyyy mmm dd [yyyy mmm dd | y m d]
calculate date difference
-t hh:mm:ss [hh:mm:ss | h:m:s], --time 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 yyyy mmm dd show day of the week on a date
-c hh:mm:ss, --timer hh:mm:ss
start a countdown timer
-r command, --run command
run command when countdown timer reaches 0
-s [resolution], --stopwatch [resolution]
start a stopwatch [default resolution: 3 (ms)]
-q, --quiet quiet mode for background timer/stopwatch
```
Completion scripts are available for Bash, Fish and Zsh shells.
#### Operational notes
- ISO 8601 format. Month can be specified as month number (e.g. Jan - 1, Dec - 12).
- Time is in 24-hr format.
- 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` or `ss`.
- The keybind to stop timers is <kbd>Ctrl-C</kbd>.
### Examples
1. Calculate diff from **today**:
$ pdd 2014 Jan 15
5y 2m 21d
1906d
2. Calculate diff from **now**:
$ pdd 24:00:00
15:24:03
55443s
$ pdd 0
08:36:22
30982s
3. Calculate date diff:
$ pdd -d 1983 jul 3 2014 1 15
30y 6m 12d
11154d
4. Calculate time diff:
$ pdd -t 45:50 6:17:33
05:31:43
19903s
5. Show current date, time and timezone:
$ pdd
Fri 2019 Apr 5 08:37:25 IST
6. Specify time with roll-over:
$ pdd -t 5:80:75 6:17:33
00:03:42
222s
7. Add a duration (3 years, 2 months, 1 day) to 28 Feb, 2000:
$ pdd -d 2000 FEB 28 3 2 1 --add
Tue 2003 Apr 29
8. Add a timeslice (1 hour 2 mins 3 secs) to 23:45:37:
$ pdd -t 23:45:37 1:2:3 --add
1 day(s) later, 00:47:40
89260s
9. Add a duration (3 years, 2 months, 1 day) to **today**:
$ pdd 3 2 1 --add
Mon 2022 Jun 06
10. Add a timeslice (1 hour 2 minutes 3 seconds) to **now**:
$ pdd 1:2:3 --add
09:41:26
34886s
11. Subtract a duration (1 day) from 1 Mar, 2000:
$ pdd -d 2000 Mar 01 0 0 1 --sub
Tue 2000 Feb 29
12. Subtract a timeslice (1 sec) from midnight:
$ pdd -t 00:00:00 0:0:1 --sub
1 day(s) earlier, 23:59:59
-1s
13. Subtract a duration (3 years, 2 months, 1 day) from **today**:
$ pdd 3 2 1 --sub
Thu 2016 Feb 04
14. Subtract a timeslice (1 hour 2 minutes 3 seconds) from **now**:
$ pdd 1:2:3 --sub
07:40:02
27602s
15. Show the day of the week on 15 Jan 2014:
$ pdd --day 2014 Jan 15
Wed
16. 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 <kbd>Ctrl-C</kbd>.
17. Run a command when countdown timer reaches 0
$ pdd -c 00:00:5 -r 'ps -aux'
$ pdd -c 00:00:5 -r 'notify-send pdd "timer expired"'
### Copyright
Copyright © 2017 [Arun Prakash Jana](https://github.com/jarun)
Raw data
{
"_id": null,
"home_page": "https://github.com/jarun/pdd",
"name": "pdd",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "date time calculator timer",
"author": "Arun Prakash Jana",
"author_email": "engineerarun@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/97/bb/c36c635fb76dd41f153adcbc43cc4f39208a6bee9be0dcac926d7af85b6e/pdd-1.7.tar.gz",
"platform": "any",
"description": "<h1 align=\"center\">pdd</h1>\n\n<p align=\"center\">\n<a href=\"https://github.com/jarun/pdd/releases/latest\"><img src=\"https://img.shields.io/github/release/jarun/pdd.svg?maxAge=600\" alt=\"Latest release\" /></a>\n<a href=\"https://repology.org/project/pdd/versions\"><img src=\"https://repology.org/badge/tiny-repos/pdd.svg\" alt=\"Availability\"></a>\n<a href=\"https://pypi.org/project/pdd/\"><img src=\"https://img.shields.io/pypi/v/pdd.svg?maxAge=600\" alt=\"PyPI\" /></a>\n<a href=\"https://circleci.com/gh/jarun/workflows/pdd\"><img src=\"https://img.shields.io/circleci/project/github/jarun/pdd.svg\" alt=\"Build Status\" /></a>\n<a href=\"https://github.com/jarun/pdd/blob/master/LICENSE\"><img src=\"https://img.shields.io/badge/license-GPLv3-yellowgreen.svg?maxAge=2592000\" alt=\"License\" /></a>\n</p>\n\n<p align=\"center\">\n<a href=\"https://asciinema.org/a/189581\"><img src=\"https://asciinema.org/a/189581.svg\" alt=\"Asciicast\" width=\"650\"/></a>\n</p>\n\n`pdd` (Python3 Date Diff) is a tiny command line 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.\n\n`pdd` has been written with only one goal - simplicity. Users shouldn't have to memorize anything.\n\n### Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n - [Dependencies](#dependencies)\n - [From a package manager](#from-a-package-manager)\n - [Release packages](#release-packages)\n - [From source](#from-source)\n - [Running standalone](#running-standalone)\n- [Usage](#usage)\n - [cmdline options](#cmdline-options)\n - [Operational notes](#operational-notes)\n- [Examples](#examples)\n- [Copyright](#copyright)\n\n### Features\n\n- easy to use, minimal dependencies\n- calculate date and time difference\n- calculate diff from *today* and *now*\n- add, subtract duration (timeslice) to/from date (time)\n- countdown timer with command piggybacking\n- custom resolution stopwatch\n- non-verbose mode for background timers\n- show current date, time and timezone\n- follows ISO 8601\n\n### Installation\n\n#### Dependencies\n\n`pdd` requires Python 3.7 (or later) and the `dateutil` module.\n\nTo install `dateutil` on Ubuntu, run:\n\n $ sudo apt-get install python3-dateutil\n\nor, using pip3:\n\n $ sudo pip3 install python-dateutil\n\n#### From a package manager\n\nInstall `pdd` from your package manager. If the version available is dated try an alternative installation method.\n\n<details><summary>Packaging status (expand)</summary>\n<p>\n<br>\n<a href=\"https://repology.org/project/pdd/versions\"><img src=\"https://repology.org/badge/vertical-allrepos/pdd.svg\" alt=\"Packaging status\"></a>\n</p>\nUnlisted packagers:\n<p>\n<br>\n\u25cf <a href=\"https://pypi.org/project/pdd/\">PyPI</a> (<code>pip3 install pdd</code>)<br>\n\u25cf Termux (<code>pip3 install pdd</code>)<br>\n</p>\n</details>\n\n#### Release packages\n\nPackages for Arch Linux, CentOS, Debian, Fedora and Ubuntu are available with the [latest stable release](https://github.com/jarun/pdd/releases/latest).\n\n#### From source\n\nIf you have git installed, clone this repository. Otherwise download the latest [latest stable release](https://github.com/jarun/pdd/releases/latest) or [development version](https://github.com/jarun/pdd/archive/master.zip) (*risky*).\n\nInstall to default location (`/usr/local`):\n\n $ sudo make install\n\nTo remove, run:\n\n $ sudo make uninstall\n\n`PREFIX` is supported, in case you want to install to a different location.\n\n#### Running standalone\n\n`pdd` is a standalone utility. From the containing directory, run:\n\n $ chmod +x pdd\n $ ./pdd\n\n### Usage\n\n#### cmdline options\n\n```\nusage: pdd [-h] [-d yyyy mmm dd [yyyy mmm dd | y m d]]\n [-t hh:mm:ss [hh:mm:ss | h:m:s]] [--add] [--sub]\n [--day yyyy mmm dd] [-c hh:mm:ss] [-r command] [-s [resolution]] [-q]\n [keywords ...]\n\nTiny date, time difference calculator with timers.\n\npositional arguments:\n keywords diff/add/subtract from today or now\n\noptions:\n -h, --help show this help message and exit\n -d yyyy mmm dd [yyyy mmm dd | y m d], --date yyyy mmm dd [yyyy mmm dd | y m d]\n calculate date difference\n -t hh:mm:ss [hh:mm:ss | h:m:s], --time hh:mm:ss [hh:mm:ss | h:m:s]\n calculate time difference\n --add add to date (/today) or time (/now)\n --sub subtract from date (/today) or time (/now)\n --day yyyy mmm dd show day of the week on a date\n -c hh:mm:ss, --timer hh:mm:ss\n start a countdown timer\n -r command, --run command\n run command when countdown timer reaches 0\n -s [resolution], --stopwatch [resolution]\n start a stopwatch [default resolution: 3 (ms)]\n -q, --quiet quiet mode for background timer/stopwatch\n```\n\nCompletion scripts are available for Bash, Fish and Zsh shells.\n\n#### Operational notes\n\n- ISO 8601 format. Month can be specified as month number (e.g. Jan - 1, Dec - 12).\n- Time is in 24-hr format.\n- The absolute difference is shown. Argument order is ignored.\n- The end date is excluded in date difference calculations.\n- Hour, minute or second can be omitted. Partial inputs are recognized as `mm:ss` or `ss`.\n- The keybind to stop timers is <kbd>Ctrl-C</kbd>.\n\n### Examples\n\n1. Calculate diff from **today**:\n\n $ pdd 2014 Jan 15\n 5y 2m 21d\n 1906d\n\n2. Calculate diff from **now**:\n\n $ pdd 24:00:00\n 15:24:03\n 55443s\n\n $ pdd 0\n 08:36:22\n 30982s\n\n3. Calculate date diff:\n\n $ pdd -d 1983 jul 3 2014 1 15\n 30y 6m 12d\n 11154d\n\n4. Calculate time diff:\n\n $ pdd -t 45:50 6:17:33\n 05:31:43\n 19903s\n\n5. Show current date, time and timezone:\n\n $ pdd\n Fri 2019 Apr 5 08:37:25 IST\n\n6. Specify time with roll-over:\n\n $ pdd -t 5:80:75 6:17:33\n 00:03:42\n 222s\n\n7. Add a duration (3 years, 2 months, 1 day) to 28 Feb, 2000:\n\n $ pdd -d 2000 FEB 28 3 2 1 --add\n Tue 2003 Apr 29\n\n8. Add a timeslice (1 hour 2 mins 3 secs) to 23:45:37:\n\n $ pdd -t 23:45:37 1:2:3 --add\n 1 day(s) later, 00:47:40\n 89260s\n\n9. Add a duration (3 years, 2 months, 1 day) to **today**:\n\n $ pdd 3 2 1 --add\n Mon 2022 Jun 06\n\n10. Add a timeslice (1 hour 2 minutes 3 seconds) to **now**:\n\n $ pdd 1:2:3 --add\n 09:41:26\n 34886s\n\n11. Subtract a duration (1 day) from 1 Mar, 2000:\n\n $ pdd -d 2000 Mar 01 0 0 1 --sub\n Tue 2000 Feb 29\n\n12. Subtract a timeslice (1 sec) from midnight:\n\n $ pdd -t 00:00:00 0:0:1 --sub\n 1 day(s) earlier, 23:59:59\n -1s\n\n13. Subtract a duration (3 years, 2 months, 1 day) from **today**:\n\n $ pdd 3 2 1 --sub\n Thu 2016 Feb 04\n\n14. Subtract a timeslice (1 hour 2 minutes 3 seconds) from **now**:\n\n $ pdd 1:2:3 --sub\n 07:40:02\n 27602s\n\n15. Show the day of the week on 15 Jan 2014:\n\n $ pdd --day 2014 Jan 15\n Wed\n\n16. Start a countdown timer or stopwatch in **quiet mode** in the background:\n\n $ pdd -qs &\n $ pdd -qc 3:0:0 &\n To see the final counter run `fg` and press <kbd>Ctrl-C</kbd>.\n\n17. Run a command when countdown timer reaches 0\n\n $ pdd -c 00:00:5 -r 'ps -aux'\n $ pdd -c 00:00:5 -r 'notify-send pdd \"timer expired\"'\n\n### Copyright\n\nCopyright \u00a9 2017 [Arun Prakash Jana](https://github.com/jarun)\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "Tiny date, time diff calculator with timers",
"version": "1.7",
"split_keywords": [
"date",
"time",
"calculator",
"timer"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "c50e37541e889d1ccc44b1bcc8f4406b",
"sha256": "5ab66883a55eb59a70db0f90476e0134edfb32c52e8b9b91489bea1b06ced293"
},
"downloads": -1,
"filename": "pdd-1.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c50e37541e889d1ccc44b1bcc8f4406b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 20408,
"upload_time": "2022-12-03T02:55:08",
"upload_time_iso_8601": "2022-12-03T02:55:08.578201Z",
"url": "https://files.pythonhosted.org/packages/d9/84/8f2e3b47c059356b6de96ced9a08a83d5599e324bb3a9b570d345f8d3d2c/pdd-1.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "bc5d6fbe97b7a9552b868c5fd068abac",
"sha256": "c532faf070fc98c5d1e81df953450f54dc8d96b243fbe06a29c5c979182113a5"
},
"downloads": -1,
"filename": "pdd-1.7.tar.gz",
"has_sig": false,
"md5_digest": "bc5d6fbe97b7a9552b868c5fd068abac",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 22158,
"upload_time": "2022-12-03T02:55:11",
"upload_time_iso_8601": "2022-12-03T02:55:11.105387Z",
"url": "https://files.pythonhosted.org/packages/97/bb/c36c635fb76dd41f153adcbc43cc4f39208a6bee9be0dcac926d7af85b6e/pdd-1.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-03 02:55:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "jarun",
"github_project": "pdd",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pdd"
}
JSON
