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.

Example


  "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",""

Fields

  • locale is a combination of an ISO 639-1 language code, such as en (English), and an ISO 3166-1 alpha-2 country code, such as US (United States), separated by a hyphen: e.g. en-US.

  • 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-US locale in Massachusetts (MA) and Maine (ME), so there are entries for each of those states.

  • date is provided in YYYY-MM-DD format.

  • description is text that simply describes the holiday.

  • type is a collection of single-character indicators, that describe the holiday:

    • N means national holiday, which means locale-wide.
    • R means it is a religious holiday.
    • F means the holiday date is fixed, i.e. on the same day each year.
    • V means 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.