Skip to content

calendar_holidays

Public holidays for a country (ISO 3166-1 alpha-2) via date.nager.at. Calendar highlights this month's holiday dates, Text shows today's holiday name when one matches, and TextBlock lists the next few upcoming holidays.

KindSafetyShapes
cachedSafecalendar, text, text_block
OptionTypeRequiredDefaultDescription
countrystring (ISO 3166-1 alpha-2, e.g. "JP" / "US")yesCountry whose public holidays to fetch.
language"local" | "english"no"local"Display-name source. local uses the country's localized name; english uses the English label.
limitinteger (1..=30)no5Maximum number of upcoming holidays to list (TextBlock shape only).
ShapeRenderers
calendaranimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, grid_calendar
textanimated_boot, animated_figlet_morph, animated_postfx, animated_scanlines, animated_splitflap, animated_typewriter, animated_wave, text_ascii, text_plain
text_blockanimated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, list_plain
     April 2026             
 Su Mo Tu We Th Fr Sa       
           1  2  3  4       
  5  6  7  8  9 10 11       
 12 13 14 15 16 17 18       
 19 20 21 22 23 24 25       
 26 27 28 29 30             
                            
                            
                            
[[widget]]
id = "calendar_holidays"
fetcher = "calendar_holidays"
render = "grid_calendar"
                                                                        
                                                       
                                                      
                                                     
                                                                                
[[widget]]
id = "calendar_holidays"
fetcher = "calendar_holidays"
render = "text_ascii"
🎌  Showa Day                            
                                        
[[widget]]
id = "calendar_holidays"
fetcher = "calendar_holidays"
render = "text_plain"
04/29  Showa Day                       
05/03  Constitution Day                
05/04  Greenery Day                    
05/05  Children's Day                  
[[widget]]
id = "calendar_holidays"
fetcher = "calendar_holidays"
render = "list_plain"