This page is part of archived documentation for openHAB 3.3. Go to the current stable version
The ephemeris category provides blocks with calendar functionality. The blocks can be used to determine what type of day today is, or a number of days before or after today is. For example, a way to determine if today is a weekend, a bank holiday, someone’s birthday, trash day, etc.
Definition of holidays can be customised through the ephemeris.cfg file. See the Ephemeris configuration page (opens new window) for more information.
# Overview of the Ephemeris blocks
# Ephemeris Blocks
More about that topic can be viewed at Using Ephemeris information (opens new window)
# Holiday, weekend or weekday check
Function: this block checks if the given date is a holiday, weekday or weekend.
# Get the holiday name for a particular date
Function: Returns the holiday name for the given date.
null if no holiday is found for the date.
# Get the number of days until a specific holiday
Function: Return the number of days until the given holiday name, or
-1 if the holiday is not found.
Some holidays are already provided by default from openHAB. Additional holidays must be configured in ephemeris.cfg.