# RTC_SetTimeAsync

## C Specification

      #include <nitro/rtc.h>
      RTCResult RTC_SetTimeAsync(
          const RTCTime*  time,
          RTCCallback     callback,
          void*           arg );

## Description

This function asynchronously writes time data to the real time clock. It sends time data to ARM7 and returns the process result without waiting for a response from the processor. If this function fails, no operation is performed and no user callback function is called.

## Cautions

Do not define parameter values of nonexistent times. Values are set to the RTC as specified by the `time` argument asynchronously. Do not use this variable for anything else until a user callback function confirms the completion of this asynchronous operation.

Because applications cannot change the date, use this API only for debugging during development.

## Arguments

`time` | Target variable for the stored time information.
`callback` | Pointer to specific `RTCCallback` function to be used.
`arg` | The argument to be passed to the callback function.

## Return Values

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

## See Also

`RTC_SetTime, RTC_GetTime, RTC_GetTimeAsync, RTCResult, RTCTime, RTCCallback`

## Revision History

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