包概述
Date 包提供了一套用于操作 PrgT_Date 对象的 API。这些对象以自 1970 年 1 月 1 日 GMT 午夜以来的秒数表示某个特定的日期和时间。除另有说明外,所有计算均按本地时间进行,不做时区转换。
prg_date_current_get() 返回当前的日期和时间。
可以对 PrgT_Date 对象进行多种转换:
- 使用
prg_date_to_standard_convert()和prg_date_from_standard_convert()与标准(time_t)时间相互转换。 - 使用
prg_date_to_string_convert()和prg_date_from_string_convert()与字符串表示(标准 C 格式)相互转换。 - 使用
prg_date_to_string_convert_tz()和prg_date_from_string_convert_tz()与字符串表示相互转换,并进行时区转换。 - 使用
prg_date_range_to_string_convert()和prg_date_range_to_string_convert_tz()将两个日期转换为日期范围(可选是否进行时区转换)。
可以使用 prg_date_offset_add() 为某个时间加上偏移量(以秒计),或使用 prg_date_interval_offset_add() 按特定时间间隔(例如一小时或一天)偏移时间。要获取两个时间之间的差值,请使用 prg_date_offset_get()。
prg_date_time_window_calculate() 会计算相对于指定时间的、所请求大小的时间窗口。
一些实用函数可以完成能够简化基于时间计算的操作:prg_date_month_number_determine()、prg_date_timezone_get() 和 prg_date_utc_compute()。