# RTC_GetDateTimeAsync

## C Specification

  `#include <nitro/rtc.h>`

      RTCResult RTC_GetDateTimeAsync(
                  RTCDate*    date,
                  RTCTime*    time,
                  RTCCallback callback,
                  void*       arg );

## Description

This function asynchronously reads date and time data from the real time clock. It queries ARM7 for date and time data and returns those values without waiting for a response from the processor. To get the actual date and time 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 variables specified by the `date` and `time` arguments asynchronously with respect to the function. Do not use these variables 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.
`time` | Pointer to `RTCTime` where time 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_GetDateTime, RTC_SetDateTime, RTC_SetDateTimeAsync, RTCResult, RTCDate, RTCTime, RTCCallback`

## Revision History

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