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