prg_date_range_to_string_convert()
摘要
将 PrgT 起始与结束日期对象转换为日期范围字符串。
语法
prg_date_range_to_string_convert (start_date_time, end_date_time, string_format, options, date_time_range_string, buffer_len)
| 参数 | 类型 | 说明 |
|---|---|---|
start_date_time |
PrgT_Date |
起始时间。 |
end_date_time |
PrgT_Date |
结束时间。 |
string_format |
PrgT_Date_String_Format |
期望的字符串格式(参见详情)。 |
options |
int |
未使用。 |
date_time_range_string |
char * |
用于保存转换后字符串的缓冲区。 |
buffer_len |
int * |
date_time_range_string 缓冲区的大小。若 date_time_range_string 太小而无法容纳转换后的字符串,该值将被设置为所需大小,并返回 PrgC_Compcode_Failure。 |
返回类型
PrgT_Compcode
若输入无效或缓冲区大小不足,返回 PrgC_Compcode_Failure;否则返回 PrgC_Compcode_Success。
头文件
prg_date.h
详情
该函数将两个 PrgT_Date 对象转换为以日期范围表示的字符串。两个日期共有的信息不会在日期范围字符串中重复。例如:
- Start Date: 11:37:44.000 Dec 23 2011
- End Date: 12:37:44.000 Dec 23 2011
- Date Range String: 11:37:44.000 - 12:37:44.000 Dec 23 2011
返回的字符串以与 date_time 相同的时区表示日期和时间;不做时区转换。
string_format 指定期望的字符串格式。该值必须是 PrgC_Date_String_Format_Standard,产生 C 标准格式的字符串:“12:34:56.789 Mar 19 2008”。