General: HolidayType

Relevant services. 

Contents:

NameDescription
id

Identifier for the holiday definition. Please note that this id is not unique, not even with a single year – the same holiday event may be returned multiple time because it is observed on a different day, or because it is scheduled in a different calendar (Hebrew or Muslim calendar) and happens multiple times within a Gregorian year. Use the uid field for purposes where you need a unique identifier.

Type: Integer

uid

Id for the shown holiday instance. The id is designed to be unique across all holiday instances generated by the timeanddate.com API services and respects different calendars and other reasons that may cause events to occurs multiple times within one Gregorian year.

Example: 0007d600000007db

Type: Hexadecimal integer

name

Holiday/Observance name.

Type: Array of TextType

date

Date/time of the holiday instance. Most holidays do not have a specific time – in this case the time components will be skipped. Some special events like equinoxes and solstices include the exact time of the event as well, in this case the timestamp will be in local time zone (including time zone data) (countries with multiple time zones: local time in capital city).

Note:Request version 1 will return time in either local time or UTC (depending on the holiday type) with no time zone information and shall thus no longer be used.

Type: TimeType

url

Further information about the specific holiday. The URL points to the timeanddate.com web page.

Type: String/URL

Example: https://www.timeanddate.com/holidays/us/new-year-day

country

Country of the holiday instance. This element is not present in businessdate and businessduration services.

Type: CountryType

locations

Summary of locations where this holiday instance is valid. This element is not present in businessdate and businessduration services, and only present if the holiday instance does not affect the whole country.

Type: String

states

States/subdivisions that are affected by this holiday instance. This element is not present in businessdate and businessduration services, and only present if the holiday instance is not valid in the whole country.

Type: Array of HolidayStateType

oneliner

A short description of the holiday instance. This element is not present in businessdate and businessduration services.

Type: Array of TextType

types

Classification of the holiday. Most days have only one classification, but some have multiple types associated. This happens e.g. in conjunction with religious days that also are flag days. This element is not present in businessdate and businessduration services.

Example: National Holiday

Type: Array of strings