https://github.com/chrisblakley/Daylight-Calendar-ICS

Daylight Calendar is a dynamically generated .ics calendar that you can host and subscribe to in Google Calendar, iCal, or other calendar software.
https://github.com/chrisblakley/Daylight-Calendar-ICS

calendar daylight daylight-saving-time daylight-savings google-calendar ical ics sunrise sunset

Last synced: 2 months ago
JSON representation

Daylight Calendar is a dynamically generated .ics calendar that you can host and subscribe to in Google Calendar, iCal, or other calendar software.

• Host: GitHub
• URL: https://github.com/chrisblakley/Daylight-Calendar-ICS
• Owner: chrisblakley
• License: gpl-2.0
• Created: 2018-02-22T03:42:03.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-08-10T15:16:58.000Z (about 1 year ago)
• Last Synced: 2024-08-13T03:05:48.802Z (about 1 year ago)
• Topics: calendar, daylight, daylight-saving-time, daylight-savings, google-calendar, ical, ics, sunrise, sunset
• Language: PHP
• Homepage: https://gearside.com/google-daylight-calendar/
• Size: 34.2 KB
• Stars: 42
• Watchers: 5
• Forks: 5
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Daylight Calendar ICS

This is a dynamically generated .ics calendar that you can host and subscribe to in Google Calendar, iCal, or other calendar software.

Not only will it provide an event each day with the appropriate sunrise and sunset time, it will show the length of the day in hours/minutes as well as in a percent (of 24 hours) and the solar noon for that day. It will also give a percentile compared to the shortest and longest days of the year!

## Options

- [Find your geo coordinates](https://www.latlong.net/)

- [Find your timezone name](https://www.php.net/manual/en/timezones.php)

- [Find your GMT offset](http://en.wikipedia.org/wiki/List_of_UTC_time_offsets#mediaviewer/File:World_Time_Zones_Map.png)

## Instructions

- Upload `daylight.php` and/or `sun.php` to your server (or skip this step and use the one hosted on [gearside.com](https://gearside.com/calendars/daylight.php))

- Point your calendar to the file and use query parameters for the options above.

  - Latitude: `lat`

  - Longitude: `lng`

  - Timezone (preferred way): `timezone`

  - GMT Offset (alternate way): `gmt`

  - Year: `year`

  - Event types (`sun.php` only):

    - `actual`

    - `civil`

    - `nautical`

    - `astronomical`

    - `all`

Use `?debug` to directly view the calendar file in a browser with events more easily readable. Be sure not to use `?debug` when subscribing to your calendar as it does not declare itself as an .ics file with that parameter present.

## Examples

#### Basic

Most reliable method:

`https://gearside.com/calendars/daylight.php?lat=43.1234&lng=-76.1234&timezone=America/New_York`

Your mileage may vary if only passing GMT offset:

`https://gearside.com/calendars/daylight.php?lat=43.1234&lng=-76.1234&gmt=-5`

`https://gearside.com/calendars/sun.php?lat=43.1234&lng=-76.1234&gmt=-5&all`

## Notes

Calendar software caches remote .ics files (like this one), so when replacing it you can "bust" the cache by adding another query parameter of random characters such as `&sdfgsfd`.

- [More information available at Gearside.com](https://gearside.com/google-daylight-calendar/)