TBOX_TIME

T-Box 时间工具 More...

Data Structures
struct	tbox_time_info_t

Functions
uint64_t	tbox_time_get_s (void)
	获取当前时间戳（秒）
uint64_t	tbox_time_get_ms (void)
	获取当前时间戳（毫秒）
uint64_t	tbox_time_get_uptime_ms (void)
	获取系统单调运行时间（毫秒）
int	tbox_time_get_local_utc_offset_s (void)
	获取当前时区相对于 UTC 的偏移量（秒）
int	tbox_time_unix_to_local (time_t unix_time, tbox_time_info_t *local_time)
	将 Unix 时间戳转换为本地时间
int	tbox_time_local_to_unix (const tbox_time_info_t *local_time, time_t *unix_time)
	将本地时间转换为 Unix 时间戳
int	tbox_time_unix_to_utc (time_t unix_time, tbox_time_info_t *utc_time)
	将 Unix 时间戳转换为 UTC 时间
int	tbox_time_utc_to_unix (const tbox_time_info_t *utc_time, time_t *unix_time)
	将 UTC 时间转换为 Unix 时间戳
int	tbox_time_compare (const tbox_time_info_t *left, const tbox_time_info_t *right)
	比较两个时间

Detailed Description

T-Box 时间工具

Function Documentation

tbox_time_compare()

int tbox_time_compare	(	const tbox_time_info_t *	left,
		const tbox_time_info_t *	right )

比较两个时间

Parameters

left	左时间
right	右时间

Returns

0 相等或参数无效，-1 左时间小于右时间，1 左时间大于右时间

tbox_time_get_local_utc_offset_s()

int tbox_time_get_local_utc_offset_s

(

void

)

获取当前时区相对于 UTC 的偏移量（秒）

Returns

当前时区相对于 UTC 的偏移量（秒）

tbox_time_get_ms()

uint64_t tbox_time_get_ms

(

void

)

获取当前时间戳（毫秒）

Returns

当前时间戳（毫秒）

tbox_time_get_s()

uint64_t tbox_time_get_s

(

void

)

获取当前时间戳（秒）

Returns

当前时间戳（秒）

tbox_time_get_uptime_ms()

uint64_t tbox_time_get_uptime_ms

(

void

)

获取系统单调运行时间（毫秒）

Returns

系统单调运行时间（毫秒）

tbox_time_local_to_unix()

int tbox_time_local_to_unix	(	const tbox_time_info_t *	local_time,
		time_t *	unix_time )

将本地时间转换为 Unix 时间戳

Parameters

local_time	本地时间
unix_time	Unix 时间戳

Returns

0 成功，其他值失败

tbox_time_unix_to_local()

int tbox_time_unix_to_local	(	time_t	unix_time,
		tbox_time_info_t *	local_time )

将 Unix 时间戳转换为本地时间

Parameters

unix_time	Unix 时间戳
local_time	本地时间

Returns

0 成功，其他值失败

tbox_time_unix_to_utc()

int tbox_time_unix_to_utc	(	time_t	unix_time,
		tbox_time_info_t *	utc_time )

将 Unix 时间戳转换为 UTC 时间

Parameters

unix_time	Unix 时间戳
utc_time	UTC 时间

Returns

0 成功，其他值失败

tbox_time_utc_to_unix()

int tbox_time_utc_to_unix	(	const tbox_time_info_t *	utc_time,
		time_t *	unix_time )

将 UTC 时间转换为 Unix 时间戳

Parameters

utc_time	UTC 时间
unix_time	Unix 时间戳

Returns

0 成功，其他值失败