RTC时间和日期函数。更多...

函数
HAL_StatusTypeDef	HAL_RTC_SetTime (RTC_HandleTypeDef hrtc, RTC_TimeTypeDef sTime, uint32_t Format)
	设置RTC当前时间。
HAL_StatusTypeDef	HAL_RTC_GetTime (RTC_HandleTypeDef hrtc, RTC_TimeTypeDef sTime, uint32_t Format)
	获取RTC当前时间。
HAL_StatusTypeDef	HAL_RTC_SetDate (RTC_HandleTypeDef hrtc, RTC_DateTypeDef sDate, uint32_t Format)
	设置RTC当前日期。
HAL_StatusTypeDef	HAL_RTC_GetDate (RTC_HandleTypeDef hrtc, RTC_DateTypeDef sDate, uint32_t Format)
	获取RTC当前日期。
void	HAL_RTC_DST_Add1Hour (RTC_HandleTypeDef *hrtc)
	夏令时，在一次操作中向日历加一个小时，无需经过初始化过程。
void	HAL_RTC_DST_Sub1Hour (RTC_HandleTypeDef *hrtc)
	夏令时，从日历中减去一个小时，无需经过初始化过程。
void	HAL_RTC_DST_SetStoreOperation (RTC_HandleTypeDef *hrtc)
	夏令时，设置存储操作位。
void	HAL_RTC_DST_ClearStoreOperation (RTC_HandleTypeDef *hrtc)
	夏令时，清除存储操作位。
uint32_t	HAL_RTC_DST_ReadStoreOperation (RTC_HandleTypeDef *hrtc)
	夏令时，读取存储操作位。

详细说明

RTC时间和日期函数。

 ===============================================================================
                 ##### RTC Time and Date functions #####
 ===============================================================================

 [..] This section provides functions allowing to configure Time and Date features

函数文档

void HAL_RTC_DST_Add1Hour ( RTC_HandleTypeDef * hrtc )

夏令时，在一次操作中向日历加一个小时，无需经过初始化过程。

参数：

hrtc RTC句柄

返回值：

无

Definition at line 1972 of file stm32g4xx_hal_rtc.c.

References __HAL_RTC_WRITEPROTECTION_DISABLE, __HAL_RTC_WRITEPROTECTION_ENABLE, and __RTC_HandleTypeDef::Instance.

void HAL_RTC_DST_ClearStoreOperation ( RTC_HandleTypeDef * hrtc )

夏令时，清除存储操作位。

参数：

hrtc RTC句柄

返回值：

无

Definition at line 2010 of file stm32g4xx_hal_rtc.c.

References __HAL_RTC_WRITEPROTECTION_DISABLE, __HAL_RTC_WRITEPROTECTION_ENABLE, and __RTC_HandleTypeDef::Instance.

uint32_t HAL_RTC_DST_ReadStoreOperation ( RTC_HandleTypeDef * hrtc )

夏令时，读取存储操作位。

参数：

hrtc RTC句柄

返回值：

operation see RTC_StoreOperation_Definitions

Definition at line 2022 of file stm32g4xx_hal_rtc.c.

References __RTC_HandleTypeDef::Instance.

void HAL_RTC_DST_SetStoreOperation ( RTC_HandleTypeDef * hrtc )

夏令时，设置存储操作位。

注意：: 软件可使用此位来记录夏令时状态。

参数：

hrtc RTC句柄

返回值：

无

Definition at line 1998 of file stm32g4xx_hal_rtc.c.

References __HAL_RTC_WRITEPROTECTION_DISABLE, __HAL_RTC_WRITEPROTECTION_ENABLE, and __RTC_HandleTypeDef::Instance.

void HAL_RTC_DST_Sub1Hour ( RTC_HandleTypeDef * hrtc )

夏令时，从日历中减去一个小时，无需经过初始化过程。

参数：

hrtc RTC句柄

返回值：

无

Definition at line 1985 of file stm32g4xx_hal_rtc.c.

References __HAL_RTC_WRITEPROTECTION_DISABLE, __HAL_RTC_WRITEPROTECTION_ENABLE, and __RTC_HandleTypeDef::Instance.

HAL_StatusTypeDef HAL_RTC_GetDate	(	RTC_HandleTypeDef *	hrtc,
		RTC_DateTypeDef *	sDate,
		uint32_t	Format
	)

获取RTC当前日期。

注意：: 必须在HAL_RTC_GetTime()之后调用HAL_RTC_GetDate()，以解锁高阶日历影子寄存器中的值，确保时间和日期值之间的一致性。读取RTC当前时间会锁定日历影子寄存器中的值，直到读取当前日期。

参数：

hrtc	RTC句柄
sDate	指向日期结构的指针
Format	指定输入参数的格式。此参数可以是以下值之一： RTC_FORMAT_BIN: 二进制数据格式 RTC_FORMAT_BCD: BCD数据格式

返回值：

HAL 状态

Definition at line 1101 of file stm32g4xx_hal_rtc.c.

References assert_param, RTC_DateTypeDef::Date, __RTC_HandleTypeDef::Instance, IS_RTC_FORMAT, RTC_DateTypeDef::Month, RTC_Bcd2ToByte(), RTC_DR_RESERVED_MASK, RTC_FORMAT_BIN, RTC_DateTypeDef::WeekDay, and RTC_DateTypeDef::Year.

HAL_StatusTypeDef HAL_RTC_GetTime	(	RTC_HandleTypeDef *	hrtc,
		RTC_TimeTypeDef *	sTime,
		uint32_t	Format
	)

获取RTC当前时间。

注意：: 可以使用返回的SubSeconds和SecondFraction（sTime结构体字段）通过以下通用公式将SubSeconds值转换为秒分数比：秒分数比 * 时间单位 = [(SecondFraction-SubSeconds)/(SecondFraction+1)] * 时间单位仅当PREDIV_S >= SS且无移位操作挂起（即SHFP=0）时，才能执行此转换; 必须在HAL_RTC_GetDate()之后调用