.. zephyr:code-sample:: rtc
:name: Real-Time Clock (RTC)
:relevant-api: rtc_interface
Set and read the date/time from a Real-Time Clock.
Overview
********
This sample shows how to use the :ref:`rtc driver API <rtc_api>`
to set and read the date/time from RTC and display on the console
and can be built and executed on boards supporting RTC.
Building and Running
********************
Build and flash as follows, replacing ``stm32f3_disco`` with your board:
.. zephyr-app-commands::
:zephyr-app: samples/drivers/rtc
:board: stm32f3_disco
:goals: build flash
:compact:
Sample Output
=============
.. code-block:: console
RTC date and time: 2024-11-17 04:19:00
RTC date and time: 2024-11-17 04:19:01
<repeats endlessly>
