Skip to main content

This class provides the sunrise and sunset times for various zeniths, latitudes and longitudes.

Project description

PyPi Version PyPI Wheel Python Versions License

The MIT License (MIT)

Overview

Python API to determine sunrise and sunset. It accepts five zenths: official civil, nautical, amateur, and astronomical.

Basic Usage

import datetime
from sunrisesunset import SunriseSunset

dt = datetime.datetime.now()
rs = SunriseSunset(dt, lat=35.9513, lon=83.9142, zenith='official')
rise_time, set_time = rs.sun_rise_set
print(f"     Sunrise: {rise_time}")
print(f"      Sunset: {set_time}")
print(f"    Is night: {rs.is_night()}\n")

Running the Test

The pip installed package will not be enough to run the test. You will also need to pip install geopy and timezonefinder.

There is a more complete example in the test at the end of the `sunrisesunset.py` file.

You will be asked for an address, just a city name is okay. Then you will be asked for the time. It takes an ISO formatted time at minimum the year, month, and day needs to be entered.

python sunrisesunset/sunrisesunset.py

Enter an address: Chicago
Chicago, Cook County, Illinois, United States
Enter date in ISO format (yyyy-mm-dd hh:mm:ss): 2023-12-16 12
Timezone: America/Chicago
Test zenith
Using zenith: official
   Date/Time: 2023-12-16 12:00:00-05:00
     Sunrise: 2023-12-16 08:11:12.111139-05:00
      Sunset: 2023-12-16 17:20:16.524534-05:00
    Is night: False

Using zenith: civil
   Date/Time: 2023-12-16 12:00:00-05:00
     Sunrise: 2023-12-16 07:39:33.419425-05:00
      Sunset: 2023-12-16 17:51:55.167217-05:00
    Is night: False

Using zenith: nautical
   Date/Time: 2023-12-16 12:00:00-05:00
     Sunrise: 2023-12-16 07:04:25.491129-05:00
      Sunset: 2023-12-16 18:27:03.015662-05:00
    Is night: False

Using zenith: amateur
   Date/Time: 2023-12-16 12:00:00-05:00
     Sunrise: 2023-12-16 06:47:20.286033-05:00
      Sunset: 2023-12-16 18:44:08.169022-05:00
    Is night: False

Using zenith: astronomical
   Date/Time: 2023-12-16 12:00:00-05:00
     Sunrise: 2023-12-16 06:30:29.951023-05:00
      Sunset: 2023-12-16 19:00:39.782789-05:00
    Is night: False

Test 24 hours for every 20 minutes.
...

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sunrisesunset-1.0.2.tar.gz (6.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sunrisesunset-1.0.2-py2.py3-none-any.whl (7.0 kB view details)

Uploaded Python 2Python 3

File details

Details for the file sunrisesunset-1.0.2.tar.gz.

File metadata

  • Download URL: sunrisesunset-1.0.2.tar.gz
  • Upload date:
  • Size: 6.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.7

File hashes

Hashes for sunrisesunset-1.0.2.tar.gz
Algorithm Hash digest
SHA256 533f12c04169c45eaa7e2e020c56b8f39a51936caa42c345bddf02331c61b16e
MD5 22c9db7067d45b04a97a05054ffe6971
BLAKE2b-256 c9f767f4784bb0fb0d11df57a6eef0134e980cf54241fa3b26c8ac1d6c4ee4e4

See more details on using hashes here.

File details

Details for the file sunrisesunset-1.0.2-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for sunrisesunset-1.0.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 14c3dd6acec8368236419117081c2e17edc15b8892455fe7009aace6cf092505
MD5 3304164d3dc5901f77fc745faa07854a
BLAKE2b-256 2788a255cd052c220356410083ce1d0b81ece49c124610108869542183712c55

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page