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.