_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。有关更多信息,请参见 平台调用示例

请参见

参考

时间线

errno、_doserrno、_sys_errlist和_sys_nerr

_get_daylight

_get_dstbias

_get_timezone

TZNAME_MAX