Holiday today
Tool ID: holidaycalendar_today
Summary
Checks whether today is a public holiday in a country or in one of its regions. You can shift the day by a timezone offset in whole hours.
When to use it
- You want to know if today is a day off where you are.
- The country is ahead of or behind UTC, and “today” might already be tomorrow there.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| Extra service login | No |
Parameters
| Parameter | Required? | Description |
|---|---|---|
iso_code |
Yes | Country code such as US, or a region code such as DE-BY or AT-1. |
utc_offset |
No | Whole hours from UTC, from -12 to 12. Leave it out for UTC. Use -5 for US Eastern standard time, or 1 for central Europe in winter. |
holiday_types |
No | Which holiday records to list for that local date. Leave it out for public holidays. This does not change the yes-or-no public-holiday answer. |
national_only |
No | When set, the holiday list leaves out regional-only days. The yes-or-no answer still follows iso_code. |
What you get back
The local date that was checked, whether today is a public holiday there, and the holiday records for that date.
The yes-or-no flag follows the country or region you named. The list follows the type filter, which is public holidays unless you ask for more.
Example prompts
Is today a public holiday in Germany? Use central European time.
Is today a public holiday in California?
Is today a public holiday in Japan?
Tips
- The offset is whole hours only. It does not follow daylight-saving changes by itself, so name the offset that applies today.
- For a date that is not today, use Is a holiday.