node-red-contrib-time-range-switch v1.2.0

Time Range Switch

A simple Node-RED node that routes messages depending on the time. If the current time falls within the range specified in the node configuration, the message is routed to output 1. Otherwise the message is routed to output 2.

Installation

Change directory to your node red installation:

$ npm install node-red-contrib-time-range-switch

Configuration

The times can be a 24 hour time or a suncalc event:

Offsets

The start and end time can have an offset. This is specified in minutes:

• -ve number brings the time forward. E.g. if the time is dusk and offset is -60, the start time will be 60 minutes before dusk.
• +ve number delays the time by the specified number of minutes

Programmatic Configuration

This node can be controlled programmatically by sending configuration settings to the node input.

It is very important to note that properties set programmatically in this manner are transient. They will not persist over a NodeRED restart or redeploy!

E.g. send the following to the input:

    msg.__config = {
        startTime: '12:35',
        endTime: 'dusk',
        startOffset: 0,
        endOffset: 0,
        lat: 51.33411,
        lon: -0.83716
    }

You can send any combination of those configuration properties. For example, you might just want to set startTime and endTime, so you only include those properties in the configuration object.

If you send a message to the input with only the __config object included, the node will consume the message and emit no output.

If you send a message to the input with the config object included and/or a payload/topic, the node will firstly process the config object, remove it from the message and allow the remainder of the message to be emitted as per the configured rules.