@teamteanpm2024/praesentium-voluptas-aliquam NPM

node-red-contrib-timegate

Switches the input received on out1 or out2 depending on the time and the settings of the node.

The node compares the current time to up to five different time configurations and thansfers its input unmodified on the first output if the current time matches any of the configuration or, otherwise, on the second output.

node-red-contrib-timegate

Inputs

msg (any type)

Any input message is passed unmodified to one of the outputs.

Outputs

out-1

Passes the input msg when any of the time configuration matches the current time.

out-2

passes the input msg when none of the timer matches the current time.

Configurations

node-red-contrib-timegate-setup

Reference datetime

The node can use the current date and time to check against one of it's configurations or can be initialized with a property inside the message passed to it's input, a value inside the flow object or a global value.

You can use the Reference DateTime Field to decide where to get an external reference datetime from.

The value can be specified in one of these formats:

YYYY/MM/DD HH:mm 
YYYY/MM/DD

If the msg/flow/global variable is not set, the node will use the current date time.

Time matching configurations

You can configure up to five different time matching configurations to be checked against the reference datetime.

For each configuration, you can specify these parameters:

Time

One or more time ranges separated by commas.

A time can be be a 24 hour time or a SunCalc event, as expressed by the SunCalc Library.

Keywords are case insensitive.

Property	Description
sunrise	sunrise (top edge of the sun appears on the horizon)
sunriseEnd	sunrise ends (bottom edge of the sun touches the horizon)
goldenHourEnd	morning golden hour (soft light, best time for photography) ends
solarNoon	solar noon (sun is in the highest position)
goldenHour	evening golden hour starts
sunsetStart	sunset starts (bottom edge of the sun touches the horizon)
sunset	sunset (sun disappears below the horizon, evening civil twilight starts)
dusk	dusk (evening nautical twilight starts)
nauticalDusk	nautical dusk (evening astronomical twilight starts)
night	night starts (dark enough for astronomical observations)
nadir	nadir (darkest moment of the night, sun is in the lowest position)
nightEnd	night ends (morning astronomical twilight starts)
nauticalDawn	nautical dawn (morning nautical twilight starts)
dawn	dawn (morning nautical twilight ends, morning civil twilight starts)

Example:

10:15-11:30 or 10:00-12:00,15:30-16:30
12:00-goldenHour or sunsetStart-sunset

Day

One or more day values separated by commas.

Possible values:

1,8,15,21 to match the day number
SUN,MON,TUE,WED,THU,FRI,SAT to match the day name
ODD,EVEN to match odd or even days based on the number of the day in the month (1-31)
ODD-YEAR,EVEN-YEAR to match odd or even days based on the number of the day in the year (1-365)

Example:

1,SUN,ODD is true for: the first day of the month, every sundays and every odd day number in the month

SAT,SUN,EVEN-YEAR is true on saturdays and sundays and on every even day based the number of the day in the year

Week

One or more week values separated by commas.

Possible values:

1,2,3,4,5,6 to match the week number in the month
ODD,EVEN to match odd or even weeks based on the number of the week in the month (1-6)
ODD-YEAR,EVEN-YEAR to match odd or even weeks based on the number of the day in the year (1-52)

Example:

1,EVEN-YEAR is true for: the first week of the month and every even week number in the year

Month

One or more month values separated by commas.

Possible values:

1,2,3,4,5,6 to match the month

Example:

1,2,3 is true for: January, February and March

Multiple configurations

For every timer configuration the time settings is mandatory. If you add any day, week or month settings, these are evaluated in AND between each other.

Multiple timer configurations are evaluated in OR between each other.

Example:

Time: 10:00-11:00
Day: ODD
Week: EVEN-YEAR
Month: 1,2,3,4,5,6

This configuration will pass the input to Out-1 only from 10:00 to 11:00 of every odd day (based on the number of the day in the month) of every even week (based on the number of the week in the year) and from January to June. Otherwise, it will pass the input to Out-2.