Nicely Pointed Mandibles


    1.2.0 • Public • Published

    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.


    Change directory to your node red installation:

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


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

    Time Description
    00:00 ... 23:59 24hr time in hours and minutes
    00:00:03 ... 23:59:13 24hr time in hours minutes and seconds
    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)


    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.


    npm i node-red-contrib-time-range-switch

    DownloadsWeekly Downloads






    Unpacked Size

    34.4 kB

    Total Files


    Last publish


    • biddster