_get_tzname
检索该时区的名称或夏时制标准时区名称 (DST) 的字符字符串表示形式。
errno_t _get_tzname(
size_t* pReturnValue,
char* timeZoneName,
size_t sizeInBytes,
int index
);
参数
[out] pReturnValue
timeZoneName 的字符串长度包含 null 结束符。[out] timeZoneName
字符字符串的地址时区名称或夏时制标准时区名称 (DST) 的表现形式,具体取决于 index。[in] sizeInBytes
timeZoneName 字符字符串的大小 (以字节为单位)。[in] index
索引检索的两个时区名称之一。
返回值
零,如果成功,否则 errno 类型值。
如果或 timeZoneName 是 NULL,或者 sizeInBytes 大于零 (0),而不是两个) 是零或小于零,无效参数调用处理程序,如 参数验证所述。 如果执行允许继续,此功能设置 errno 到 EINVAL 并返回 EINVAL。
错误状态
pReturnValue |
timeZoneName |
sizeInBytes |
index |
返回值 |
timeZoneName内容 |
---|---|---|---|---|---|
TZ 名称的大小 |
NULL |
0 |
0 或 1 |
0 |
不修改 |
TZ 名称的大小 |
任何 |
> 0 |
0 或 1 |
0 |
TZ 命名 |
不修改 |
NULL |
> 0 |
任何 |
EINVAL |
不修改 |
不修改 |
任何 |
零 |
任何 |
EINVAL |
不修改 |
不修改 |
任何 |
> 0 |
> 1 |
EINVAL |
不修改 |
备注
_get_tzname 函数检索该时区的名称或夏时制标准时区名称 (DST) 的字符字符串表示形式添加到 timeZoneName 地址基于索引值,与字符串一起的大小 pReturnValue的。 如果 timeZoneName 是 NULL ,并 sizeInBytes 为零,任何一个时区字符串的大小 (以字节为单位) 在 pReturnValue返回。 索引值必须是 0 标准时区的或 1 夏时制标准时区的;索引的所有其他值具有不确定的结果。
索引值
index |
timeZoneName内容 |
timeZoneName 默认 |
---|---|---|
0 |
时区名称 |
“PST” |
1 |
夏时制标准时区名称 |
“PDT” |
AMP_GT 1 或 0 AMP_LT |
errno 设置为 EINVAL |
不修改 |
在运行时,除非值显式更改,默认分别为 “PST”和 “PDT”。 这些字符数组的大小受 TZNAME_MAX 值管理。
要求
实例 |
必需的头 |
---|---|
_get_tzname |
time.h |
有关更多信息,请参见 兼容性。
.NET Framework 等效项
不适用。若要调用标准 C 函数,请使用 PInvoke。有关更多信息,请参见 平台调用示例。