nymea-plugins/datetime

Time

The time plugin allows you to create rules based on time, day, month, year, weekday or on weekend.

Usage

For the correct setup, you can configure the time zone in the plugin configuration. The language of the "month name" and "weekday name" depends on the locale settings of your system. To have the correct time you need ntp.

** Today **

The today thing gives you information about the current day and some special times of the day like dawn, sunrise, noon, sunset and dawn. In order to get the correct times of the current day for your location, the plugin needs to know where you are. The plugin will autodetect your location according to you WAN IP http://ip-api.com/json and will download the sunset / sunrise times from the online database http://sunrise-sunset.org/. If the configured timezone does not match with the autodetected timezone from the IP, the specialdates will be set to 0 (01.01.1970 - 00:00.00).

The weekday integer value stands for:

• Monday: 1
• Tuesday: 2
• Wednesday: 3
• Thursday: 4
• Friday: 5
• Saturday: 6
• Sunday: 7

The weekend state will be true, if the current weekday is Saturday or Sunday, otherwise it will be false.

Supported Things

• Today
  • Get location, country, closest city
  • Timezone
  • Get date: weekend, day, month and year
  • Get astronomic data: dawn, noon, sunset, dusk
• Alarm
  • Define time for trigger
  • Choose trigger to be time or astronomical events.
  • Set weekdays
  • Emits an event on alarm
• Countdown
  • Specify duration hours/minutes/seconds
  • Start, stop, restart timer
  • Get running state
  • Emits event on timeout

Requirements

• Internet connection
• The package 'nymea-plugin-datetime' must be installed.

More

Special times of a day (original source)