Função clock_systohc
Cabeçalho: #include <applibs/rtc.h>
Sincroniza o relógio em tempo real (RTC) com a hora atual do sistema. O RTC só armazena a hora em UTC/GMT. Por conseguinte, a conversão a partir da hora local só é necessária se o fuso horário local não for GMT.
int clock_systohc(void);
Erros
Devolve -1 se for encontrado um erro e define errno para o valor de erro.
EACCES: o autor da chamada não tem a capacidade SystemTime.
EBUSY: O dispositivo RTC estava a ser utilizado e não foi possível abri-lo. O autor da chamada deve tentar novamente periodicamente até ser bem-sucedido.
Também pode ser especificado qualquer outro errno ; esses erros não são deterministas e o mesmo comportamento pode não ser retido através de atualizações do sistema.
Valor devolvido
Devolve 0 para êxito ou -1 para falha, caso errno em que está definido como o valor de erro.
Requisitos do manifesto de aplicação
Esta função requer a capacidade SystemTime no manifesto da aplicação.