harmony 鸿蒙TimeService

TimeService

描述TimeService向应用提供时间时区能力。

起始版本： 12

名称	描述
time_service.h	声明获取时间时区信息的API。

名称	描述
typedef enum TimeService_ErrCode TimeService_ErrCode	枚举错误码。

名称	描述
TimeService_ErrCode { TIMESERVICE_ERR_OK = 0, TIMESERVICE_ERR_INTERNAL_ERROR = 13000001, TIMESERVICE_ERR_INVALID_PARAMETER = 13000002 }	枚举错误码。

名称	描述
TimeService_ErrCode OH_TimeService_GetTimeZone (char *timeZone, uint32_t len)	获取当前系统时区信息。

typedef enum TimeService_ErrCode TimeService_ErrCode

描述

枚举错误码。

起始版本： 12

enum TimeService_ErrCode

描述

枚举错误码。

起始版本： 12

枚举值	描述
TIMESERVICE_ERR_OK	成功。
TIMESERVICE_ERR_INTERNAL_ERROR	获取系统参数失败。
TIMESERVICE_ERR_INVALID_PARAMETER	无效的参数。

TimeService_ErrCode OH_TimeService_GetTimeZone (char * timeZone, uint32_t len)

描述

获取系统当前时区。

系统能力： SystemCapability.MiscServices.Time

起始版本： 12

参数：

名称	描述
timeZone	时区ID字符数组，成功时写入当前系统时区ID字符串，失败时写入空字符串。字符串以’\0’结尾。
len	时区ID字符数组分配的内存大小，当前时区字符串没有最大长度规格，必须申请至少31字节的内存。