timey 0.2.0

A simple command line tool for converting between timestamps and datetime strings
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
76
77
78
79
80
81
82
83
84
85
86

# Timey

[![Build Status](https://travis-ci.org/ptrbrynt/timey.svg?branch=develop)](https://travis-ci.org/ptrbrynt/timey)
![Crates.io](https://img.shields.io/crates/v/timey.svg)
![Crates.io](https://img.shields.io/crates/d/timey.svg)
![Libraries.io dependency status for GitHub repo](https://img.shields.io/librariesio/github/ptrbrynt/timey.svg)
![Crates.io](https://img.shields.io/crates/l/timey.svg)

Timey is a command-line application written in Rust which allows for quick and easy translation between timestamps and formatted date-times.

## Installation

First you'll need to install Rust. There are instructions [here](https://www.rust-lang.org/tools/install).

Once you have Rust installed, simply run:

```bash
cargo install timey
```

## Usage

### Parse a date-time string into a timestamp

```bash
$ timey parse '2019-03-05 00:00 +0100' --format '%Y-%m-%d %H:%M %z'
1551744000
```

```bash
$ timey parse '2019-03-05T00:00+01:00'
1525521780
```

### Format a timestamp as a date-time string

```bash
$ timey format 1525521780
2019-03-05T00:00+01:00
```

```bash
timey format 1525521780 -f '%Y-%m-%d'
2018-05-05
```

### Formatting Options

For a full list of formatting specifiers, see [here](https://docs.rs/chrono/0.4.6/chrono/format/strftime/index.html#specifiers).

### Options

```bash
-c, --copy # Copy the result to your the clipboard
-f, --format # The date format to use for parsing/formatting
-m, --millis # Use timestamps in millis rather than seconds
-h, --help # Display help
```

## Display Current Time

_The `-c` flag for copying the result to the clipboard also works with these commands._

### As a timestamp

```bash
$ timey now display
1551908316
```

```bash
$ timey now display -m
1551908316000
```

### As a formatted date-time string

```bash
$ timey now format
2019-03-06T21:38:30.265352+00:00
```

```bash
$ timey now format -f '%Y-%m-%d'
2019-03-06
```