openhab-docs/_addons_bindings/ntp

id	label	title	type	description	since	install
ntp	NTP	NTP - Bindings	binding	The NTP binding is used for displaying the local date and time based update from an NTP server.	2x	auto

{% include base.html %}

NTP Binding

The NTP binding is used for displaying the local date and time based update from an NTP server.

Supported Things

This binding supports one ThingType: ntp

Discovery

Discovery is used to place one default item in the inbox as a convenient way to add a Thing for the local time.

Binding Configuration

The binding has no configuration options, all configuration is done at Thing level.

Thing Configuration

The thing has a few configuration options:

Option	Description
hostname	NTP host server, e.g. nl.pool.ntp.org
refreshInterval	Interval that new time updates are posted to the eventbus in seconds
refreshNtp	Number of updates between querying the NTP server (e.g. with refreshinterval = 60 (seconds) and refreshNtp = 30 the NTP server is queried each half hour.
timeZone	Timezone, can be left blank for using the default system one
locale	Locale, can be left blank for using the default system one

Channels

The ntp binding has two channels:

• dateTime which provides the data in a dateTime type
• string which provides the data in a string type. The string channel can be configured with the formatting of the date & time. This also allows proper representation of timezones other than the java machine default one. See the java documentation for the detailed information on the formatting

Full Example

Things:

ntp:ntp:demo  [ hostname="nl.pool.ntp.org", refreshInterval=60, refreshNtp=30 ]

Items:

DateTime Date  "Date [%1$tA, %1$td.%1$tm.%1$tY %1$tH:%1$tM]"  { channel="ntp:ntp:demo:dateTime" }