# RTC_SetTime

## C Specification

      #include <nitro/rtc.h>
      RTCResult RTC_SetTime( const RTCTime* time );

## Description

This function writes time data to the real time clock. It sends time data to ARM7 and returns the process result once it is received. This is a synchronous version of `RTC_SetTimeAsync`.

## Cautions

Do not define define parameter values of nonexistent times. This function requires a PXI interrupt for synchronization. It cannot be used in situations where PXI interrupts are prohibited. Because applications cannot change the date, use this API only for debugging during development. Because applications cannot change the date, use this API only for debugging during development.

## Arguments

`time` | Pointer to `RTCTime`. Specifies time information.

## Return Values

If the request succeeds, it returns `0`.
If the request fails, it returns some numeric value other than `0`.

## See Also

`RTC_SetTimeAsync, RTC_GetTime, RTC_GetTimeAsync, RTCResult, RTCTime`

## Revision History

07/01/2004 Changed the description due to standardize the time notation.
05/18/2004 Initial Version