Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gadael/icsdb

Open repository of non-working days ics files
https://github.com/gadael/icsdb

europe icalendar ics non-working

Last synced: about 1 month ago
JSON representation

Open repository of non-working days ics files

Host: GitHub
URL: https://github.com/gadael/icsdb
Owner: gadael
License: mit
Created: 2016-01-16T15:08:36.000Z (almost 9 years ago)
Default Branch: master
Last Pushed: 2020-04-25T15:40:05.000Z (over 4 years ago)
Last Synced: 2024-07-31T21:53:11.931Z (5 months ago)
Topics: europe, icalendar, ics, non-working
Language: JavaScript
Homepage:
Size: 772 KB
Stars: 21
Watchers: 2
Forks: 1
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

public-apis - Non-Working Days
public-apis - Non-Working Days
public-apis - Non-Working Days
fucking-public-apis - Non-Working Days
Awesome-API-Provider - Non-Working Days

README

        [![Build Status](https://travis-ci.org/gadael/icsdb.svg?branch=master)](https://travis-ci.org/gadael/icsdb)

# icsdb

Open repository of static calendar `ICS` files

The purpose of this package is to maintain auto-generated ics files from various sources in the `data/` subfolder. 

For example, the build script will use a source ics file for french non working days, will translate the summaries 

of each events, compute list of easter dates for the next years and save the resulting ics file in the `build/` 

subfolder, one file per language.

## Using the ics files

Use the **raw** button on the github page to get the link, only files in the [build](build/) subfolder should be used.

represented countries:

* Belgium (1 file)

* France (9 files)

* Germany (19 files)

* Ireland (1 file)

* Switzerland (27 files)

* United-Kingdom (3 files)

* United-States (51 files)

Warning, this set of ICS files is suject to move to his own domain in the near future. The github url will probably remain but offical permalinks will be modified

## Build ics files

dev dependencies are required to rebuild ics with the script

    node src/build.js

    

## Usage

some easter based dates require to list all dates because the icalendar spec does not include this kind of properties. the dates are

generated into a RDATE ical property from year 1970 to 2100.

More generally, all recuring dates start from 1970 or more to prevent some bugs while decoding the events with various icalendar libraries.

Similar dates use the same UID property in all calendars.

To interpret these files in a program, You will be required to use a library capable of handling RRULE and RDATE properties. Below is a list of libraries that meet these constraints.

| Language    | Libraries

|-------------|-------------

| javascript  | [rrule](https://github.com/jkbrzt/rrule)
 [ical.js](https://github.com/polo2ro/ical.js) (support for nodejs in this fork)

| Python      | [dateutil](http://labix.org/python-dateutil/)

| Ruby        | [ri_cal](https://github.com/rubyredrick/ri_cal)

| Haskell     | Not found

| Java        | [ical4j](https://github.com/ical4j/ical4j)

| Php         | [SG-iCalendar](https://github.com/fangel/SG-iCalendar)

## Others ICS resources

French school holidays

http://www.education.gouv.fr/download.php?file=http%3A%2F%2Fcache.media.education.gouv.fr%2Fics%2FCalendrier_Scolaire_Zones_A_B_C.ics