CSV Data Format
The CSV (Comma-Separated Values) format is simple and commonly supported. One line of text represents a holiday, and within each line, the fields are surrounded by double quotes (") and separated by commas. The quotes allow the holiday descriptions to themselves contain commas.
The first line of data contains the field names, in the same format.
Empty fields are represented by “".
All data is provided in UTF-8.
"locale","region","date","description","type","notes" "en-US","","2011-01-01","New Year's Day","NF","" "en-US","","2011-01-17","Birthday of Martin Luther King, Jr.","V",""
region is a subdivision of locale, for those locales that have regional holidays. Regions are represented by their respective ISO 3166-2 Country subdivision code. For example, Patriot’s Day is only observed in the
en-USlocale in Massachusetts (
MA) and Maine (
ME), so there are entries for each of those states.
date is provided in
description is text that simply describes the holiday.
type is a collection of single-character indicators, that describe the holiday:
Nmeans national holiday, which means locale-wide.
Rmeans it is a religious holiday.
Fmeans the holiday date is fixed, i.e. on the same day each year.
Vmeans the holiday date is variable, e.g. tied to a Monday, or the third Thursday of a month.
notes are provided in some cases for clarification, but are not to be used as part of the holiday description.