#command-line-tool #calendar #ephemeris #displaying #date #solar #geodate

app geocal

A command line tool displaying a calendar and ephemeris of a geodate

1 unstable release

0.1.0 Jul 30, 2020

#536 in Date and time

MIT license

10KB
125 lines

Geocal

A command line tool displaying a calendar and ephemeris of a geodate.

Installation

First you need to install Rust:

$ curl https://sh.rustup.rs -sSf | sh

Then you can install the latest stable version with cargo:

$ cargo install geocal

Or the development version by fetching the git repository:

$ git clone git://github.com/vinc/geocal.git
$ cd geocal
$ cargo install --path .

Usage

Run this tool with a latitude, a longitude, and optionally a timestamp, to get a calendar representation of a geodate:

$ geocal 51.1789 -1.8262 1403333333

  +-------------------------+
  | Date:        0114-05-24 |
  +-------------------------+
  | So Me Ve Te Ma Ju Sa Lu |
  | 00 01 02 03 04 05 06    |
  | 07 08 09 10 11 12 13 14 |
  | 15 16 17 18 19 20 21    |
  | 22 23 24 25 26 27 28 29 |
  +-------------------------+
  | Time:             27:76 |
  +-------------------------+

There's also an ephemeris option:

$ geocal 51.1789 -1.8262 1403333333 --ephem

  +-------------------------+
  | Date:        0114-05-24 |
  +-------------------------+
  | So Me Ve Te Ma Ju Sa Lu |
  | 00 01 02 03 04 05 06    |
  | 07 08 09 10 11 12 13 14 |
  | 15 16 17 18 19 20 21    |
  | 22 23 24 25 26 27 28 29 |
  +-------------------------+
  | Time:             27:76 |
  +-------------------------+
  | Moonrise:         01:57 |
  | Sunrise:          15:46 |
  | Solstice:         44:61 |
  | Moonset:          58:86 |
  | Sunset:           84:53 |
  +-------------------------+

And a solar calendar option instead of the lunisolar calendar to keep track of the seasons:

$ geocal 51.1789 -1.8262 1403333333 --ephem --solar

  +-------------------------------+
  | Date:              0114-02-00 |
  +-------------------------------+
  | So Me Ve Te Ma Ju Sa Ur Ne Lu |
  | 00 01 02 03 04 05 06 07 08 09 |
  | 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 87 88 89 |
  | 90 91 92 93                   |
  +-------------------------------+
  | Time:                   27:76 |
  +-------------------------------+
  | Moonrise:               01:57 |
  | Sunrise:                15:46 |
  | Solstice:               44:61 |
  | Moonset:                58:86 |
  | Sunset:                 84:53 |
  +-------------------------------+

License

Copyright (c) 2019-2020 Vincent Ollivier. Released under the MIT License.

Dependencies

~0.3–8MB
~50K SLoC