View Source Changelog

Astro version 1.1.0

This is the changelog for Astro version 1.1.0 released on June 18th, 2024. For older changelogs please consult the release tag on GitHub

Breaking Change

  • :tz_world is no longer a required dependency - it is now an optional dependency. This library is used to resolve a time zone name from a given latitude and longitude. When configured, it becomes the default method of resolving time zone names from a location. However it is no possible to provide alternative implementations for this resolution using the :time_zone_resolver option.

  • To retain the previous behaviour, applications should add {:tz_world, "~> 1.0"} to their dependencies.

Enhancements

  • Adds an option :time_zone_resolver to Astro.sunrise/3 and Astro.sunset/3 that is a 1-arity function that is invoked to resolve the time zone name from a given latitude and longitude. The default is to use TzWorld.timezone_at/1 if TzWorld is configured, otherwise an error is returned.

  • The default time zone database is now detected in the following order:

    1. Application.get_env(:elixir, :time_zone_database)
    2. TzData.TimeZoneDatabase if TzData is configured
    3. Tz.TimeZoneDatabase if Tz is configured

Astro version 1.0.2

This is the changelog for Astro version 1.0.2 released on May 27th, 2024. For older changelogs please consult the release tag on GitHub

Bug Fixes

  • Fix sunrise/sunset calculations when the solar elevation isn't 90 degrees. Thanks to @cloud8421 for the issue. Closes #5.

Astro version 1.0.1

This is the changelog for Astro version 1.0.1 released on April 6th, 2024. For older changelogs please consult the release tag on GitHub

Bug Fixes

  • Use only the configured time zone database to resolve time zone information. Therefore any module that implements the Calendar.TimeZoneDatabase behaviour can be used. This also makes the code align with the README so that either Tzdata or Tz can be configured as the systems time zone database (or any future library). Thanks to @ericlathrop for the issue. Closes #4.

Astro version 1.0.0

This is the changelog for Astro version 1.0.0 released on December 29th, 2022. For older changelogs please consult the release tag on GitHub

Enhancements

  • Release 1.0. This library was started four years ago and the public API has been stable for at least three of those years.

  • Adds Astro.sun_azimuth_altitude/2. Thanks to @kimlai for the suggestion. Closes #3.

Astro version 0.10.0

This is the changelog for Astro version 0.10.0 released on November 7th, 2022. For older changelogs please consult the release tag on GitHub

Enhancements

  • Adds Astro.Math.floor/1 and Astro.Math.ceil/1 which are needed to support Tempo.

Astro version 0.9.2

This is the changelog for Astro version 0.9.2 released on September 1st, 2022. For older changelogs please consult the release tag on GitHub

Bug Fixes

  • Update :tz_world to "~> 1.0" which will also remove Elixir 1.14 warnings

Astro version 0.9.1

This is the changelog for Astro version 0.9.1 released on October 23rd, 2021. For older changelogs please consult the release tag on GitHub

Bug Fixes

  • Ensure that gregorian_seconds is an integer before passing it to Tzdata.periods_for_time/3. Thanks to @dvic for the report. Fixes #2.

Astro version 0.9.0

This is the changelog for Astro version 0.9.0 released on October 8th, 2021. For older changelogs please consult the release tag on GitHub

Please note that Elixir 1.11 or later is required.

Enhancements

  • Adds Astro.lunar_phase_emoji/1 to produce a single grapheme string representing the image of the moon phase for a given lunar angle.

Astro version 0.8.0

This is the changelog for Astro version 0.8.0 released on October 3rd, 2021. For older changelogs please consult the release tag on GitHub

Please note that Elixir 1.11 or later is required.

Enhancements

  • Convert some identity functions to macros which improves runtime performance

  • Add additional specs and docs to Astro.Math module

Astro version 0.7.0

This is the changelog for Astro version 0.7.0 released on September 10th, 2021. For older changelogs please consult the release tag on GitHub

Please note that Elixir 1.11 or later is required.

Bug Fixes

  • Revert Astro back to a pure library application. The supervisor for TzWorld still needs to be started. This fix brings the code back into line with the README. Thanks to @dvic for the report. Closes #1.

Astro version 0.6.0

This is the changelog for Astro version 0.6.0 released on September 5th, 2021. For older changelogs please consult the release tag on GitHub

Please note that Elixir 1.11 or later is required.

Bug Fixes

  • Fix Astro.Math.atan_r/2

  • Fix ephemeris calculation

Breaking changes

  • Change Time.date_time_{from, to}_iso_days/1 to Time.date_time_{from, to}_moment/1

Enhancements

Astro version 0.5.0

This is the changelog for Astro version 0.5.0 released on August 26th, 2021. For older changelogs please consult the release tag on GitHub

Please note that Elixir 1.11 or later is required.

Bug Fixes

  • Updates documentation to be clear about installation and setup requirements for tz_world

  • Fixes test data for São Paulo now that it no longer uses DST

  • Ensure :astro is started in test mode

Enhancements

This primary focus of this release is to add lunar calculations for moon phase.

Astro version 0.4.0

This is the changelog for Astro version 0.4.0 released on February 16th, 2020. For older changelogs please consult the release tag on GitHub

Breaking Change

  • When no timezone is found the return is changed from {:error, :timezone_not_found} to {:error, :time_zone_not_found} to be consistent with Elixir and TzData.

Astro version 0.3.0

This is the changelog for Astro version 0.3.0 released on December 9th, 2019. For older changelogs please consult the release tag on GitHub

Change in behaviour

  • Seconds are no longer truncated to zero when calculating datetimes and durations

Enhancements

  • Add Astro.solar_noon/2 to return the true solar noon for a location and date

  • Add Astro.hours_of_daylight/2 to return hours, minutes and seconds as a Time.t() representing the number of daylight hours for a give location and date

  • Add Astro.sun_apparent_longitude/1 to return the apparent solar longitude on a given date. The result, a number of degrees between 0 and 360, can be used to determine the seasons.

Astro version 0.2.0

This is the changelog for Astro version 0.2.0 released on December 6th, 2019. For older changelogs please consult the release tag on GitHub

Enhancements

Astro version 0.1.0

This is the changelog for Astro version 0.1.0 released on December 5th, 2019. For older changelogs please consult the release tag on GitHub

Enhancements