Contact

Göteborg Bit Factory
GBF is the creator of holidata.net.

License
Creative Commons License
holidata.net is licensed under the (CC BY 3.0).


<< Home

XML Data Format

The XML (Extensible Markup Language) format is very common. See http://www.w3.org/XML for a complete description.

Empty fields are represented by empty tags.

All data is provided in UTF-8.

Example

<?xml version="1.0" ?>
<holidays>
  <holiday>
    <locale>en-US</locale>
    <region></region>
    <date>2012-01-01</date>
    <description>New Year's Day</description>
    <type>NF</type>
    <notes></notes>
  </holiday>
</holidays>
        

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.

region is a subdivision of locale, for those locales that have regional holidays. For example, Patriot's Day is only observed in the en-US locale in Massachusetts and Maine, 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 is fixed, or on the same day each year. "V" means variable and is typically tied to a Monday, or the third Thursday, for example.

notes are provided in some cases for clarification, but are not to be used as part of the holiday description.