h6. [[RTC]] h6(. » [[RTC SWI Calls|SWI Calls]] h6((. » RTC_Read h2. RTC_Read h5. (SWI &594C1) |_<^{width:4em}. Entry | | |<^. R0 |<^. Pointer to [[rtctime]] structure | |_<^{width:4em}. Exit | | |<^. - |<^. On success, rtctime struct updated | |<^. R0 |<^. Error pointer (on failure), preserved (on success) | |<^. - |<^. All other registers preserved | h4. Use The purpose of this call is to read the current time from the hardware RTC h4. Notes An error will be returned if the read failed, or if the RTC is known to be in an invalid state (e.g. clock stopped) To provide a full 4-digit year, the value read from the RTC may be augmented by the year stored in CMOS. Rather than reading time from the RTC directly, most software should read the softcopy of the time that's maintained by RISC OS, e.g. via [[OS_Word 14]] h4. See also * [[RTC_Write]] * [[OS_Word 14]]