# RTC_GetDateAsync

## C Specification

  `#include <nitro/rtc.h>`

      RTCResult RTC_GetDateAsync(
                  RTCDate*    date,
                  RTCCallback callback,
                  void*       arg );

## Description

This function asynchronously reads date data from the real-time clock. It queries ARM7 for date data and returns those values without waiting for a response from the processor. To get the actual date information from the processor, you must use the `result` argument.
If this function fails, no operation is performed and no user callback function is called.

## Cautions

Values are written to the variable specified by the `date` argument asynchronously with respect to the function. Do not use this variable for anything else until a user callback function confirms the completion of this asynchronous operation.

## Arguments

`date` | Pointer to `RTCDate` where date information will be stored.
`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_GetDate, RTC_SetDate, RTC_SetDateAsync, RTCResult, RTCDate, RTCCallback`

## Revision History

05/18/2004 Initial Version