Non-Attendance-Based Events
Non-Attendance-Based Events are events with a start and end date, but are more fluid and distributed in impact, such as observances or school holidays.
Last updated
Non-Attendance-Based Events are events with a start and end date, but are more fluid and distributed in impact, such as observances or school holidays.
Last updated
© 2024 PredictHQ Ltd
Note: All Public Holidays, Observances, and School Holidays events contain polygon information. Polygon information is returned on the geo field. See our guide to polygons for more details.
A holiday generally established and recognized by law when most businesses and schools are closed. E.g. most countries celebrate New Year’s Day on January 1st.
Labels for a public holiday event provide more information about the holiday. The most common 5 labels are:
holiday-national: When the day is celebrated on a country level, e.g. the entire country was celebrating Martin Luther King Jr. Day on Jan 18, 2021
holiday-local-common: When the holiday is celebrated in only some regions of the country. E.g. only 5 out of 13 provinces and territories of Canada (British Columbia, Alberta, Ontario, New Brunswick, and Saskatchewan) celebrate Family Day on the first Monday in February.
holiday-local: When the holiday is region-specific, e.g. only Texas state celebrates Texas Independence Day on Mar 2, 2021
holiday-religious: When the holiday is celebrated for a religious reason, e.g. there are about 44 countries that celebrate Eid al-Adha Day
holiday-christian: When the holiday is Christian related, e.g. Corpus Christi.
| Date & Time Fields | Availability | Notes |
|---|---|---|
Note: datetime is used with the local timezone. E.g. New York is celebrating New Year’s Day on January 1st EST, while San Francisco is also celebrating New Year’s Day on January 1st but in PST.
Public holidays have a scope that is at the area level. The scope is either at the region or country level. The latitude and longitude is pointing to the center of the region or country.
Public holidays have event group entities available.
PHQ Rank
National holidays or common local holidays have a PHQ Rank of 90 to indicate the popularity/impact on the country
Local holidays have a PHQ Rank of 70 as there is less impact on the area compared to a national holiday.
Local Rank
Public holidays events have no Local Rank available as they impact an entire area instead of a specific point
PHQ Attendance
Public holidays have no PHQ Attendance available as the rank/impact only reflect its influence on the area, instead of the number of people are celebrating this holiday.
School holiday events represent the general date range in an area where the schools are closed for the term/semester break. E.g. Easter School Holidays in Bavaria, Germany is from March 27th, 2021 to April 11th, 2021.
Note: The School holidays category covers the holiday dates in primary schools and secondary schools. School holidays for higher education institutions are under the Academic Events category.
LABELS
All school holidays events have both school and holiday labels. Some events may have an estimated label when there is no date available from the official source but a pattern from the previous years can be used to estimate the holiday dates.
Note: Datetime is used with the local timezone.
School holiday is an area event, it scopes to either locality, localadmin, county, region or country level, i.e. majority schools in that region commence break in that period. For example, school holidays in the United States are scoped to the county level, e.g. Clark County School District - Spring Break while school holidays in New Zealand are scoped to the country level which means we have one school holiday for the entire country, e.g. Spring School Holidays. School holidays in the UK are scoped to either region, county, or the local council (localadmin) level.
The latitude and longitude is pointing to the center of the region or country.
Our school holidays data goes to a more granular detailed level for the United Kingdom than for other countries. Our school holidays data includes local council level school holidays for England, Wales, North Ireland and Scotland.
Note
Our school holidays granularity changed in September 2021 to move from the country level for England, Wales, Scotland and Northern Ireland to the local council level.
For the granular school holiday data for the United Kingdom we have historic data from September 2017 to the present day. School holidays are updated every week.
We have events for 212 school districts in the UK including 157 districts for England. For the UK per year we have the following number of events:
1200-1300 events per School Period (E.g. Sep 2021 - June 2022),
1400-1500 events per Year (E.g. 2021 covers part of both the 2020-2021 and 2021-2022 school periods)
Here are some examples of the school holidays for the United Kingdom:
To find school holidays that impact your location you can use the standard features of our events API - as follows:
You can perform a lat/lon and radius search using the within parameter on the API. For this find the lat/lon of your location such as a store, hotel or any other location. Search for events around that location - such as 5 kilometers around a location in Leeds.
You can use the places parameter in the events API to find events impacting a geographic location - for example all events impacting Bristol or all events impacting Kent.
Alternatively, if you are downloading the data into a data lake you can use our location scopes from the place_hierarchies field with the places hierarchy endpoint to retrieve events that impact a geographic location.
See also the FAQs for district-level school holidays
Our school holidays data goes to a more granular detailed level for the United States (US) than for other countries. School holidays are defined at a district level for the US. See our school holidays category page for an overview of our school holidays data.
There are around 98,469 public schools in the US in around 13,000 school districts. We provide school holidays at a school district level for the US. We have approximately 55,000 - 58,000 school holiday events per year.
For the district school holiday data for the US we have historic data from September 2018 to the present day. School holidays are updated every week. For school holidays before September 2018 they are shown at the state level.
Note
Our school holidays granularity changed in October 2021 to move from the state level to the district level.
We rank our school holidays based on student numbers in the school district.
Here are some examples of the school holidays for the United States:
To find school holidays that impact your location you can use the standard features of our events API and Control Center to find events that impact your location - as follows:
You can perform a lat/lon and radius search using the within parameter on the API. For this find the lat/lon of your location such as a store, hotel or any other location. Search for events around that location - such as 5 kilometers around a location in Leeds.
You can use the places parameter in the events API to find events impacting a geographic location - for example all events impacting Bristol or all events impacting Kent.
You can search in Control Center for a location (this uses the places parameter behind the scenes) to find school holidays for a location.
Alternatively, if you are downloading the data into a data lake you can use our location scopes from the place_hierarchies field with the places hierarchy endpoint to retrieve events that impact a geographic location.
These Frequently asked questions apply to district level school holidays (for the US and UK):
Does the data include private school holidays as well? The data set does not cover private schools. Private schools select their own calendars and are not necessarily governed by school district dates. That being said, some private schools might follow similar calendars.
Does the data recognize if school holidays are changed due to covid-based government decisions? The data will recognize changes as soon as possible. The events have an update date/time on them so we fetched updates based on these dates. We update events weekly.
What date range does the event signal? Are there start and end times to the school holiday? The date range is the total length of the event. That being said, if the school holidays start on a Sunday or Monday, the weekend before that school holiday is included in the total event time. The same applies to the end date. The weekend after a school holiday is included if the holiday ends on a Friday or Sunday.
What location is given to the event? A school holiday is an area event, it scopes to either locality, county, region, or country level. For example, school holidays in the United States are scoped to the district level which means we have school holidays per district while school holidays in New Zealand are scoped to the country level which means we have one school holiday for the entire country, e.g. Spring School Holidays. School holidays in the UK are scoped to the local council level. The latitude and longitude are pointing to the center of the country, region, county, or locality.
Teacher Only Days - We do not currently include teacher-only days.
The places hierarchy information for school holidays is geoscoped as described in our geographic info guide. These events can have multiple hierarchies if they are close to a major hierarchy (within a radius of 50km). This means for example school holidays in Surrey will have a scope for Surrey and a scope for Greater London as they are near Greater London.
If you use the place.scope parameter and query for Greater London in this example you will get holidays for Surrey too. To limit your search to only London look for areas within London (below Greater London).
School holidays have no entities available
PHQ Rank
School holidays for the United Kingdom (from September 2017) and the United States (from September 2018) are ranked based on student numbers. The rank is based on a logarithmic scale to convert student numbers at the local authority level to a PHQ rank value.
All school holidays for other countries and from the US and UK before the time periods stated above have a PHQ Rank of 90 to indicate the general impact on the region.
Local Rank
For the United Kingdom (from September 2017) and US (from September 2018) school holidays, local rank is calculated by applying a linear transformation to the student percentage of the local authority. The student percentage is calculated by dividing the student numbers of a local authority by its total population.
School holidays events for other countries, and from the US and UK before the time periods stated above, have no Local Rank available as they do not have student numbers attached.
PHQ Attendance
PHQ Attendance for School holidays for the United Kingdom (from September 2017) and the United States (from September 2018) is based on student numbers for the school district. E.g. If the Bristol school district has 66,000 students in 2019 then we would show phq_attendance as 66,000.
School holidays for the rest of the world, and from the US and UK before the time periods stated above, have no PHQ Attendance available as the rank/impact only reflect its influence on the area, instead of a number of people are on school holiday during that period.
An Observance is a day that is recognized nationally or internationally, usually set by a major organization or government to commemorate a public health or ethical cause of importance on a national or international level. E.g. Mother’s Day, New Year’s Eve, World Cancer Day, etc
Labels
Labels for an observance event provide more information about the event. The most common 5 labels are:
observance-season
When the observance marks the seasonal change: June Solstice, March Equinox, September Equinox, December Solstice.
227 countries observed the above four types of events.
holiday-religious: When observing a religious holiday mostly celebrated in other cultures but not a major trend among the local population. E.g. Eid al-Fitr is celebrated as a religious public holiday in Muslim countries and is observed in other countries.
holiday-christian: When observing a Christian-related holiday, e.g. Epiphany.
observance-united-nations:
The United Nations created international days to promote global awareness and action on some issues. For example, March 22 is World Water Day.
The United Nations also observes anniversaries of key events in its history. E.g. May 8th is Time of Remembrance and Reconciliation for Those Who Lost Their Lives during the Second World War.
holiday-hebrew: When observing a Hebrew-related holiday, e.g. many countries observe Tu Bishvat.
Note: Datetime is used with the local timezone E.g. Boston is celebrating Valentine’s Day on February 14th EST, while Los Angeles is also celebrating Valentine’s Day on February 14th but in PST.
An Observance is an area event, it scopes to either region or country level, i.e. the whole country or region is observing this day. The latitude and longitude is pointing to the center of the region or country.
Observances have event group entities available.
PHQ Rank
Rank 80-90 observances are widely observed and typically associated with consumer spending on gifts, travel, and festivities. Examples include Valentine's Day and Christmas Eve.
Rank 60-79 observances are mostly religious observances, national days, independence days, or cultural and historical dates which have a wide impact. Examples include Constitution Day and Ganesh Chaturthi.
Rank 40-59 observances include observances with the potential for increased localized economic activities such as awareness days, smaller historical observances, and regional celebrations. Examples include Queensland Day and National Indigenous Peoples Day.
Rank 20-39 observances generally do not have widespread commercialization, public holidays, or significant consumer behavior changes associated with them. Examples include September Equinox and World Bicycle Day.
Local Rank
Observance events have no Local Rank available as they impact an entire area instead of a specific point.
PHQ Attendance
Observances have no PHQ Attendance available as the rank/impact only reflects its influence on an area, rather than a specific amount of attendees at a specific location.
Politics events include the main dates of elections and referendums around the world.
Note the politics category currently does not cover physically attended events to do with politics such as rallies and debates.
LABELS
This category is classified into two buckets with the following labels used to identify the type of events.
Election: The date when the parliament or president election occurs.
Referendum: The referendum date in the country.
Note: Datetime is used with the local timezone.
Politics events scope to a country level. For example Election for the President of the United States of America in the United States. The latitude and longitude point to the center of the covered area. The place scope will identify the full area of coverage.
Politics events have event group entities available.
PHQ Rank
Politics events have PHQ Rank available. It considers the number of registered voters and turnout in a certain area.
Local Rank
Politics events have no Local Rank available as they impact an entire country instead of a specific point.
PHQ Attendance
Politics events have no PHQ Attendance available as the rank/impact only reflects the influence in the country, rather than a specific amount of attendees at a specific location.
Daylight savings is the schedule date when daylight savings start or ends in an area.
LABELS
All daylight savings events are labelled daylight-savings. The only two types of daylight savings events are: daylight savings begins and daylight savings ends
Note: Datetime is in UTC
Daylight savings is an area event, it scopes to either region or country level, i.e. the whole country or region starts or ends daylight savings on this day. The latitude and longitude is pointing to the center of the region or country.
Daylight savings events have event group entities available.
PHQ Rank
All daylight savings events have a PHQ Rank of 30.
Local Rank
Daylight savings events have no Local Rank available as they impact an entire area.
PHQ Attendance
Daylight savings events have no PHQ Attendance available.
| Date & Time Fields | Availability | Notes |
|---|---|---|
| Geo-scope Level | Countries |
|---|---|
| Date & Time Fields | Availability | NOTES |
|---|---|---|
| Date & Time Field | Availability | NOTES |
|---|---|---|
| Date & Time Field | Availability | Notes |
|---|---|---|
Start date
Yes
End date
No
Same as the start date. A public holiday event is a single-day event. There are no multi-day events under the public-holidays category. The holiday will break into individual days if it’s celebrated over multiple days, e.g. there are 4 days off in Japan during the New Year period, the four corresponded records are: December 31 Bank Holiday, New Year's Day, January 2 Bank Holiday, January 3 Bank Holiday
Start time
No
End time
No
Timezone
No
Start date
Yes
The weekend before a school holiday is included if the school holiday starts on a Sunday or Monday
End date
Yes
The weekend after a school holiday is included if the holiday ends on a Friday or Sunday
Start time
No
End time
No
Timezone
No
Country
Azerbaijan, Monaco, Bulgaria, Liechtenstein, Brazil, Latvia, Moldova, Bosnia and Herzegovina, Sweden, Hungary, Mexico, Ukraine, Vietnam, South Korea, Japan, Croatia, New Zealand, Turkey, Slovakia, Russia, Greece, Lithuania, United Arab Emirates, Hong Kong, Serbia, Armenia, Taiwan, Malta, Republic of Ireland, Iceland, Albania, Finland, Montenegro, Kosovo, Fiji, Belarus, Estonia, Kazakhstan, Slovenia, Thailand, Israel, Poland, Singapore, Cyprus, India, Romania, Switzerland, Andorra, Portugal, Czech, Malaysia, Belgium, Indonesia, Denmark, North Macedonia, Georgia
Region
Netherlands, Spain, Luxembourg, Sweden, South Africa, Austria, Australia, Italy, France, Norway, Germany, Canada, China, United Arab Emirates
County
United States
Region/County/Local-admin
United Kingdom
Start date
Yes
End date
No
Same as the start date. An observance event is a single-day event. There are no multi-day events under the observance category. It will break into individual days if it’s celebrated over multiple days, e.g. the Saturday in the Easter weekend is recognized as Holy Saturday, with the following Sunday is Easter Sunday in Canada
Start time
No
End time
No
Timezone
No
Start date
Yes
Politics events have only a start date available.
End date
No
Start time
No
End time
No
Timezone
No
Start date
Yes
Daylight events have only a start date available.
End date
No
Start time
No
End time
No
Timezone
No
