holidays:
  # @attrib https://en.wikipedia.org/wiki/Public_holidays_in_the_United_States
  # @source www4.law.cornell.edu/uscode/html/uscode05/usc_sec_05_00006103----000-.html
  US:
    names:
      en: United States of America
    dayoff: sunday
    zones:
      - America/New_York
      - America/Detroit
      - America/Kentucky/Louisville
      - America/Kentucky/Monticello
      - America/Indiana/Indianapolis
      - America/Indiana/Vincennes
      - America/Indiana/Winamac
      - America/Indiana/Marengo
      - America/Indiana/Petersburg
      - America/Indiana/Vevay
      - America/Chicago
      - America/Indiana/Tell_City
      - America/Indiana/Knox
      - America/Menominee
      - America/North_Dakota/Center
      - America/North_Dakota/New_Salem
      - America/North_Dakota/Beulah
      - America/Denver
      - America/Boise
      - America/Phoenix
      - America/Los_Angeles
      - America/Metlakatla
      - America/Anchorage
      - America/Juneau
      - America/Sitka
      - America/Yakutat
      - America/Nome
      - America/Adak
      - Pacific/Honolulu
    langs:
      - en-us
      - en
    days:
      01-01 and if sunday then next monday if saturday then previous friday:
        substitute: true
        _name: 01-01
      3rd monday in January:
        name:
          en: Martin Luther King Day
      3rd monday in February:
        name:
          en: Washington’s Birthday
      02-14:
        _name: 02-14
        type: observance
      04-15 if friday then next monday if saturday,sunday then next tuesday:
        name:
          en: Tax Day
        type: observance
      wednesday before 04-28:
        name:
          en: Administrative Professionals Day
        type: observance
      2nd sunday in May:
        _name: Mothers Day
        type: observance
      # last monday in may
      monday before 06-01:
        name:
          en: Memorial Day
      3rd sunday in June:
        _name: Fathers Day
        type: observance
      07-04 and if sunday then next monday if saturday then previous friday:
        substitute: true
        _name: Independence Day
      monday in September:
        _name: 05-01
      2nd monday in October:
        name:
          en: Columbus Day
      10-31 18:00:
        name:
          en: Halloween
        type: observance
      11-11:
        name:
          en: Veterans Day
      tuesday after 1st monday in November every 4 years since 1848:
        name:
          en: Election Day
        type: observance
      4th thursday in November:
        name:
          en: Thanksgiving Day
      friday after 4th thursday in November:
        name:
          en: Day after Thanksgiving Day
        type: observance
      12-24:
        _name: 12-24
        type: optional
      12-25 and if sunday then next monday if saturday then previous friday:
        substitute: true
        _name: 12-25
      12-31 18:00:
        _name: 12-31
        type: observance
    states:
      AL:
        name: Alabama
        zones:
          - America/Chicago
        days:
          3rd monday in January:
            name:
              en: 'Robert E. Lee/ Martin Luther King Birthday'
          3rd monday in February:
            name:
              en: George Washington/ Thomas Jefferson Birthday
          4th monday in April:
            name:
              en: Confederate Memorial Day
          1st monday in June:
            name:
              en: Jefferson Davis' birthday
      AK:
        name: Alaska
        zones:
          - America/Anchorage
          - America/Metlakatla
          - America/Juneau
          - America/Sitka
          - America/Yakutat
          - America/Nome
        days:
          2nd monday in October: false
          monday before April:
            name:
              en: Seward's Day
          10-18:
            name:
              en: Alaska Day
      AZ:
        name: Arizona
        zones:
          - America/Phoenix
          - America/Denver
        days:
          3rd monday in January:
            name:
              en: Dr. Martin Luther King Jr./ Civil Rights Day
      AR:
        name: Arkansas
        zones:
          - America/Chicago
        days:
          3rd monday in January:
            name:
              en: Dr. Martin Luther King Jr./ Robert E. Lee's Birthdays
          3rd monday in February:
            name:
              en: "George Washington's Birthday/ Daisy Gatson Bates Day"
          12-24:
            _name: 12-24
      CA:
        name: California
        zones:
          - America/Los_Angeles
        days:
          2nd monday in October: false
          02-15:
            name:
              en: Susan B. Anthony Day
          03-31:
            name:
              en: César Chávez Day
          05-19:
            name:
              en: Malcolm X Day
          05-23:
            name:
              en: Harvey Milk Day
        regions:
          LA:
            name: Los Angeles
            days:
              08-24:
                # reference: http://www.latimes.com/sports/sportsnow/la-sp-kobe-bryant-day-20160823-snap-story.html
                name:
                  en: Kobe Bryant Day
                type: observance
                active:
                  - from: 2016
      CO:
        name: Colorado
        zones:
          - America/Denver
        days:
          2nd monday in October:
            type: observance
      CT:
        name: Connecticut
        zones:
          - America/New_York
        days:
          02-12:
            name:
              en: Lincoln's Birthday
          easter -2:
            _name: easter -2
      DE:
        name: Delaware
        days:
          2nd monday in October: false
          3rd monday in February: false
          easter -2:
            _name: easter -2
          friday after 4th thursday in November:
            name:
              en: Day After Thanksgiving
          tuesday after 1st monday in November in even years:
            name:
              en: Election Day
      DC:
        name: District of Columbia
        days:
          04-16:
            name:
              en: Emancipation Day
      FL:
        name: Florida
        days:
          2nd monday in October: false
          3rd monday in February: false
          02-15:
            name:
              en: Susan B. Anthony Day
          friday after 4th thursday in November:
            name:
              en: Day After Thanksgiving
      GA:
        name: Georgia
        days:
          3rd monday in February: false
          01-19:
            name:
              en: Robert E. Lee's Birthday
          monday before 05-01:
            name:
              en: Confederate Memorial Day
          12-24:
            name:
              en: Washington's Birthday
          substitutes 12-24 if wednesday then next friday:
            substitute: true
            name:
              en: Washington's Birthday
      HI:
        name: Hawaii
        zones:
          - Pacific/Honolulu
        days:
          3rd monday in February: false
          03-26:
            name:
              en: Prince Jonah Kuhio Kalanianaole Day
          06-11:
            name:
              en: Kamehameha Day
          3rd friday in August:
            name:
              en: Statehood Day
          tuesday after 1st monday in November in even years:
            name:
              en: Election Day
      ID:
        name: Idaho
        zones:
          - America/Boise
          - America/Los_Angeles
        days:
          3rd monday in January:
            name:
              en: 'Martin Luther King, Jr./ Idaho Human Rights Day'
      IL:
        name: Illinois
        zones:
          - America/Chicago
        days:
          02-12:
            name:
              en: Lincoln's Birthday
          1st monday in March:
            name:
              en: Casimir Pulaski Day
          05-19:
            name:
              en: Malcolm X Day
          tuesday after 1st monday in November in even years:
            name:
              en: Election Day
      IN:
        name: Indiana
        zones:
          - America/Indiana/Indianapolis
          - America/Indiana/Vincennes
          - America/Indiana/Winamac
          - America/Indiana/Marengo
          - America/Indiana/Petersburg
          - America/Indiana/Vevay
          - America/Indiana/Tell_City
          - America/Indiana/Knox
        days:
          easter -2:
            _name: easter -2
          tuesday after 1st monday in May:
            name:
              en: Primary Election Day
          tuesday after 1st monday in November:
            name:
              en: Election Day
          friday after 4th thursday in November:
            name:
              en: Lincoln's Birthday
      IA:
        name: Iowa
        zones:
          - America/Chicago
        days:
          02-12:
            name:
              en: Lincoln's Birthday
      KS:
        name: Kansas
        zones:
          - America/Chicago
          - America/Denver
        days:
          3rd monday in February: false
      KY:
        name: Kentucky
        zones:
          - America/Kentucky/Louisville
          - America/Kentucky/Monticello
        days:
          3rd monday in February: false
          'easter -2 14:00':
            _name: easter -2
          12-24:
            _name: 12-24
          12-31:
            _name: 12-31
      LA:
        name: Louisiana
        zones:
          - America/Chicago
        days:
          easter -2:
            _name: easter -2
          tuesday after 1st monday in November in even years:
            name:
              en: Election Day
        regions:
          NO:
            name: New Orleans
            days:
              easter -47:
                _name: easter -47
                name:
                  en: Mardi Gras
      ME:
        name: Maine
        zones:
          - America/New_York
        days:
          3rd monday in April:
            name:
              en: Patriots' Day
      MD:
        name: Maryland
        zones:
          - America/New_York
        days:
          friday before 1st monday before 06-01:
            name:
              en: Service Reduction Day
          friday after 4th thursday in November:
            name:
              en: Native American Heritage Day
      MA:
        name: Massachusetts
        zones:
          - America/Chicago
        days:
          03-17:
            name:
              en: Evacuation Day
          3rd monday in April:
            name:
              en: Patriots' Day
          06-17:
            name:
              en: Bunker Hill Day
      MI:
        name: Michigan
        zones:
          - America/Detroit
          - America/Menominee
        days:
          12-24:
            _name: 12-24
          12-31:
            _name: 12-31
      MN:
        name: Minnesota
        zones:
          - America/Chicago
        # all federal holidays
      MS:
        name: Mississippi
        zones:
          - America/Chicago
        days:
          3rd monday in January:
            name:
              en: Martin Luther King's and Robert E. Lee's Birthdays
          monday before 05-01:
            name:
              en: Confederate Memorial Day
      MO:
        name: Missouri
        zones:
          - America/Chicago
        days:
          05-08:
            name:
              en: Truman Day
      MT:
        name: Montana
        zones:
          - America/Denver
        days:
          tuesday after 1st monday in November:
            name:
              en: Election Day
          12-24:
            _name: 12-24
          12-31:
            _name: 12-31
      NE:
        name: Nebraska
        zones:
          - America/Chicago
          - America/Denver
        days:
          friday before 05-01:
            name:
              en: Arbor Day
      NV:
        name: Nevada
        zones:
          - America/Los_Angeles
        days:
          2nd monday in October: false
          friday before 11-01:
            name:
              en: Nevada Day
          4th friday in November:
            name:
              en: Family Day
      NH:
        name: New Hampshire
        zones:
          - America/New_York
        days:
          2nd monday in October:
            type: observance
          3rd monday in January:
            name:
              en: Martin Luther King, Jr./ Civil Rights Day
          tuesday after 1st monday in November in even years:
            name:
              en: Election Day
          friday after 4th thursday in November:
            name:
              en: Day after Thanksgiving
      NJ:
        name: New Jersey
        zones:
          - America/New_York
        days:
          02-12:
            name:
              en: Lincoln's Birthday
          easter -2:
            _name: easter -2
          tuesday after 1st monday in November:
            name:
              en: Election Day
      NM:
        name: New Mexico
        zones:
          - America/Denver
        days:
          3rd monday in February: false
          friday after 4th thursday in November:
            name:
              en: Day after Thanksgiving
      NY:
        name: New York
        zones:
          - America/New_York
        days:
          02-12:
            name:
              en: Lincoln's Birthday
          02-15:
            name:
              en: Susan B. Anthony Day
          tuesday after 1st monday in November:
            name:
              en: Election Day
      NC:
        name: North Carolina
        zones:
          - America/New_York
        days:
          3rd monday in February: false
          2nd monday in October: false
          easter -2:
            _name: easter -2
          friday after 4th thursday in November:
            name:
              en: Day after Thanksgiving
          12-24 and if friday then previous thursday if saturday,sunday then previous friday:
            substitute: true
            _name: 12-24
      ND:
        name: North Dakota
        zones:
          - America/North_Dakota/Center
          - America/North_Dakota/New_Salem
          - America/North_Dakota/Beulah
        # All federal holidays
      OH:
        name: Ohio
        zones:
          - America/New_York
        # All federal holidays
      OK:
        name: Oklahoma
        zones:
          - America/Chicago
        days:
          friday after 4th thursday in November:
            name:
              en: Day after Thanksgiving
      OR:
        name: Oregon
        zones:
          - America/Los_Angeles
        # All federal holidays
      PA:
        name: Pennsylvania
        zones:
          - America/New_York
        days:
          06-14:
            name:
              en: Flag Day
      RI:
        name: Rhode Island
        zones:
          - America/New_York
        days:
          2nd monday in August:
            name:
              en: Victory Day
      SC:
        name: South Carolina
        zones:
          - America/New_York
        days:
          05-10:
            name:
              en: Confederate Memorial Day
          12-26:
            _name: 12-26
      SD:
        name: South Dakota
        zones:
          - America/Chicago
          - America/Denver
      TN:
        name: Tennessee
        zones:
          - America/Chicago
          - America/New_York
        days:
          easter -2:
            _name: easter -2
          12-24:
            _name: 12-24
      # @source http://www.hr.sao.state.tx.us/compensation/Holidays2015.pdf
      # @source http://www.hr.sao.state.tx.us/compensation/Holidays2016_2017.pdf
      TX:
        name: Texas
        zones:
          - America/Chicago
          - America/Denver
        days:
          01-19:
            name:
              en: Confederate Heroes Day
            type: observance
            note: state agencies are partially staffed
          03-02:
            name:
              en: Texas Independence Day
            type: observance
            note: state agencies are partially staffed
          03-31:
            name:
              en: Cesar Chavez Day
            type: observance
          easter -2:
            _name: easter -2
            type: observance
          04-21:
            name:
              en: San Jacinto Day
            type: observance
            note: state agencies are partially staffed
          06-19:
            name:
              en: Emancipation Day In Texas
            type: observance
            note: state agencies are partially staffed
          08-27:
            name:
              en: Lyndon Baines Johnson Day
            type: observance
            note: state agencies are partially staffed
          friday after 4th thursday in November:
            name:
              en: Day after Thanksgiving
          12-24:
            _name: 12-24
          12-26:
            _name: 12-26
            name:
              en: Day after Christmas
      UT:
        name: Utah
        zones:
          - America/Denver
        days:
          07-24:
            name:
              en: Pioneer Day
      VT:
        name: Vermont
        zones:
          - America/New_York
        days:
          1st tuesday in March:
            name:
              en: Town Meeting Day
          3rd monday in August:
            name:
              en: Bennington Battle Day
      VA:
        name: Virginia
        zones:
          - America/New_York
        days:
          friday before 3rd monday in January:
            name:
              en: Lee–Jackson Day
      WA:
        name: Washington
        zones:
          - America/Los_Angeles
        # All federal holidays
      WV:
        name: West Virginia
        zones:
          - America/New_York
        days:
          02-15:
            name:
              en: Susan B. Anthony Day
          06-20:
            name:
              en: West Virginia Day
          4th friday in November:
            name:
              en: Lincoln's Day
      WI:
        name: Wisconsin
        zones:
          - America/Chicago
        days:
          02-15:
            name:
              en: Susan B. Anthony Day
          2nd tuesday in September:
            name:
              en: Primary Election Day
          tuesday after 1st monday in November:
            name:
              en: Election Day
      WY:
        name: Wyoming
        zones:
          - America/Denver
        # All federal holidays