node-red-contrib-feiertage-germany
v1.6.1
Published
NodeRED node to get german holidays and own special dates
Downloads
98
Maintainers
Readme
Node Red Feiertage Germany
The Node Red Feiertage Germany node is the ultimate node to get information about german holidays.
Is there any holiday missing? Write an issue! I'm going to add this holiday for you.
This node was split out of the node-red-contrib-feiertage node. This Node only contains German holidays. To get this node for another country read the point below.
You're living in Germany, Austria or Switzerland?
| country | node-red node | |-------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------| | Germany | node-red-contrib-feiertage-germany | | Austria | node-red-contrib-feiertage-austria | | Switzerland | node-red-contrib-feiertage-switzerland | | Or you want all in one node (Germany, Austria, Switzerland) | node-red-contrib-feiertage |
Installation
npm install node-red-contrib-feiertage-germany
Getting Started
At first, it's important to check that you have picked the right localisation and timezone on your device. Below you can find a manual how to change those settings on to a RaspberryPi.
Login into your Pi. Then open the settings with this command.
sudo raspi-config
Now you should see this interface. Navigate to 5 Localisation Options and press ENTER.
Here you can set your Local and Timezone. If your localisation is Germany chose de_DE.UTF-8 as your local and Europe --> Berlin as your timezone.
After you have finished setup click Finish. To make your changes valid reboot your pi.
sudo reboot
Node Description
Input
The input can be used to trigger special outputs. The keywords are listed below.
| msg.payload | output | |-------------------|---------------------------------------------------------------------------| | isTodayHoliday | boolean whether today is holiday | | isTomorrowHoliday | boolean whether tomorrow is holiday | | isChristmasTime | boolean whether today is Christmas time (1. Advent - Heilige drei Könige) | | nextHoliday | information about next holiday | | nextThreeHolidays | information about next 3 holidays | | all | information about all holidays |
Output
The output can be used to listen to automatic and user triggered events. Every day at 00:01 o'clock the node automatically outputs a boolean value whether today is a holiday.
You decide what you want to receive: Object or Array! To enable output as array open the node settings and hit the checkbox output: Array instead of Object at the bottom.
holiday object output:
| key | output | |---------|--------------------------| | id | id | | name | name | | dateObj | date (yyyy-mm-dd) | | dateDE | german date (dd.mm.yyyy) |
holiday array[3] output:
| index | output | |-------|--------------------------| | 0 | id | | 1 | name | | 2 | date (yyyy-mm-dd) | | 3 | german date (dd.mm.yyyy) |
Every day at 12 am you will receive a boolean value whether today is a holiday if daily output is enabled.
Own Holidays
You can choose up to 10 own dates. Select the day in the first dropdown-menu and the month in the second. Chose a name for your holiday and type it into the input field. Don't forget to hit the checkbox to enable your own holiday. Pay attention: The node does NOT validate your own dates. So if you set the 30 february or the 31 april as date you won't get an error message.
Example Flow
You can import this example into your Node Red flow.
[{"id":"12b97870218b4c6b","type":"inject","z":"d92a1f96.826db","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"nextHoliday","payloadType":"str","x":170,"y":800,"wires":[["c9f7f4771901bc57"]]},{"id":"5394aa2cf3efec31","type":"debug","z":"d92a1f96.826db","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"false","statusVal":"","statusType":"auto","x":610,"y":840,"wires":[]},{"id":"7d8ee4d238acf1b7","type":"inject","z":"d92a1f96.826db","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"isTodayHoliday","payloadType":"str","x":160,"y":720,"wires":[["c9f7f4771901bc57"]]},{"id":"f04512eaa5f19f68","type":"inject","z":"d92a1f96.826db","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"nextThreeHolidays","payloadType":"str","x":150,"y":840,"wires":[["c9f7f4771901bc57"]]},{"id":"acdb506597b542db","type":"inject","z":"d92a1f96.826db","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"all","payloadType":"str","x":190,"y":880,"wires":[["c9f7f4771901bc57"]]},{"id":"9d6422a4f0cbc881","type":"inject","z":"d92a1f96.826db","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"isChristmasTime","payloadType":"str","x":160,"y":920,"wires":[["c9f7f4771901bc57"]]},{"id":"7730c7a58df4ad65","type":"inject","z":"d92a1f96.826db","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"daysUntilNextHoliday","payloadType":"str","x":150,"y":960,"wires":[["c9f7f4771901bc57"]]},{"id":"b6bdd27b03a9ab5f","type":"inject","z":"d92a1f96.826db","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"isTomorrowHoliday","payloadType":"str","x":150,"y":760,"wires":[["c9f7f4771901bc57"]]},{"id":"c9f7f4771901bc57","type":"feiertageDE","z":"d92a1f96.826db","name":"Feiertage DE","local":"DE","neujahr":true,"neujahrName":"Neujahr","heiligeDreiKoenige":true,"heiligeDreiKoenigeName":"Heilige drei Könige","weiberfastnacht":true,"weiberfastnachtName":"Weiberfastnacht","valentinstag":true,"valentinstagName":"Valentinstag","rosenmontag":true,"rosenmontagName":"Rosenmontag","fastnachtsdienstag":true,"fastnachtsdienstagName":"Fastnachtdienstag","aschermittwoch":true,"aschermittwochName":"Aschermittwoch","gruendonnerstag":true,"gruendonnerstagName":"Gründonnerstag","karfreitag":true,"karfreitagName":"Karfreitag","easterSunday":true,"easterSundayName":"Ostersonntag","easterMonday":true,"easterMondayName":"Ostermontag","firstMay":true,"firstMayName":"1. Mai","christiHimmelfahrt":true,"christiHimmelfahrtName":"Christi Himmelfahrt","pfingstsonntag":true,"pfingstsonntagName":"Pfingstsonntag","pfingstmontag":true,"pfingstmontagName":"Pfingstmontag","fronleichnam":true,"fronleichnamName":"Fronleichnam","mariaHimmelfahrt":true,"mariaHimmelfahrtName":"Maria Himmelfahrt","tagDerDeutschenEinheit":true,"tagDerDeutschenEinheitName":"Tag der Deutschen Einheit","halloween":true,"halloweenName":"Halloween","allerheiligen":true,"allerheiligenName":"Allerheiligen","stMartin":true,"stMartinName":"St. Martin","bussUndBettag":true,"bussUndBettagName":"Buß und Bettag","nikolaus":true,"nikolausName":"Nikolaus","advent1":true,"advent1Name":"1. Advent","advent2":true,"advent2Name":"2. Advent","advent3":true,"advent3Name":"3. Advent","advent4":true,"advent4Name":"4. Advent","heiligabend":true,"heiligabendName":"Heiligabend","weihnachten1":true,"weihnachten1Name":"1. Weihnachtsfeiertag","weihnachten2":true,"weihnachten2Name":"2. Weihnachtsfeiertag","silvester":true,"silvesterName":"Silvester","ownHoliday1":true,"ownHoliday1Day":"28","ownHoliday1Month":"12","ownHoliday1Name":"own Date 1","ownHoliday2":false,"ownHoliday2Day":2,"ownHoliday2Month":2,"ownHoliday2Name":"own Date 2","ownHoliday3":false,"ownHoliday3Day":3,"ownHoliday3Month":3,"ownHoliday3Name":"own Date 3","ownHoliday4":false,"ownHoliday4Day":4,"ownHoliday4Month":4,"ownHoliday4Name":"own Date 4","ownHoliday5":false,"ownHoliday5Day":5,"ownHoliday5Month":5,"ownHoliday5Name":"own Date 5","ownHoliday6":false,"ownHoliday6Day":6,"ownHoliday6Month":6,"ownHoliday6Name":"own Date 6","ownHoliday7":false,"ownHoliday7Day":7,"ownHoliday7Month":7,"ownHoliday7Name":"own Date 7","ownHoliday8":false,"ownHoliday8Day":8,"ownHoliday8Month":8,"ownHoliday8Name":"own Date 8","ownHoliday9":false,"ownHoliday9Day":9,"ownHoliday9Month":9,"ownHoliday9Name":"own Date 9","ownHoliday10":false,"ownHoliday10Day":10,"ownHoliday10Month":10,"ownHoliday10Name":"own Date 10","array":false,"dailyOutput":true,"x":420,"y":840,"wires":[["5394aa2cf3efec31"]]}]