STM32G474xx HAL 用户手册
函数
时间
RTC 导出函数

函数

__STATIC_INLINE void LL_RTC_TIME_SetFormat (RTC_TypeDef *RTCx, uint32_t TimeFormat)
 设置时间格式（AM/24小时制或PM表示法）
__STATIC_INLINE uint32_t LL_RTC_TIME_GetFormat (RTC_TypeDef *RTCx)
 获取时间格式（AM或PM表示法）
__STATIC_INLINE void LL_RTC_TIME_SetHour (RTC_TypeDef *RTCx, uint32_t Hours)
 设置BCD格式的小时数。
__STATIC_INLINE uint32_t LL_RTC_TIME_GetHour (RTC_TypeDef *RTCx)
 获取BCD格式的小时数。
__STATIC_INLINE void LL_RTC_TIME_SetMinute (RTC_TypeDef *RTCx, uint32_t Minutes)
 设置BCD格式的分钟数。
__STATIC_INLINE uint32_t LL_RTC_TIME_GetMinute (RTC_TypeDef *RTCx)
 获取BCD格式的分钟数。
__STATIC_INLINE void LL_RTC_TIME_SetSecond (RTC_TypeDef *RTCx, uint32_t Seconds)
 设置BCD格式的秒数。
__STATIC_INLINE uint32_t LL_RTC_TIME_GetSecond (RTC_TypeDef *RTCx)
 获取BCD格式的秒数。
__STATIC_INLINE void LL_RTC_TIME_Config (RTC_TypeDef *RTCx, uint32_t Format12_24, uint32_t Hours, uint32_t Minutes, uint32_t Seconds)
 设置BCD格式的时间（小时、分钟和秒）。
__STATIC_INLINE uint32_t LL_RTC_TIME_Get (RTC_TypeDef *RTCx)
 获取BCD格式的时间（小时、分钟和秒）。
__STATIC_INLINE void LL_RTC_TIME_EnableDayLightStore (RTC_TypeDef *RTCx)
 记忆是否已执行夏令时更改。
__STATIC_INLINE void LL_RTC_TIME_DisableDayLightStore (RTC_TypeDef *RTCx)
 禁用记忆是否已执行夏令时更改。
__STATIC_INLINE uint32_t LL_RTC_TIME_IsDayLightStoreEnabled (RTC_TypeDef *RTCx)
 检查RTC夏令时存储操作是否已启用。
__STATIC_INLINE void LL_RTC_TIME_DecHour (RTC_TypeDef *RTCx)
 减去1小时（冬令时更改）
__STATIC_INLINE void LL_RTC_TIME_IncHour (RTC_TypeDef *RTCx)
 增加1小时（夏令时更改）
__STATIC_INLINE uint32_t LL_RTC_TIME_GetSubSecond (RTC_TypeDef *RTCx)
 获取同步预分频器计数器中的亚秒值。
__STATIC_INLINE void LL_RTC_TIME_Synchronize (RTC_TypeDef *RTCx, uint32_t ShiftSecond, uint32_t Fraction)
 以高精度与远程时钟同步。

函数文档

__STATIC_INLINE void LL_RTC_TIME_Config ( RTC_TypeDef *  RTCx,
uint32_t  Format12_24,
uint32_t  Hours,
uint32_t  Minutes,
uint32_t  Seconds 
)

设置BCD格式的时间（小时、分钟和秒）。

注意:
该位受写保护。需要先调用 LL_RTC_DisableWriteProtection 函数。
仅在初始化模式下可写入（LL_RTC_EnableInitMode 函数）
TimeFormat 和 Hours 应遵循相同格式
参考手册到LL API交叉参考:
RTC_TR PM LL_RTC_TIME_Config
RTC_TR HT LL_RTC_TIME_Config
RTC_TR HU LL_RTC_TIME_Config
RTC_TR MNT LL_RTC_TIME_Config
RTC_TR MNU LL_RTC_TIME_Config
RTC_TR ST LL_RTC_TIME_Config
RTC_TR SU LL_RTC_TIME_Config
参数:
RTCxRTC 实例
Format12_24该参数可以是以下值之一：
Hours值范围：Min_Data=0x01 到 Max_Data=0x12，或 Min_Data=0x00 到 Max_Data=0x23
Minutes值范围：Min_Data=0x00 到 Max_Data=0x59
Seconds值范围：Min_Data=0x00 到 Max_Data=0x59
返回值:
无

定义于文件 1346 行，位于 stm32g4xx_ll_rtc.h。

被 LL_RTC_TIME_Init() 引用。

__STATIC_INLINE void LL_RTC_TIME_DecHour ( RTC_TypeDef *  RTCx)

减去1小时（冬令时更改）

注意:
该位受写保护。需要先调用 LL_RTC_DisableWriteProtection 函数。
参考手册到LL API交叉参考:
RTC_CR SUB1H LL_RTC_TIME_DecHour
参数:
RTCxRTC 实例
返回值:
无

定义于文件 1427 行，位于 stm32g4xx_ll_rtc.h。

__STATIC_INLINE void LL_RTC_TIME_DisableDayLightStore ( RTC_TypeDef *  RTCx)

禁用记忆是否已执行夏令时更改。

注意:
该位受写保护。需要先调用 LL_RTC_DisableWriteProtection 函数。
参考手册到LL API交叉参考:
RTC_CR BKP LL_RTC_TIME_DisableDayLightStore
参数:
RTCxRTC 实例
返回值:
无

定义于文件 1404 行，位于 stm32g4xx_ll_rtc.h。

__STATIC_INLINE void LL_RTC_TIME_EnableDayLightStore ( RTC_TypeDef *  RTCx)

记忆是否已执行夏令时更改。

注意:
该位受写保护。需要先调用 LL_RTC_DisableWriteProtection 函数。
参考手册到LL API交叉参考:
RTC_CR BKP LL_RTC_TIME_EnableDayLightStore
参数:
RTCxRTC 实例
返回值:
无

定义于文件 1392 行，位于 stm32g4xx_ll_rtc.h。

__STATIC_INLINE uint32_t LL_RTC_TIME_Get ( RTC_TypeDef *  RTCx)

获取BCD格式的时间（小时、分钟和秒）。

注意:
如果RTC影子寄存器未旁路（BYPSHAD=0），在读取此位前需要检查RSF标志是否置位
读取RTC_SSR或RTC_TR会锁定高阶日历影子寄存器中的值，直到读取RTC_DR（LL_RTC_ReadReg(RTC, DR)）为止。
辅助宏 __LL_RTC_GET_HOUR、__LL_RTC_GET_MINUTE 和 __LL_RTC_GET_SECOND 可用于独立获取每个参数。
参考手册到LL API交叉参考:
RTC_TR HT LL_RTC_TIME_Get
RTC_TR HU LL_RTC_TIME_Get
RTC_TR MNT LL_RTC_TIME_Get
RTC_TR MNU LL_RTC_TIME_Get
RTC_TR ST LL_RTC_TIME_Get
RTC_TR SU LL_RTC_TIME_Get
参数:
RTCxRTC 实例
返回值:
小时、分钟和秒的组合（格式：0x00HHMMSS）。

定义于文件 1375 行，位于 stm32g4xx_ll_rtc.h。

引用 RTC_OFFSET_HOUR 和 RTC_OFFSET_MINUTE。

__STATIC_INLINE uint32_t LL_RTC_TIME_GetFormat ( RTC_TypeDef *  RTCx)

获取时间格式（AM或PM表示法）

注意:
如果RTC影子寄存器未旁路（BYPSHAD=0），在读取此位前需要检查RSF标志是否置位
读取RTC_SSR或RTC_TR会锁定高阶日历影子寄存器中的值，直到读取RTC_DR（LL_RTC_ReadReg(RTC, DR)）为止。
参考手册到LL API交叉参考:
RTC_TR PM LL_RTC_TIME_GetFormat
参数:
RTCxRTC 实例
返回值:</