Last modified: 31.7.2024

Started: 15.8.2020

A web-based Icelandic calendar and REST API providing Icelandic dates and holidays from 1972 to 5000.

This project offers a web-based Icelandic calendar and a REST API, providing comprehensive access to Icelandic dates. The application is built using Node.js with Express, TypeScript, and Jade. A Swagger UI is available at /swagger for exploring the API. The calendar can be viewed in both Icelandic and English.

The web application is available at: https://cal.guttih.com (Icelandic version) and https://cal.guttih.com/?language=en (English version).

Navigation

The calendar offers multiple ways to navigate:
  • On-screen buttons: Buttons with arrow icons allow you to move between months and years.
  • Keyboard controls: Use the arrow keys to navigate (up/down for year, left/right for month).

Key Features

  • Monthly View:
    • Displays a calendar of the current month.
    • Navigate between months and years using arrow keys or on-screen controls.
    • Dynamically adjusts to the browser window size.
  • Yearly View:
    • View the entire selected year.
  • Week Number View:
    • Explore weeks and long holiday weekends.
  • Export:
    • Export calendar data in a format importable into Google Calendar.
  • API Description:
    • Access the Swagger UI at `/swagger` for a comprehensive overview of available API calls (primarily JSON, with some HTML endpoints).
  • Bug Reports/Feature Requests:
    • Report bugs or suggest new features via a link to the project's issue tracker (repository not publicly available).

Supported Icelandic Holidays and Special Days

  • Easter
  • Good Friday
  • Maundy Thursday
  • Easter Monday
  • Palm Sunday
  • Bolludagur
  • Sprengidagur
  • Öskudagur
  • Pentecost
  • Whit Monday
  • Ascension Day
  • Commerce Day
  • Mother's Day
  • Seaman's Day
  • Advent (First Sunday of Advent)
  • First Day of Summer
  • Day before Christmas Eve
  • Christmas Eve
  • Christmas Day
  • Second Day of Christmas
  • Labor Day
  • New Year's Eve
  • New Year's Day
  • National Day (June 17th)
  • Þrettándinn (Twelfth Night, January 6th)
  • Valentine's Day
  • Sovereignty Day (December 1st)
  • Leap Year Day (February 29th, when applicable)
  • Icelandic Language Day (November 16th)
  • Jónsmessa (Midsummer, June 24th)
  • First Day of Winter (usually the last Saturday in October)
  • Bóndadagur (Husband's Day, usually the third Friday in January)
  • Konudagur (Wife's Day, usually the third Sunday in February)
  • Icelandic Nature Day