1e41f4b71Sopenharmony_ci# TimeService 2e41f4b71Sopenharmony_ci 3e41f4b71Sopenharmony_ci 4e41f4b71Sopenharmony_ci## 概述 5e41f4b71Sopenharmony_ci 6e41f4b71Sopenharmony_ci描述TimeService向应用提供时间时区能力。 7e41f4b71Sopenharmony_ci 8e41f4b71Sopenharmony_ci**起始版本：** 12 9e41f4b71Sopenharmony_ci 10e41f4b71Sopenharmony_ci 11e41f4b71Sopenharmony_ci## 汇总 12e41f4b71Sopenharmony_ci 13e41f4b71Sopenharmony_ci 14e41f4b71Sopenharmony_ci### 文件 15e41f4b71Sopenharmony_ci 16e41f4b71Sopenharmony_ci| 名称 | 描述 | 17e41f4b71Sopenharmony_ci| -------- | -------- | 18e41f4b71Sopenharmony_ci| [time_service.h](time__service_8h.md) | 声明获取时间时区信息的API。 | 19e41f4b71Sopenharmony_ci 20e41f4b71Sopenharmony_ci 21e41f4b71Sopenharmony_ci### 类型定义 22e41f4b71Sopenharmony_ci 23e41f4b71Sopenharmony_ci| 名称 | 描述 | 24e41f4b71Sopenharmony_ci| -------- | -------- | 25e41f4b71Sopenharmony_ci| typedef enum [TimeService_ErrCode](#timeservice_errcode)[TimeService_ErrCode](#timeservice_errcode) | 枚举错误码。 | 26e41f4b71Sopenharmony_ci 27e41f4b71Sopenharmony_ci 28e41f4b71Sopenharmony_ci### 枚举 29e41f4b71Sopenharmony_ci 30e41f4b71Sopenharmony_ci| 名称 | 描述 | 31e41f4b71Sopenharmony_ci| -------- | -------- | 32e41f4b71Sopenharmony_ci| [TimeService_ErrCode](#timeservice_errcode) {<br/>TIMESERVICE_ERR_OK = 0,<br/>TIMESERVICE_ERR_INTERNAL_ERROR = 13000001,<br/>TIMESERVICE_ERR_INVALID_PARAMETER = 13000002<br/>} | 枚举错误码。 | 33e41f4b71Sopenharmony_ci 34e41f4b71Sopenharmony_ci 35e41f4b71Sopenharmony_ci### 函数 36e41f4b71Sopenharmony_ci 37e41f4b71Sopenharmony_ci| 名称 | 描述 | 38e41f4b71Sopenharmony_ci| -------- | -------- | 39e41f4b71Sopenharmony_ci| [TimeService_ErrCode](#timeservice_errcode)[OH_TimeService_GetTimeZone](#oh_timeservice_gettimezone) (char \*timeZone, uint32_t len) | 获取当前系统时区。 | 40e41f4b71Sopenharmony_ci 41e41f4b71Sopenharmony_ci 42e41f4b71Sopenharmony_ci## 类型定义说明 43e41f4b71Sopenharmony_ci 44e41f4b71Sopenharmony_ci 45e41f4b71Sopenharmony_ci### TimeService_ErrCode 46e41f4b71Sopenharmony_ci 47e41f4b71Sopenharmony_ci``` 48e41f4b71Sopenharmony_citypedef enum TimeService_ErrCode TimeService_ErrCode 49e41f4b71Sopenharmony_ci``` 50e41f4b71Sopenharmony_ci 51e41f4b71Sopenharmony_ci**描述** 52e41f4b71Sopenharmony_ci 53e41f4b71Sopenharmony_ci枚举错误码。 54e41f4b71Sopenharmony_ci 55e41f4b71Sopenharmony_ci**起始版本：** 12 56e41f4b71Sopenharmony_ci 57e41f4b71Sopenharmony_ci 58e41f4b71Sopenharmony_ci## 枚举类型说明 59e41f4b71Sopenharmony_ci 60e41f4b71Sopenharmony_ci 61e41f4b71Sopenharmony_ci### TimeService_ErrCode 62e41f4b71Sopenharmony_ci 63e41f4b71Sopenharmony_ci``` 64e41f4b71Sopenharmony_cienum TimeService_ErrCode 65e41f4b71Sopenharmony_ci``` 66e41f4b71Sopenharmony_ci 67e41f4b71Sopenharmony_ci**描述** 68e41f4b71Sopenharmony_ci 69e41f4b71Sopenharmony_ci枚举错误码。 70e41f4b71Sopenharmony_ci 71e41f4b71Sopenharmony_ci**起始版本：** 12 72e41f4b71Sopenharmony_ci 73e41f4b71Sopenharmony_ci| 枚举值 | 描述 | 74e41f4b71Sopenharmony_ci| -------- | -------- | 75e41f4b71Sopenharmony_ci| TIMESERVICE_ERR_OK | 成功。 | 76e41f4b71Sopenharmony_ci| TIMESERVICE_ERR_INTERNAL_ERROR | 获取系统参数失败。 | 77e41f4b71Sopenharmony_ci| TIMESERVICE_ERR_INVALID_PARAMETER | 无效的参数。 | 78e41f4b71Sopenharmony_ci 79e41f4b71Sopenharmony_ci 80e41f4b71Sopenharmony_ci## 函数说明 81e41f4b71Sopenharmony_ci 82e41f4b71Sopenharmony_ci 83e41f4b71Sopenharmony_ci### OH_TimeService_GetTimeZone() 84e41f4b71Sopenharmony_ci 85e41f4b71Sopenharmony_ci``` 86e41f4b71Sopenharmony_ciTimeService_ErrCode OH_TimeService_GetTimeZone (char * timeZone, uint32_t len ) 87e41f4b71Sopenharmony_ci``` 88e41f4b71Sopenharmony_ci 89e41f4b71Sopenharmony_ci**描述** 90e41f4b71Sopenharmony_ci 91e41f4b71Sopenharmony_ci获取当前系统时区。 92e41f4b71Sopenharmony_ci 93e41f4b71Sopenharmony_ci**系统能力：** SystemCapability.MiscServices.Time 94e41f4b71Sopenharmony_ci 95e41f4b71Sopenharmony_ci**起始版本：** 12 96e41f4b71Sopenharmony_ci 97e41f4b71Sopenharmony_ci**参数:** 98e41f4b71Sopenharmony_ci 99e41f4b71Sopenharmony_ci| 名称 | 描述 | 100e41f4b71Sopenharmony_ci| -------- | -------- | 101e41f4b71Sopenharmony_ci| timeZone | 时区ID字符数组，成功时写入当前系统时区ID字符串，失败时写入空字符串，字符串以'\0'结尾。 | 102e41f4b71Sopenharmony_ci| len | 时区ID字符数组分配的内存大小，当前时区字符串没有最大长度规格，建议申请足够多的内存，至少不能低于31字节。 | 103e41f4b71Sopenharmony_ci 104e41f4b71Sopenharmony_ci**返回：** 105e41f4b71Sopenharmony_ci 106e41f4b71Sopenharmony_ci返回TIMESERVICE_ERR_OK表示成功； 107e41f4b71Sopenharmony_ci 108e41f4b71Sopenharmony_ci返回TIMESERVICE_ERR_INTERNAL_ERROR表示获取系统参数失败； 109e41f4b71Sopenharmony_ci 110e41f4b71Sopenharmony_ci返回TIMESERVICE_ERR_INVALID_PARAMETER表示timeZone为NULL指针或时区名称（不包括结束字符（'\0'））的大小大于或等于len。 111