timecalc 0.4.13

Calculate the total duration of a given set of intervals and durations
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

[![ci](https://github.com/Granddave/timecalc-rs/actions/workflows/ci.yml/badge.svg)](https://github.com/Granddave/timecalc-rs/actions)
[![dependency status](https://deps.rs/repo/github/granddave/timecalc-rs/status.svg)](https://deps.rs/repo/github/granddave/timecalc-rs)
[![Crates.io Version](https://img.shields.io/crates/v/timecalc)](https://crates.io/crates/timecalc)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

# timecalc

Timecalc is a simple CLI tool that calculates the total time spent on a project given intervals and durations.

This is the Rust implementation of my [previous tool written in Python](https://github.com/Granddave/timecalc).

Timecalc is available as both a [crate](https://crates.io/crates/timecalc) and as a standalone binary.
See the [installation instructions](#installation) on how to install it,
or the [documentation](https://docs.rs/timecalc) for more information about the crate.


## How to use

```bash
$ timecalc --help
Calculate the total duration of a given set of intervals and durations.

Usage: timecalc [OPTIONS] [DURATION_ARGS]...

Arguments:
  [DURATION_ARGS]...  Intervals or durations to sum

                      Intervals are specified as `start-end`, e.g. `9-12:30`.
                      Durations are specified as `+duration` or `-duration`, e.g. `1h` or `-30m`.

                      Valid duration units are:
                        w for weeks
                        d for days
                        h for hours
                        m for minutes

Options:
  -s, --stdin    Read arguments from stdin
  -h, --help     Print help
  -V, --version  Print version
```

### Example

Let's say you worked on a project from 7:00 to 11:30, including a 15 minute break, and then worked another 4 hours after lunch.
You can calculate the total time spent on the project like this:

```bash
$ timecalc 7-11:30 -15m 4h
8h 15m
# or via stdin
$ echo 7-11:30 -15m 4h | timecalc -s
8h 15m
```

## Installation

### Releases

The latest release can be downloaded as a standalone binary from the [releases page](https://github.com/Granddave/timecalc-rs/releases/latest).

### Using `cargo`

It can also be compiled and installed via `cargo`:

```bash
cargo install timecalc
```

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details