Datediff

• Synopsis
• Examples
• Help

Synopsis

Running date diff calculations in shell can be tedious. This is where this tiny tool comes in.

Examples

$ datediff 2022-10-13T12:00:00 2022-10-15T19:00:00

55h0m0s

$ datediff -j 2022-10-01 2022-10-15

{
   "nanoseconds": 1209600000000000,
   "seconds": 1209600,
   "minutes": 20160,
   "hours": 336,
   "days": 14,
   "readable": "336h0m0s"
}

$ datediff now 2022-12-31

1768h59m0.48140367s

$ datediff today tomorrow -p seconds -r 0

86400

$ datediff now next_friday -p hours -r 2

63.98

$ datediff today next_odd_monday -p hours

144

$ datediff today next_year-11-11 -p days

389.0416666666667

Supported Date Layouts

Datediff tries to detect the format of the input date. The following are currently supported...

The following date layouts are supported


 Format              | Layout              | Comment
---------------------+---------------------+----------------------------------------
 YYYY-MM-DDTHH:MM:SS | 2006-01-02T15:04:05 |
 YYYY-MM-DDTHH:MM    | 2006-01-02T15:04    |
 YYYY-MM-DDTHH       | 2006-01-02T15       |
 YYYY-MM-DD          | 2006-01-02          | exact time set to 0:00:00
 MM-DD               | 01-02               | parser assumes date is in current year
 YYYYMMDD            | 20060102            |
 MMDD                | 0102                |

Help

a command line date differ

Arguments:
  [<date-1>]    date1, default 'now'
  [<date-2>]    date2, default 'tomorrow'

Flags:
  -h, --help                Show context-sensitive help.
  -p, --print="readable"    print format, display diff in a specific unit,
                            can be: nano,sec,min,hours,days
  -r, --round=-1            round output values to precision
  -j, --json                print full diff in json format
  -t, --toml                print full diff as toml
  -l, --formats             list supported date formats
  -v, --verbose             verbose mode, default format is json, use -t to
                            switch
  -V, --version-flag        display version