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.
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:
- 1.
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 - 2.
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. - 3.
holiday-local: When the holiday is region-specific, e.g. only Texas state celebrates Texas Independence Day on Mar 2, 2021 - 4.
holiday-religious: When the holiday is celebrated for a religious reason, e.g. there are about 44 countries that celebrate Eid al-Adha Day - 5.
Date & Time Fields | 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 | |
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
Aviation Rank
- A national public holiday will result in a positive impact on Aviation Rank as people are likely to travel across the country or overseas during that time. If the days are close to the weekend, the events may have an Aviation Rank of 100 as there is likely a significant aviation impact.
- Local public holiday events will have an Aviation Rank of 0 as it’s less likely to cause long-distance travel
For example, Labour Day in Canada (a national holiday) has an Aviation Rank of 100, while Good Friday in Malaysia (a local common holiday) has an Aviation Rank of 0.
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.Date & Time Fields | Availability | Notes |
|---|---|---|
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 | |
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.
Note that school holiday events in the United States use polygons. Whereas school holidays in other countries do not use polygons.
The latitude and longitude is pointing to the center of the region or country.
Geo-scope Level | Countries |
|---|---|
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 |
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.
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.
Our school holiday events for the US contain polygon information showing the boundary of the school district. Polygon information is returned on the geo field.
School holidays for the US have polygons showing the school district boundary. See our guide to polygons for more details.
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):
- 1.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.
- 2.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.
- 3.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.
- 4.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. For the US we have polygons (see the polygons doc for more info) showing the area of the school district.
- 5.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.
Aviation Rank
For the United Kingdom (from September 2017) and US (from September 2018) school holidays, aviation rank is calculated by applying a linear transformation to the student numbers at the local authority level and then converted based on a logarithmic scale to an aviation rank value. Note that the aviation rank can be 0 when the student count is less than a threshold.
For example, The West Ada School District - Thanksgiving Break in Ada County, US has an Aviation Rank of 52, while the Longview Public Schools - Summer Break in Cowlitz County, US has Aviation Rank of 0.
For the school holidays events for other countries, and from the US and UK before the time periods stated above, we use the following method:
- A longer duration school holiday will result in a positive impact on Aviation Rank as the families are likely to travel across the country or overseas during the long break. The events have an Aviation Rank of 100 if they last over 12 days.
- A shorter duration school holiday will have an Aviation Rank of 0 as it’s less likely to cause aviation travel
For examples, the 9 days October School Holidays in Flevoland, Netherlands has an Aviation Rank of 0, while the 16 days Toulouse - Christmas School Holidays in Toulouse, France an Aviation Rank of 100.
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:
- 1.
observance-season- When the observance marks of the seasonal change: June Solstice, March Equinox, September Equinox, December Solstice.
- 227 countries observed the above four types of events.
- 2.
holiday-religious: When observing a religious holiday that is 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. - 3.
- 4.
observance-united-nations:- International days created by the United Nations to promote international 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.
- 5.
Date & Time Fields | Availability | NOTES |
|---|---|---|
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 | |
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
- number of well-known observances have a PHQ Rank of 90 to indicate the popularity/impact on the region. For example, New Years’ Eve, Valentine's Day, Halloween.
- The majority of observance have a PHQ rank of 50 to reflect the impact is more likely to benefit local businesses.
Local Rank
Observances events have no Local Rank available as they impact an entire area instead of a specific point.
Aviation Rank
Observances events have no Aviation 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 election 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, which currently are under community category labelled with
rallies or debates.LABELS
This category is classified into two buckets with the following labels used to identify the type of events.
- 1.Election: The date when the
parliamentorpresidentelection occurs. - 2.Referendum: The
referendumdate in the country.
Date & Time Field | Availability | NOTES |
|---|---|---|
Start date | Yes | Politics events have only a start date available. |
End date | No | |
Start time | No | |
End time | No | |
Timezone | No | |
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 is pointing 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.
Aviation Rank
Politics events have no Aviation Rank available as they are unlikely to result in a positive impact on air-travel.
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 endsDate & Time Field | Availability | Notes |
|---|---|---|
Start date | Yes | Daylight events have only a start date available. |
End date | No | |
Start time | No | |
End time | No | |
Timezone | No | |
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.
Aviation Rank
Daylight savings events have no Aviation Rank available.
PHQ Attendance
Daylight savings events have no PHQ Attendance available.
Last modified 2mo ago