blob: f7626b9a6f9e548493d85e1875dc0816c186e062 [file] [log] [blame]
newtmgr datetime
-----------------
Manage datetime on a device.
Usage:
^^^^^^
.. code-block:: console
newtmgr datetime [rfc-3339-date-string] -c <conn_profile> [flags]
Global Flags:
^^^^^^^^^^^^^
.. code-block:: console
-c, --conn string connection profile to use
-h, --help help for newtmgr
-l, --loglevel string log level to use (default "info")
--name string name of target BLE device; overrides profile setting
-t, --timeout float timeout in seconds (partial seconds allowed) (default 10)
-r, --tries int total number of tries in case of timeout (default 1)
Description
^^^^^^^^^^^
Reads or sets the datetime on a device. Specify a ``datetime-value`` in the command to set the datetime on the device.
Newtmgr uses the ``conn_profile`` connection profile to connect to the device.
**Note**: You must specify the ``datetime-value`` in the RFC 3339 format.
Examples
^^^^^^^^
+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Usage | Explanation |
+============================================================+=====================================================================================================================================================================+
| ``newtmgr datetime-c profile01`` | Reads the datetime value from a device. Newtmgr connects to the device over a connection specified in the ``profile01`` connection profile. |
+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ``newtmgr datetime 2017-03-01T22:44:00-c profile01`` | Sets the datetime on a device to March 1st 2017 22:44:00 UTC. Newtmgr connects to the device over a connection specified in the ``profile01`` connection profile. |
+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ``newtmgr datetime 2017-03-01T22:44:00-08:00-c profile01`` | Sets the datetime on a device to March 1st 2017 22:44:00 PST. Newtmgr connects to the device over a connection specified in the ``profile01`` connection profile. |
+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+