# RTC_SetTime

## Syntax

  `#include <nitro/rtc.h>`

      RTCResult RTC_SetTime( const RTCTime* time );

## Arguments

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 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 the `RTC_SetTimeAsync` function.

## Note

Do not define parameter values of nonexistent times.
This function requires a PXI interrupt for synchronization. Do not call this function when PXI interrupts are prohibited.
Because applications cannot change the date, use this API only for debugging during development.
In FINALROM builds, this function always fails and `RTC_RESULT_INVALID_COMMAND` is returned.

## See Also

`RTC_SetTimeAsync
RTC_GetTime
RTC_GetTimeAsync
RTCResult
RTCTime`

## Revision History

2009/07/29 Explained that the time setting command always fails in FINALROM builds.
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