node-red-contrib-feiertage

1.6.1 • Public • Published

banner

Node Red Feiertage

NPM NPM_downloads issues

NPM

The Node Red Feiertage node is the ultimate node to get information about german, austrian and swiss holidays.

Are there any holidays missing? Write an issue! I'm going to add these holidays for you.

This node contains all german, austrian and swiss holidays. To get the perfect node for your 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

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.

pi_settings_1

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.

pi_settings_2

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
daysUntilNextHoliday number of days until next 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.

own_holiday_example

Example Flow

You can import this example into your Node Red flow.

flow_example

[{"id":"56d64fd2e4bee366","type":"inject","z":"d92a1f96.826db","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"nextHoliday","payloadType":"str","x":170,"y":160,"wires":[["ac8dee9a6f24cae2"]]},{"id":"85c391cbe019a4d7","type":"debug","z":"d92a1f96.826db","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"false","statusVal":"","statusType":"auto","x":590,"y":200,"wires":[]},{"id":"08229fcaf5f944f2","type":"inject","z":"d92a1f96.826db","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"isTodayHoliday","payloadType":"str","x":160,"y":80,"wires":[["ac8dee9a6f24cae2"]]},{"id":"c209950abc65da20","type":"inject","z":"d92a1f96.826db","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"nextThreeHolidays","payloadType":"str","x":150,"y":200,"wires":[["ac8dee9a6f24cae2"]]},{"id":"1cdc14b92a4b5eae","type":"inject","z":"d92a1f96.826db","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"all","payloadType":"str","x":190,"y":240,"wires":[["ac8dee9a6f24cae2"]]},{"id":"56143ef5c7760b02","type":"inject","z":"d92a1f96.826db","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"isChristmasTime","payloadType":"str","x":160,"y":280,"wires":[["ac8dee9a6f24cae2"]]},{"id":"12d77ddf17208708","type":"inject","z":"d92a1f96.826db","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"daysUntilNextHoliday","payloadType":"str","x":140,"y":320,"wires":[["ac8dee9a6f24cae2"]]},{"id":"ac8dee9a6f24cae2","type":"feiertage","z":"d92a1f96.826db","name":"Feiertage","neujahr":true,"neujahrName":"Neujahr","berchtoldstag":true,"berchtoldstagName":"Berchtoldstag","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","stJosef":true,"stJosefName":"St. Josef","gruendonnerstag":true,"gruendonnerstagName":"Gründonnerstag","karfreitag":true,"karfreitagName":"Karfreitag","easterSunday":true,"easterSundayName":"Ostersonntag","easterMonday":true,"easterMondayName":"Ostermontag","firstMay":true,"firstMayName":"1. Mai","stFlorian":true,"stFlorianName":"St. Florian","christiHimmelfahrt":true,"christiHimmelfahrtName":"Christi Himmelfahrt","pfingstsonntag":true,"pfingstsonntagName":"Pfingstsonntag","pfingstmontag":true,"pfingstmontagName":"Pfingstmontag","fronleichnam":true,"fronleichnamName":"Fronleichnam","bundesfeierCH":true,"bundesfeierCHName":"Bundesfeiertag","peterUndPaul":"Peter und Paul","peterUndPaulName":true,"mariaHimmelfahrt":true,"mariaHimmelfahrtName":"Maria Himmelfahrt","stRupert":true,"stRupertName":"St. Rupert","tagDerDeutschenEinheit":true,"tagDerDeutschenEinheitName":"Tag der Deutschen Einheit","tagDerVolksabstimmung":true,"tagDerVolksabstimmungName":"Tag der Volksabstimmung","nationalfeiertagAT":true,"nationalfeiertagATName":"Nationalfeiertag","halloween":true,"halloweenName":"Halloween","allerheiligen":true,"allerheiligenName":"Allerheiligen","stMartin":true,"stMartinName":"St. Martin","stLeopold":true,"stLeopoldName":"St. Leopold","bussUndBettag":true,"bussUndBettagName":"Buß und Bettag","nikolaus":true,"nikolausName":"Nikolaus","mariaeEmpfaengnis":true,"mariaeEmpfaengnisName":"Mariä Empfängnis","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":"9","ownHoliday1Name":"Birthday","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":"7","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":410,"y":200,"wires":[["85c391cbe019a4d7"]]},{"id":"e927971f4c9bfefd","type":"inject","z":"d92a1f96.826db","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"isTomorrowHoliday","payloadType":"str","x":150,"y":120,"wires":[["ac8dee9a6f24cae2"]]}]

Dependencies (1)

Dev Dependencies (3)

Package Sidebar

Install

npm i node-red-contrib-feiertage

Weekly Downloads

12

Version

1.6.1

License

MIT

Unpacked Size

260 kB

Total Files

15

Last publish

Collaborators

  • mariuslang