prg_date_to_string_convert_tz()
摘要
将 PrgT_Date 对象转换为指定时区的字符串表示形式。
语法
prg_date_to_string_convert_tz (date_time, time_zone, string_format, options, date_time_string, buffer_len)
| 参数 | 类型 | 说明 |
|---|---|---|
date_time |
PrgT_Date |
要转换的日期对象。 |
time_zone |
PrgT_Timezone_Name |
要转换到的时区 |
string_format |
PrgT_Date_String_Format |
所需的字符串格式(参见详情)。 |
options |
int |
转换选项(参见详情)。 |
date_time_string |
char * |
用于存放转换后字符串的缓冲区。 |
buffer_len |
int * |
date_time_string 缓冲区的长度。若 date_time_string 太小而无法容纳转换后的字符串,该值将被设置为所需的大小,并返回 PrgC_Compcode_Failure。 |
返回类型
PrgT_Compcode
若输入无效或缓冲区大小不足则返回 PrgC_Compcode_Failure;否则返回 PrgC_Compcode_Success。
头文件
prg_date.h
详情
此函数将 PrgT_Date 对象转换为字符串表示形式。
除非 options 另有指定,否则 date_time 被视为计算机的本地时间。返回的字符串表示转换到指定时区后的日期和时间。
string_format 指定所需的字符串格式。必须为 PrgC_Date_String_Format_Standard,产生 C 标准格式的字符串:“12:34:56.789 Mar 19 2008”。
options 必须为 0 或以下符号常量之一:
PRGC_DATE_OPT_USE_TIMEZONE_PREF——转换到时区首选项指定的时区PRGC_DATE_OPT_INCLUDE_TIMEZONE_STR——在返回的字符串中包含时区PRGC_DATE_OPT_INCLUDE_TIMEZONE_STR_USE_PREF——转换到时区首选项指定的时区,并在返回的字符串中包含时区