Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sj14/astral
☀️ Go calculations for the position of the sun and moon.
https://github.com/sj14/astral
blue-hour dawn dusk go golang golden-hour hacktoberfest midnight moon moon-phase noon sunrise sunset
Last synced: 2 months ago
JSON representation
☀️ Go calculations for the position of the sun and moon.
- Host: GitHub
- URL: https://github.com/sj14/astral
- Owner: sj14
- License: apache-2.0
- Created: 2021-04-11T13:50:56.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-08-03T11:38:01.000Z (5 months ago)
- Last Synced: 2024-08-03T12:44:28.573Z (5 months ago)
- Topics: blue-hour, dawn, dusk, go, golang, golden-hour, hacktoberfest, midnight, moon, moon-phase, noon, sunrise, sunset
- Language: Go
- Homepage:
- Size: 4.09 MB
- Stars: 32
- Watchers: 3
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
# Astral
[](https://goreportcard.com/report/github.com/sj14/astral)
[](https://godoc.org/github.com/sj14/astral)
Calculations for the position of the sun and moon.
This is a Go port of the Python [astral](https://github.com/sffjunkie/astral) package.
The `astral` package provides the means to calculate the following times of the sun:
* dawn
* sunrise
* noon
* midnight
* sunset
* dusk
* daylight
* night
* twilight
* blue hour
* golden hour
* ~~rahukaalam~~ TODO
plus solar azimuth and elevation at a specific latitude/longitude.
It can also calculate the moon phase for a specific date.
## CLI
Besides the package for usage in you own programs, we also provide a tool for showing the data.
### Installation
#### Homebrew
```text
brew install sj14/tap/astral
```
#### Manually
```text
go get -u github.com/sj14/astral/cmd/astral
```
### Usage
```text
Usage of astral:
-elev float
elevation of the observer
-lat float
latitude of the observer
-long float
longitude of the observer
-time string
day/time used for the calculation (defaults to current time)
```
### Example
```text
$ astral -lat 51.58 -long 6.52
Date/Time Fri Apr 30 21:12:11 CEST 2021
Latitude 51.58
Longitude 6.52
Elevation 0
Daylight 14h48m11s
Night-Time 9h9m55s
Moon Phase Full Moon (17.611222222222224)
Apr 30 03:39 (-17:32) Dawn (Astronomical)
Apr 30 04:39 (-16:32) Dawn (Nautical)
Apr 30 05:28 (-15:43) Dawn (Civil) Twilight Start Blue Hour Start
Apr 30 05:43 (-15:28) Golden Hour Start Blue Hour End
Apr 30 06:07 (-15:04) Sunrise Twilight End
Apr 30 06:53 (-14:18) Golden Hour End
Apr 30 13:31 (-07:41) Noon
Apr 30 20:09 (-01:02) Golden Hour Start
Apr 30 20:55 (-00:16) Sunset Twilight Start
┈┈┈┈┈┈ 21:12 ┈┈┈┈┈┈┈┈ ┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈
Apr 30 21:19 (+00:07) Golden Hour End Blue Hour Start
Apr 30 21:34 (+00:22) Dusk (Civil) Twilight End Blue Hour End
Apr 30 22:24 (+01:12) Dusk (Nautical)
Apr 30 23:25 (+02:13) Dusk (Astronomical)
May 1 01:31 (+04:18) Midnight
```