clock

Usage

>> clock [ datetime | offsetfromutc ]

Security

Unsafe.

Description

Retrieve or set the logger's current date and time. The clock can only be changed when the instrument is not logging or streaming.

• datetime [=<YYYYMMDDhhmmss>], reports or sets the current date and time.

• offsetfromutc [=<+/-hh.hh>] is intended to record the local timezone used when the logger was deployed, as an offset from Universal Coordinated Time (UTC). This can facilitate correct interpretation of the time information, even if the downloaded data file is reviewed in a different time zone. The offset is specified in hours; fractional hours are permitted to support time zones which require this, and the offset is always reported to two decimal places. When specifying a value, any simple numeric format compatible with floating point representation may be used; for example 11, +11, or 11.00 would all be accepted.  Setting this parameter does not change the logger's time as reported by the datetime parameter; it is intended simply as a record of the local time zone. Any change made is persistent, and will be retained until changed again. By default the offsetfromutc +0.00 which represent UTC.

Examples

>> clock
<< clock datetime=20240401120000 offsetfromutc=+1.00

>> clock datetime=20240401120130
<< clock datetime=20240401120130

>> clock 
<< clock datetime=20240401120130 offsetfromutc=+1.00

>> clock offsetfromutc=-4.00
<< clock offsetfromutc=-4.00

>> clock 
<< clock datetime=20240401120130 offsetfromutc=-4.00