The Calendarific API for global holiday calendars

The Calendarific API provides an intuitive, limited-use API feed, providing access to global holiday calendars, for current, past, and future years. The data may be useful for certain scenarios:

  1. For HR or factory calendars, so that the system knows which are non-working days.
  2. For vacation planning. Since you can calculate the day-of-week from the holiday date, you can spot the possibilities to create long weekends by strategically planning your leave.
  3. Those from the travel, leisure, or tourism industries might be interested to know about potential long weekends in their major source markets.

Illustrative working code here: https://github.com/amosang/datawrangling/blob/master/calendarific/Illustrate%20-%20Calendarific%20API.ipynb

After some thinking, I felt that the best UI would be Google Calendar, especially given the nature of the data. GCal comes with a nice API to load in data, and is something which most people with a Gmail account would already be familiar with. After some fiddling and exploring of the Google API, I managed to load in the 2018 and 2019 data for observances and national holidays. See https://calendar.google.com/calendar/embed?src=frd6mild6d8cishbrnlkp78lv8%40group.calendar.google.com&ctz=Asia%2FSingapore for the actual data, and feel free to use it! As for how to do this, check out this interesting tutorial ( https://www.twilio.com/blog/2018/06/how-i-keep-my-mom-updated-on-my-travel-schedule-with-twilio-and-google-calendar.html ) from which I adapted the code.

The Google calendar now has data for 2015-2019, for the following countries: [‘AU’, ‘BN’, ‘CN’, ‘DE’, ‘FR’, ‘GB’, ‘HK’, ‘ID’, ‘IN’, ‘JP’, ‘KR’, ‘LK’, ‘MM’, ‘MY’, ‘PH’, ‘RU’, ‘SG’, ‘TH’, ‘TW’, ‘UK’, ‘US’, ‘VN’]
(Note: United Kingdom = ‘GB’. It’s an ISO thing)

Leave a Reply