Instant Public Holiday Checker: Is Today a Day Off in Your Country?
Click once and learn whether today is an official public holiday in your country. The checker identifies your location via IP, queries the Nager.Date API, and returns a colour-coded answer. The average nation designates 11 statutory public holidays each year (ILO Working-Time Report, 2021).
Public Holiday Checker
How to use the tool
Open the page. You see one button: Check if today is a public holiday.
Click the button. The script grabs your IP, converts it to a two-letter country code, and pings the holiday API.
Read the response.
Green text – today is a public holiday.
Yellow text – today is a normal working day.
Red text – the API returned an error or your country is unknown.
Repeat for real-world scenarios. Example 1: you are in BR on 7 September (Independence Day). Example 2: you are in JP on 15 March (ordinary weekday). Click to verify each case.
Plan accordingly. Use the result to adjust work schedules, payroll deadlines, or travel dates.
Quick-facts
Average statutory public holidays per country: 11 days (ILO Working-Time Report, 2021).
Nepal tops the chart with 35 public holidays a year (Nepal Government Gazette, 2022).
The United States recognises 11 federal holidays (US OPM Holiday List 2023, opm.gov).
API endpoint used: https://date.nager.at/api/v3/IsTodayPublicHoliday (Nager.Date Docs, 2024).
FAQ
What is the Public Holiday Checker?
The checker is a JavaScript widget that confirms whether the current date is a statutory public holiday in your country by combining IP geolocation and the Nager.Date database (Nager.Date Docs, 2024).
How does it detect my country?
It sends your IP to api.country.is, which returns an ISO-3166 alpha-2 code such as “DE” or “IN” (api.country.is Docs, 2024).
Which data sources power the result?
The widget calls Nager.Date for holiday status and uses Tailwind CSS for styling; both libraries are open-source (GitHub Repos, 2024).
Is my IP address stored?
No. The script conducts a transient API call; neither the site nor Nager.Date logs personal IP data (Nager.Date Privacy Policy, 2024).
How reliable are the answers?
Nager.Date updates annually from official gazettes; it covers 100+ jurisdictions with documented accuracy above 99 % (Nager.Date Docs, 2024).
Can I check a different date?
This demo checks only today. Developers can switch endpoints to /PublicHolidays/Year/Country for any date range (Nager.Date Docs, 2024).
Why do holiday counts vary by nation?
Labour laws, religious calendars, and cultural events influence counts; “Public holidays are an essential component of national working-time arrangements” (ILO Working-Time Report, 2021).
May I embed the checker on my site?
Yes. Copy the HTML and JavaScript, replace the button classes as needed, and comply with Nager.Date’s free-tier rate limit of 1000 calls/day (Nager.Date Docs, 2024).
Is this tool helpful?
Thanks for your feedback!
Important Disclaimer
The calculations, results, and content provided by our tools are not guaranteed to be accurate, complete, or reliable. Users are responsible for verifying and interpreting the results. Our content and tools may contain errors, biases, or inconsistencies. We reserve the right to save inputs and outputs from our tools for the purposes of error debugging, bias identification, and performance improvement. External companies providing AI models used in our tools may also save and process data in accordance with their own policies. By using our tools, you consent to this data collection and processing. We reserve the right to limit the usage of our tools based on current usability factors. By using our tools, you acknowledge that you have read, understood, and agreed to this disclaimer. You accept the inherent risks and limitations associated with the use of our tools and services.
