# RTC_SetDateTime

## Syntax

  `#include <nitro/rtc.h>`

      RTCResult RTC_SetDateTime( const RTCDate* date , const RTCTime* time );

## Arguments

date | Pointer to the buffer storing date data.
time | Pointer to the buffer storing time data.

## Return Values

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

## Description

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

## Note

Do not define parameter values of nonexistent years, months, or days. However, you may specify a day of the week that does not match the actual calendar. This function requires a PXI interrupt for synchronization. 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.

## See Also

`RTC_SetDateTimeAsync, RTC_GetDateTime, RTC_GetDateTimeAsync, RTCResult, RTCDate, RTCTime`

## Revision History

2005/03/08 Standardized the Japanese term for "interrupt."
2004/07/01 Changed the description to standardize the time notation.
2004/05/18 Initial version.

CONFIDENTIAL