node-red-contrib-sun-position v2.2.0-beta3

node-red-contrib-sun-position for NodeRED

This is a ultimate Node-Red Timer based flow control with dusk, dawn (and variations) and much more. Additional you can get sun and moon position or to control a flow by sun or moon position. It is ideal for usage of control smart home, but also for all other time based flow control.

This is still in development! This is not fully tested and documentation are missing!

TOC

• Installation
• Quick Start
• General
  • Saving resources
  • second based accuracy
• Implemented Nodes
  • sun-position
    • sun-position - Node settings
    • Node Input
    • sun-position -Node Output
  • moon-position
    • moon-position - Node settings
    • moon-position - Node Output
  • time-inject
    • time-inject - Node settings
    • time-inject - Node Input
    • time-inject - Node Output
  • within-time
    • within-time - Node settings
  • time-comp
    • time-comp - Node settings
  • time-span
    • time-span - Node settings
  • Times definitions
    • sun times
      • remarks
        • blue hour
        • amateurDawn /amateurDusk
        • alternate properties
    • moon times
    • message, flow or global property or JSONATA expression
  • input parse formats
  • output timestamp formats
  • output timespan formats
• TODO
• Bugs and Feedback
• LICENSE
• Other

Installation

npm install node-red-contrib-sun-position

Quick Start

tbd

General

Saving resources

The nodes are designed to do not calculate time events with every arriving message or with an interval every x time. This is to be able to handle a huge amount of messages also on even on computers with low resources.

second based accuracy

The nodes are designed to be accurate to seconds. This means it was designed to turn on/off at exact given second. Other timers often work using intervals where they check your schedule only once a minute or even less. This means when you want something to come on at 08:00am, it may actually not come on until 30 seconds later. This nodes does not have this problem, it will come on at exactly 08:00:00am.

Implemented Nodes

• within-time a switch node, which forwards a message only within a certain period of time.The beginning and the end can also be sunset, sunrise, moonset, moonrise or any other sun times.
• time-inject a inject node, which can send a message on a specified time, which can also be a sun or moon time.
• sun-position a node which calculates sun position. Can be used as a switch node for specific azimuth of the sun.
• moon-position a node which calculates moon position and phases. Can be used as a switch node for specific azimuth of the sun.

sun-position

The node calculates the current sun position on any input message.

[{"id":"fc962ea1.197a3","type":"inject","z":"de4e9c38.0d942","name":"","topic":"","payload":"","payloadType":"date","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":120,"y":300,"wires":[["56265aeb.99f034"]]},{"id":"a0d0e562.7ad1d8","type":"debug","z":"de4e9c38.0d942","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"payload","x":570,"y":300,"wires":[]},{"id":"56265aeb.99f034","type":"sun-position","z":"de4e9c38.0d942","name":"","positionConfig":"2831ba70.55a636","rules":[{"valueLow":"10","valueLowType":"num","valueHigh":"100","valueHighType":"num"}],"onlyOnChange":"true","topic":"","outputs":2,"x":330,"y":300,"wires":[["a0d0e562.7ad1d8","9cc2d51.4ac0828","28e91.9d63d16f6"],["e921e01a.a0fa3"]]},{"id":"9cc2d51.4ac0828","type":"change","z":"de4e9c38.0d942","name":"azimuth","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.azimuth","tot":"msg"}],"action":"","property":"","from":"","to":"","reg":false,"x":560,"y":340,"wires":[["e866e950.a7f798"]]},{"id":"28e91.9d63d16f6","type":"change","z":"de4e9c38.0d942","name":"altitude","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.altitude","tot":"msg"}],"action":"","property":"","from":"","to":"","reg":false,"x":560,"y":380,"wires":[["5b085e1b.4ec8a"]]},{"id":"e921e01a.a0fa3","type":"debug","z":"de4e9c38.0d942","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","x":550,"y":420,"wires":[]},{"id":"e866e950.a7f798","type":"debug","z":"de4e9c38.0d942","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"payload","x":750,"y":340,"wires":[]},{"id":"5b085e1b.4ec8a","type":"debug","z":"de4e9c38.0d942","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"payload","x":750,"y":380,"wires":[]},{"id":"2831ba70.55a636","type":"position-config","z":"","name":"Kap-Halbinsel","longitude":"-34.357051","latitude":"18.473782","angleType":"deg"}]

sun-position - Node settings

• Position connects to the central configuration node, which contains the current position, but also handles internal shared functions
• Topic defines the topic of the first output
• position container here you can define multiple lower and upepr limits for azimuth. If the calculated value of the azimuth is inside the defined limit the input message will send to the associated output.
• Name name of the Node

Node Input

The Input is for triggering the calculation. If limits are defined the input message will send to the output associated to the limit.

sun-position - Node Output

• first output
  • msg.payload.azimuth the azimuth of the sun position relative to the given coordinates.
  • msg.payload.altitude the altitude/elevation of the sun position relative to the given coordinates.
  • msg.payload.times the sun times as object.
    • msg.payload.times.astronomicalDawn night ends (morning astronomical twilight starts)
    • msg.payload.times.amateurDawn amateur astronomical dawn (sun at 12° before sunrise)
    • msg.payload.times.nauticalDawn nautical dawn (morning nautical twilight starts)
    • msg.payload.times.blueHourDawnStart blue Hour start (time for special photography photos starts)
    • msg.payload.times.civilDawn dawn (morning nautical twilight ends, morning civil twilight starts)
    • msg.payload.times.blueHourDawnEnd blue Hour end (time for special photography photos starts)
    • msg.payload.times.sunrise sunrise (top edge of the sun appears on the horizon)
    • msg.payload.times.sunriseEnd sunrise ends (bottom edge of the sun touches the horizon)
    • msg.payload.times.goldenHourEnd morning golden hour (soft light, best time for photography) ends
    • msg.payload.times.solarNoon solar noon (sun is in the highest position)
    • msg.payload.times.goldenHourStart evening golden hour starts
    • msg.payload.times.sunsetStart sunset starts (bottom edge of the sun touches the horizon)
    • msg.payload.times.sunset sunset (sun disappears below the horizon, evening civil twilight starts)
    • msg.payload.times.blueHourDuskStart nautical dusk start (evening astronomical twilight starts)
    • msg.payload.times.civilDusk dusk (evening nautical twilight starts)
    • msg.payload.times.blueHourDuskEnd nautical dusk end (evening astronomical twilight starts)
    • msg.payload.times.amateurDusk amateur astronomical dusk (sun at 12° after sunrise)
    • msg.payload.times.astronomicalDusk night starts (dark enough for astronomical observations)
    • msg.payload.times.nadir nadir (darkest moment of the night, sun is in the lowest position)
  • msg.payload.pos array with a boolean of every defined limit of the azimuth, which is true if the azimuth is inside the limit.
  • msg.payload.posChanged boolean which is true if any of the defined limit of the azimuth has changed to the last calculation.

{
  "lastUpdate": "2018-11-11T11:11:11.111Z",
  "latitude": "18.473782",
  "longitude": "-34.357051",
  "angleType": "deg",
  "azimuth": 117.72942647370792,
  "altitude": 20.984193272523992,
  "times": {
      "solarNoon":"2018-12-10T10:59:14.814Z",
      "nadir":"2018-12-10T22:59:14.814Z",
      "sunrise":"2018-12-10T06:58:55.584Z",
      "sunset":"2018-12-10T14:59:34.044Z",
      "sunriseEnd":"2018-12-10T07:03:12.232Z",
      "sunsetStart":"2018-12-10T14:55:17.395Z",
      "blueHourDawnEnd":"2018-12-10T06:34:22.885Z",
      "blueHourDuskStart":"2018-12-10T15:24:06.743Z",
      "civilDawn":"2018-12-10T06:19:31.249Z",
      "civilDusk":"2018-12-10T15:38:58.379Z",
      "blueHourDawnStart":"2018-12-10T06:05:03.443Z",
      "blueHourDuskEnd":"2018-12-10T15:53:26.185Z",
      "nauticalDawn":"2018-12-10T05:37:04.859Z",
      "nauticalDusk":"2018-12-10T16:21:24.768Z",
      "amateurDawn":"2018-12-10T05:16:44.832Z",
      "amateurDusk":"2018-12-10T16:41:44.795Z",
      "astronomicalDawn":"2018-12-10T04:56:49.931Z",
      "astronomicalDusk":"2018-12-10T17:01:39.696Z",
      "goldenHourEnd":"2018-12-10T07:58:28.541Z",
      "goldenHourStart":"2018-12-10T14:00:01.086Z",
      "dawn":"2018-12-10T06:19:31.249Z",
      "dusk":"2018-12-10T15:38:58.379Z",
      "nightEnd":"2018-12-10T04:56:49.931Z",
      "night":"2018-12-10T17:01:39.696Z",
      "nightStart":"2018-12-10T17:01:39.696Z",
      "goldenHour":"2018-12-10T14:00:01.086Z"
  },
  "pos": [],
  "posChanged": false
}

• second output to ... output if limits for azimuth are defined the incomming message will send to this output. It adds a msg.posChanged property of type boolean which is true if in the previous calculation no message was send to this output.

moon-position

The node calculates the current sun position on any input message.

[{"id":"d99ac08d.fdb94","type":"moon-position","z":"de4e9c38.0d942","name":"","positionConfig":"2831ba70.55a636","rules":[],"outputs":1,"topic":"","x":340,"y":520,"wires":[["e5e8e9a1.6080e8","e9ec273d.d90168","45563d84.0c4bf4","cce94ccc.b2dd2","65c76f28.3dd49","ac44c210.86465","f2deae49.60015","a9e0a2d1.0633a","948f6e2.8a4a39","cc85e458.447ba8","bff5a621.3fb498"]]},{"id":"124bfd72.dcb2f3","type":"inject","z":"de4e9c38.0d942","name":"","topic":"","payload":"","payloadType":"date","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":120,"y":520,"wires":[["d99ac08d.fdb94"]]},{"id":"e5e8e9a1.6080e8","type":"debug","z":"de4e9c38.0d942","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"payload","x":590,"y":520,"wires":[]},{"id":"e9ec273d.d90168","type":"change","z":"de4e9c38.0d942","name":"azimuth","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.azimuth","tot":"msg"}],"action":"","property":"","from":"","to":"","reg":false,"x":580,"y":560,"wires":[[]]},{"id":"45563d84.0c4bf4","type":"change","z":"de4e9c38.0d942","name":"altitude","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.altitude","tot":"msg"}],"action":"","property":"","from":"","to":"","reg":false,"x":580,"y":600,"wires":[[]]},{"id":"cce94ccc.b2dd2","type":"change","z":"de4e9c38.0d942","name":"distance","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.distance","tot":"msg"}],"action":"","property":"","from":"","to":"","reg":false,"x":580,"y":640,"wires":[[]]},{"id":"65c76f28.3dd49","type":"change","z":"de4e9c38.0d942","name":"parallacticAngle","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.parallacticAngle","tot":"msg"}],"action":"","property":"","from":"","to":"","reg":false,"x":600,"y":680,"wires":[[]]},{"id":"ac44c210.86465","type":"change","z":"de4e9c38.0d942","name":"illumination angle","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.illumination.angle","tot":"msg"}],"action":"","property":"","from":"","to":"","reg":false,"x":610,"y":720,"wires":[[]]},{"id":"f2deae49.60015","type":"change","z":"de4e9c38.0d942","name":"illumination fraction","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.illumination.fraction","tot":"msg"}],"action":"","property":"","from":"","to":"","reg":false,"x":610,"y":760,"wires":[[]]},{"id":"a9e0a2d1.0633a","type":"change","z":"de4e9c38.0d942","name":"illumination phase","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.illumination.phase.value","tot":"msg"}],"action":"","property":"","from":"","to":"","reg":false,"x":610,"y":800,"wires":[[]]},{"id":"948f6e2.8a4a39","type":"change","z":"de4e9c38.0d942","name":"illumination phase angle","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.illumination.phase.angle","tot":"msg"}],"action":"","property":"","from":"","to":"","reg":false,"x":630,"y":840,"wires":[[]]},{"id":"bff5a621.3fb498","type":"change","z":"de4e9c38.0d942","name":"illumination zenithAngle","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.illumination.zenithAngle","tot":"msg"}],"action":"","property":"","from":"","to":"","reg":false,"x":630,"y":920,"wires":[[]]},{"id":"cc85e458.447ba8","type":"change","z":"de4e9c38.0d942","name":"illumination phase name","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.illumination.phase.name","tot":"msg"}],"action":"","property":"","from":"","to":"","reg":false,"x":630,"y":880,"wires":[[]]},{"id":"2831ba70.55a636","type":"position-config","z":"","name":"Kap-Halbinsel","longitude":"-34.357051","latitude":"18.473782","angleType":"deg"}]

moon-position - Node settings

• Position connects to the central configuration node, which contains the current position, but also handles internal shared functions
• Topic defines the topic of the first output
• position container here you can define multiple lower and upepr limits for azimuth. If the calculated value of the azimuth is inside the defined limit the input message will send to the associated output.
• Name name of the Node

moon-position - Node Output

• first output
  • msg.payload.azimuth the azimuth of the moon position relative to the given coordinates.
  • msg.payload.altitude the altitude/elevation of the moon position relative to the given coordinates.
  • msg.payload.distance the distance of the moon.
  • msg.payload.parallacticAngle the parallacticAngle of the moon.
  • msg.payload.illumination the illumination of the moon as object.
    • msg.payload.illumination.angle the illumination angle of the moon.
    • msg.payload.illumination.fraction the illumination fraction angle of the moon.
    • msg.payload.illumination.zenithAngle the illumination zenith angle of the moon.
    • msg.payload.illumination.phase the illumination phase of the moon as object.
      • msg.payload.illumination.phase.value the current phase of the moon in percent, where 0%/100% is New Moon, from 0% to 50% is growing, 50% is Full Moon and >50% is decreasing.
      • msg.payload.illumination.phase.angle the current phase angle of the moon.
      • msg.payload.illumination.phase.emoji the emoji of the current phase of the moon.
      • msg.payload.illumination.phase.code the code of the emoji for the current phase of the moon.
      • msg.payload.illumination.phase.name the name of the current phase of the moon.
  • msg.payload.times the moon times as object.
    • msg.payload.times.rise the moon rise time.
    • msg.payload.times.set the moon set time.
    • msg.payload.times.alwaysUp boolean which is true if the moon never rises/sets and is always above the horizon during the day.
    • msg.payload.times.alwaysDown boolean which is true if the moon is always below the horizon.
  • msg.payload.pos array with a boolean of every defined limit of the azimuth, which is true if the azimuth is inside the limit.
  • msg.payload.posChanged boolean which is true if any of the defined limit of the azimuth has changed to the last calculation.

{
  "lastUpdate": "2018-11-11T11:11:11.111Z",
  "latitude": "18.473782",
  "longitude": "-34.357051",
  "angleType": "deg",
  "azimuth": 108.71205459404247,
  "altitude": -9.578482237780767,
  "distance": 400811.8001636167,
  "parallacticAngle": -73.92702172116152,
  "illumination": {
    "angle": -94.27663428960696,
    "fraction": 0.14981886026806135,
    "phase": {
      "emoji": "🌒",
      "code": ":waxing_crescent_moon:",
      "name": "Waxing Crescent",
      "weight": 6.3825,
      "value": 0.12651089732280724,
      "angle": 45.54392303621061
    },
    "zenithAngle": -20.349612568445437
  },
  "times": {
    "rise": "2018-11-11T11:44:22.877Z",
    "set": "2018-11-11T23:10:07.389Z",
    "alwaysUp": false,
    "alwaysDown": false
  },
  "pos": [],
  "posChanged": false
}

• second output to ... output if limits for azimuth are defined the incomming message will send to this output. It adds a msg.payload.posChanged property of type boolean which is true if the limit has changed since the last azimuth calculation.

time-inject

Injects a message into a flow either manually or at timestamps which can also depending on the sunset, sunrise, or moon set and rise. The message payload can be a variety of types, including strings, JavaScript objects, the current time or the cuttent sun or moon position.

[{"id":"d3c04d4e.ce3e3","type":"debug","z":"de4e9c38.0d942","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","x":570,"y":2100,"wires":[]},{"id":"586e4ae2.5b4f14","type":"debug","z":"de4e9c38.0d942","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","x":570,"y":2160,"wires":[]},{"id":"1b71d0e5.35b02f","type":"debug","z":"de4e9c38.0d942","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","x":570,"y":2220,"wires":[]},{"id":"3e4d36c0.620e7a","type":"time-inject","z":"de4e9c38.0d942","name":"","positionConfig":"bdf7c4a.9ca6c38","time":"nadir","timeType":"pdsTime","timeDays":"*","offset":0,"offsetMultiplier":60,"payload":"","payloadType":"date","topic":"","x":320,"y":2100,"wires":[["d3c04d4e.ce3e3"]]},{"id":"c11713e.db07ef","type":"time-inject","z":"de4e9c38.0d942","name":"","positionConfig":"bdf7c4a.9ca6c38","time":"dawn","timeType":"pdsTime","timeDays":"*","offset":0,"offsetMultiplier":60,"payload":"","payloadType":"date","topic":"","x":320,"y":2160,"wires":[["586e4ae2.5b4f14"]]},{"id":"b227cadc.dcf8c8","type":"time-inject","z":"de4e9c38.0d942","name":"","positionConfig":"bdf7c4a.9ca6c38","time":"rise","timeType":"pdmTime","timeDays":"1,4,0","offset":0,"offsetMultiplier":60,"payload":"{\"bool\":true}","payloadType":"json","topic":"","x":340,"y":2220,"wires":[["1b71d0e5.35b02f"]]},{"id":"bdf7c4a.9ca6c38","type":"position-config","z":"","name":"","longitude":"13.71587","latitude":"51.01732","angleType":"deg"}]

time-inject - Node settings

• Position connects to the central configuration node, which contains the current position, but also handles internal shared functions
• Payload defines the payload of the message object send to the output
• Topic defines the topic of the send message
• Time An optional property that can be configured when the inject node should emit a message on that timestamp.
• Offset An optional property which is only available if an time is choosen. The offset can be a positive or negative and defines a time offset to the choosen time.

• Days An optional property which is only available if an time is choosen. There can be defined on which days a msg should be emited.

• Property optional here can be defined a context property which must be of tyxpe boolean. If this property is true alternate time will be used.

• Alternate time optional defines an alternate start time which will be used if the property is true. This can be used for different times for example of holidays/weekend.

• Additional Inject on Start If this checkbox is set the inject node dcan emit the message on Node-Red Start or on any deploy of this node. There can be defined a delay after the emit should be done. This can be usefull for initializing any flow.

• Set additional With this selection you can

  • set global, flow context or set additional property of the message object (if the property is payload the payload will be overridden.)
  • for any timestamp properties like timestamp, sun time, moon time there are a lot of possibilities to influence this. You can add an offset or select the days wherfor the timestamp should be calculated. The output format could be Unix, ECMA timestamp, object or the time difference between timestamp and emit the message. This is useful to to send a payload of true on sunset with an additional message oprperty as on time with the seconds until sunrise.
    • set additional timestamp:
    • set additional sun timestamp:
    • possible formates of timestamp output
      • number - milliseconds UNIX timestamp
      • string - ECMA-262
      • string - local date and time
      • string - local time
      • string - UTC date and time
      • string - ISO date and time
      • string - YYYYMMDDHHMMSS
      • string - YYYYMMDD.HHMMSS
      • number - milliseconds since emit
      • number - seconds since emit
      • number - minutes since emit
      • number - hour since emit
      • as object

time-inject-settings-addProp1

If this checkbox is set the inject node

time-inject - Node Input

It has only a button as input, where the massage could injected into a flow manually.

time-inject - Node Output

The output is a message with the defined payload and topic in the settings.

within-time

[{"id":"bd9bd279.302eb","type":"inject","z":"de4e9c38.0d942","name":"","topic":"","payload":"","payloadType":"date","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":120,"y":1180,"wires":[["b5c283be.eb945"]]},{"id":"273eb4cb.2715fc","type":"debug","z":"de4e9c38.0d942","name":"out1","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","x":590,"y":1180,"wires":[]},{"id":"78f068d6.2fe9f8","type":"debug","z":"de4e9c38.0d942","name":"out2","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","x":590,"y":1220,"wires":[]},{"id":"b5c283be.eb945","type":"within-time-switch","z":"de4e9c38.0d942","name":"","positionConfig":"bdf7c4a.9ca6c38","startTime":"7:00","startTimeType":"entered","startOffset":0,"startOffsetMultiplier":"60","endTime":"9:00","endTimeType":"entered","endOffset":0,"endOffsetMultiplier":"60","property":"","propertyType":"none","startTimeAlt":"","startTimeAltType":"none","startOffsetAlt":0,"startOffsetAltMultiplier":"60","endTimeAlt":"","endTimeAltType":"none","endOffsetAlt":0,"endOffsetAltMultiplier":"60","x":330,"y":1180,"wires":[["273eb4cb.2715fc"],["78f068d6.2fe9f8"]]},{"id":"bdf7c4a.9ca6c38","type":"position-config","z":"","name":"","longitude":"13.71587","latitude":"51.01732","angleType":"deg"}]

within-time - Node settings

A simple 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.

• Position connects to the central configuration node, which contains the current position, but also handles internal shared functions
• Start time defines the start time of the time range with with different configuration possibilities
  • Start Offset allows to define a positive or negative offset in seconds, minutes or hours to the given Start Time. This will be useful for sun based times.
• End time defines the end time of the time range with with different configuration possibilities
  • End Offset allows to define a positive or negative offset in seconds, minutes or hours to the given End Time. This will be useful for sun based times.
• Property optional here can be defined a boolean property. If it is true alternate start or and times will be used.
• Alternate start time optional defines an alternate start time of the time range which will be used if the property is true. This can be used for different times for example of holidays.
  • Start time alternate start time
  • Start Offset offset for the alternate start time
• Alternate end time optional defines an alternate end time of the time range which will be used if the property is true. This can be used for different times for example of holidays.
  • End time alternate end time
  • End Offset offset for the alternate end time
• Status here can be adjusted which status should be displayed under the node.
  • this has the following posibilities:
    • none - no status will be displayed - only errors - if an error occures it will be displayed
    • time limits - the time limits will be displayed. An ⎇ sign after a time will show that an alternate time is used.
    • last message - the time limits will be shown and if the last message was blocked. An ⎇ sign after a time will show that an alternate time is used. if the message was pass throught the timestamp of this message will be shown.
    • time limits or last message - on deploy/start until a message arrives the same behaviour as time limits options, otherwise the last message status display.
• resend start If this checkbox is checked and a message arrived outside of time, this message will be additional send again some milliseconds after next start time point. This option is only for fixed time definitions available.
• resend end If this checkbox is checked and a message arrived within time, this message will be additional send again some milliseconds after next end time point. This option is only for fixed time definitions available.

time-comp

A enhanced node for time format change and time comparision.

This node is in development and has a pre release state!!

[{"id":"1a6b5f99.4c928","type":"time-comp","z":"4e9a710a.bf0b9","outputs":1,"name":"","positionConfig":"d9e9ca6a.952218","input":"payload","inputType":"msg","inputFormat":"0","inputOffset":0,"inputOffsetMultiplier":60,"rules":[],"checkall":"true","result1":"payload","result1Type":"msg","result1Value":"","result1ValueType":"input","result1Format":"5","result1Offset":0,"result1OffsetMultiplier":60,"x":350,"y":120,"wires":[["fd45b2d2.eba89"]]},{"id":"fd45b2d2.eba89","type":"debug","z":"4e9a710a.bf0b9","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"false","x":570,"y":120,"wires":[]},{"id":"f390b758.7dd9b8","type":"inject","z":"4e9a710a.bf0b9","name":"","topic":"","payload":"","payloadType":"date","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":160,"y":120,"wires":[["1a6b5f99.4c928"]]},{"id":"b87a5c79.d4ce3","type":"comment","z":"4e9a710a.bf0b9","name":"change Unix Timestamp to ISO","info":"","x":210,"y":80,"wires":[]},{"id":"20afdf5d.4cd8d","type":"comment","z":"4e9a710a.bf0b9","name":"compare Time","info":"","x":150,"y":180,"wires":[]},{"id":"3d8ee66c.7c86ea","type":"inject","z":"4e9a710a.bf0b9","name":"","topic":"","payload":"","payloadType":"date","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":160,"y":240,"wires":[["f19f0fd9.8ad1d"]]},{"id":"f19f0fd9.8ad1d","type":"time-comp","z":"4e9a710a.bf0b9","outputs":3,"name":"","positionConfig":"d9e9ca6a.952218","input":"payload","inputType":"msg","inputFormat":"0","inputOffset":0,"inputOffsetMultiplier":60,"rules":[{"operator":"5","operatorType":"11,12,13,14,15,16,17,18","operatorText":"","operandType":"str","operandValue":"12:00","format":"ddd MMM dd yyyy HH:mm:ss","formatSelection":"0","offsetType":"none","offsetValue":"","propertyType":"none","propertyValue":""},{"operator":"3","operatorType":"11,12,13,14,15,16,17,18","operatorText":"","operandType":"str","operandValue":"15:00","format":"ddd MMM dd yyyy HH:mm:ss","formatSelection":"0","offsetType":"none","offsetValue":"","propertyType":"none","propertyValue":""}],"checkall":"true","result1":"payload","result1Type":"msg","result1Value":"","result1ValueType":"input","result1Format":"5","result1Offset":0,"result1OffsetMultiplier":60,"x":350,"y":240,"wires":[["723d7d7c.e7a874"],["44ac03f7.fd68fc"],["4d8512cd.73c90c"]]},{"id":"723d7d7c.e7a874","type":"debug","z":"4e9a710a.bf0b9","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"payload","x":570,"y":220,"wires":[]},{"id":"44ac03f7.fd68fc","type":"debug","z":"4e9a710a.bf0b9","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"payload","x":570,"y":260,"wires":[]},{"id":"4d8512cd.73c90c","type":"debug","z":"4e9a710a.bf0b9","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"false","x":570,"y":300,"wires":[]},{"id":"d9e9ca6a.952218","type":"position-config","z":0,"name":"Entenhausen","longitude":"13.72324","latitude":"51.12381","angleType":"deg"}]

time-comp - Node settings

A simple 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.

• Position connects to the central configuration node, which contains the current position, but also handles internal shared functions
• Input defines the input parameter for the time stamp
  • parse format defines the format for the input parameter, more information see input parse formats.
  • Offset allows to define a positive or negative offset to the given Input Time.
• compare with here can be defined various definitions of times to which the input time should be compared.
  • operator Drop down to define operator
  • compare type allows to define whoat parts of the timestring shoudl be compared. Default is a comparision of the complete timestamp. But it is possible to only compare a pat like the only the year.
  • time defines where the time to which should be compared comes from
  • parse format defines the format for the time to compare, more information see input parse formats.
  • Offset allows to define a positive or negative offset to the given time.
  • limitation here it is possible to additionally define a parameter. if defined this comparision will only be made if this parameter has the value "true".
• result allows to write the Input time to a parameter in a different format. Without defining any compare with, the node allows by only defining input and result parameter a simply time format conversation.

time-span

A enhanced node for time span calculation and time span comparision.

This node is in development and has a pre release state!!

tbd

time-span - Node settings

A simple 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.

• Position connects to the central configuration node, which contains the current position, but also handles internal shared functions
• Input 1 defines the first input parameter for the time span calculation
  • parse format defines the format for the first input parameter, more information see input parse formats.
  • Offset allows to define a positive or negative offset to the given Input 1 Time.
• Input 2 defines the second input parameter for the time span calculation
  • parse format defines the format for the second input parameter, more information see input parse formats.
  • Offset allows to define a positive or negative offset to the given Input 2 Time.
• compare with here can be defined various time spams to which the time span between timestamp of input 1 and input 2 should be compared.
  • operator Drop down to define operator for comparision
  • time defines a number to which should be the timespan be compared
  • time type the unit of the given time
• result ** as result of an incomming message, data could be written to that destination. This could be a message property, a flow or a global context.
  • result value defines the value which should be written to the result destination. Could be the timestamp, one of the Input times or any other time/data. For timestamp or times the output format or maybe an offset could be defined.

Without defining any comparision, the node allows by only defining inputs and result a simply timespan calculation.

Times definitions

The time definitions of the nodes has different configuration possibilities

manual timestamps can be entered as one of the following formats:

• 00:00 ... 23:59 24h Format
• 00:00:00 ... 23:59:00 24h Format with seconds
• 00:00pm ... 12:59pm 12h Format
• 00:00:00pm ... 12:59:00pm 12h Format with seconds

sun times

following Sun times can be choosen:

SunBH is the angle of the sun below the horizon

remarks

blue hour

Although the blue hour does not have an official definition, the blue color spectrum is most prominent when the Sun is between 4° and 8° below the horizon.

amateurDawn /amateurDusk

This is not an official definition, this is happend when the Sun is 15° below the horizon

alternate properties

The following time parameters are exists in the output for backwart compatibility. These are equal to parameters in the table above:

moon times

moon rise and moon set can be used

message, flow or global property or JSONATA expression

any message, flow or global property which contain any of the following types:

• Integer which is a Unix Time Stamp representing the number of milliseconds since January 1, 1970, 00:00:00 UTC, with leap seconds ignored.
• String value representing a valid JavaScript date-string.

String as one of the following formats:

• 00:00 ... 23:59 24h Format
• 00:00:00 ... 23:59:00 24h Format with seconds
• 00:00pm ... 12:59pm 12h Format
• 00:00:00pm ... 12:59:00pm 12h Format with seconds

Offsets: The start and end time can have an offset. This is specified in seconds,minutes or hours:

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

input parse formats

Some nodes has the ability to get an input time out of different pre defined formats or a free format definition.

The formats are:

• milliseconds UNIX timestamp This is the default for Node-ed. Timestamps are a numeric representation of the time in milliseconds since 1970-01-01 UTC
• ECMA-262 YYYY-MM-DDTHH:mm:ss.sssZ - This is the default toString output of JavaScript. This is a simplification of the ISO 8601 Extended Format.
• YYYYMMDDHHMMSS is a number of the format YYYYMMDDHHMMSS.
• YYYYMMDD.HHMMSS is a number of the format YYYYMMDD.HHMMSS.
• various the system will try to parse different string formats

• other there you can define a format like "yyyy-MM-dd HH:mm:ss" of the given time. Possible format placeholders are:

  Field	Full Form	Short Form
  Year	yyyy (4 digits)	yy (2 digits), y (2 or 4 digits)
  Month	MMM (name or abbr.)	MM (2 digits), M (1 or 2 digits)
  Month	NNN (abbr.)
  Day of Month	dd (2 digits)	d (1 or 2 digits)
  Day of Week	EE (name)	E (abbr)
  Hour (1-12)	hh (2 digits)	h (1 or 2 digits)
  Hour (0-23)	HH (2 digits)	H (1 or 2 digits)
  Hour (0-11)	KK (2 digits)	K (1 or 2 digits)
  Hour (1-24)	kk (2 digits)	k (1 or 2 digits)
  Minute	mm (2 digits)	m (1 or 2 digits)
  Second	ss (2 digits)	s (1 or 2 digits)
  Millisecond	ll (3 digits)	l (1, 2 or 3 digits)
  AM/PM	tt (2 digits)	t (1 or 2 digits)

output timestamp formats

For timestamp outputs some nodes has the ability to define the format of the timestamp. Therfore different pre defined formates exists or a free format definition.

The formats are:

• milliseconds UNIX timestamp Timestamps are a numeric representation of the time in milliseconds since 1970-01-01 UTC
• ECMA-262 YYYY-MM-DDTHH:mm:ss.sssZ - This is the default toString output of JavaScript. This is a simplification of the ISO 8601 Extended Format.
• YYYYMMDDHHMMSS is a number of the format YYYYMMDDHHMMSS.
• YYYYMMDD.HHMMSS is a number of the format YYYYMMDD.HHMMSS.
• local is the javascript output of date.toLocaleString()
• localLong is the javascript output of date.toString()
• localTime is the javascript output of date.toLocaleTimeString()
• localTimeLong is the javascript output of date.toTimeString()
• localDate is the javascript output of date.toLocaleDateString()
• localDateLong is the javascript output of date.toDateString()
• UTC is the javascript output of date.toUTCString()
• ISO YYYY-MM-DDTHH:mm:ss.sssZ (output of date.toISOString())
• ms the time in milliseconds between output and timestamp
• sec the time in seconds between output and timestamp
• min the time in minutes between output and timestamp
• hour the time in hours between output and timestamp
• Day Name the timestamps day in the format Monday, 22.12.
• Day in relative the timestamps day in relative to output time in the format Today, 22.12.
• object gived back an object for the timestamp with the following properties:
  • date Javascript Date object
  • ts number - Unix timestamp (milliseconds since 1970-01-01 UTC)
  • timeUTCStr string representation of the TIme in UTC format
  • timeISOStr string representation of the TIme in ISO format
  • timeLocaleStr the javascript output of date.toLocaleString()
  • timeLocaleTimeStr the javascript output of date.toLocaleTimeString()
  • delay the time in milliseconds between output and timestamp
  • delaySec the time in seconds between output and timestamp
• other there you can define a format like "yyyy-MM-dd HH:mm:ss" of the given time. Possible format placeholders are:

output timespan formats

For timespan output the calc-timespan node has the ability to define the format of the timespan. Therfore different pre defined formates exists or a free format definition.

The formats are:

• ms timespan im milliseconds (integer value)
• sec, min,..., month, years timespan as a floating point number or as a integer number of the the choosen unit.
• object gived back an object for the timespan with the following properties:
  • date Javascript Date object
  • ts number - Unix timestamp (milliseconds since 1970-01-01 UTC)
  • timeUTCStr string representation of the TIme in UTC format
  • timeISOStr string representation of the TIme in ISO format
  • timeLocaleStr the javascript output of date.toLocaleString()
  • timeLocaleTimeStr the javascript output of date.toLocaleTimeString()
  • delay the time in milliseconds between output and timestamp
  • delaySec the time in seconds between output and timestamp
• other there you can define a format like "yyyy-MM-dd HH:mm:ss" of the given time. Possible format placeholders are:

TODO

• change icon size to 40x60 https://github.com/node-red/node-red.github.io/pull/39
• add posibility to select input/output timezone
  • select auto ad get info from getTimezoneOffset
  • solve problem of dst
• time Span
  • zeitraum zwischen 2 zeitpunkten ausrechnen
  • die möglichkeit statt Zeitpunkt - Zeitraum auszugeben auch sowas wie Zeitpunkt - Zeitraum > Limit true/false rauszugeben
  • offset für Input als Typed Input mit Wahl des offset: NA, num, msg, flow, global
  • als Input 1. Des Monats, letzter Tag des Monats, Monatsmitte, erster+ letzter Mo, Di, Mi, Do, Fr, Sa, So im Monat
• within-time
  • add Payload hinzufügen wie bei time inject - um beispielsweise dem Message Objekt mehr Infos hinzuzufügen
  • als Start und Ende Midnight hinzufügen
  • offset als Typed Input mit Wahl des offset: NA, num, msg, flow, global
• Time Inject
  • Midnight als auswahl für Zeit hinzufügen
  • offset als Typed Input mit Wahl des offset: NA, num, msg, flow, global
• time-comp
  • vergleicht mit 1. Des Monats, letzter Tag des Monats, Monatsmitte, erster+ letzter Mo, Di, Mi, Do, Fr, Sa, So im Monat
  • offset als Typed Input mit Wahl des offset: NA, num, msg, flow, global

Bugs and Feedback

For bugs, questions and discussions please use the GitHub Issues.

:moneybag: Donations

Even for those that don't have the technical knowhow to help developing on there are ways to support development. So if you want to donate some money please feel free to send money via PayPal.

LICENSE

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this nodes except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Other

this node is published also here:

• NPM package
• Node-Red