40 lines
1.8 KiB
Markdown
40 lines
1.8 KiB
Markdown
# Time
|
|
|
|
The time plugin allows you create rules based on the time, day, month, year, weekday or on weekend.
|
|
|
|
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 the system. To have the correct
|
|
time you need [ntp](https://en.wikipedia.org/wiki/Network_Time_Protocol).
|
|
|
|
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.
|
|
|
|
## Today
|
|
|
|
The today plugin 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](http://ip-api.com/json).
|
|
and will download the sunset / sunrise times from the online database [http://sunrise-sunset.org/](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).
|
|
|
|
|
|
|
|
Special times of a day ([original source](https://en.wikipedia.org/wiki/Twilight#/media/File:Twilight_description_full_day.svg))
|
|
|
|
## Alarm
|
|
|
|
The alarm plugin allows you to define an alarm which depends on a certain time, weekday or special day time like sunrise or
|
|
sunset. An offset can also be definend.
|
|
|
|
## Countdown
|
|
The countdown plugin allows you to define a countown which triggers an event on timeout.
|