★ FEATURED ARTICLE 文档知识库教程OpenHarmony【免费下载链接】CangjieCorpus本仓库为仓颉编程语言语料库聚焦 仓颉编程语言 核心知识体系整合官方开发指南、API 文档、典型代码示例及语法规范等多维度资源经结构化处理与专业标注构建为支持 RAG检索增强生成技术 的高质量知识基座适配智能编码助手、学习辅助工具等应用开发需求。 欢迎开发者基于本语料库构建仓颉语言智能应用推动鸿蒙开发生态智能化升级项目地址https://gitcode.com/Cangjie/CangjieCorpus点击查看免费下载导读在 OpenHarmony鸿蒙应用开发中BasicServicesKit的ohos.system_date_time模块为仓颉Cangjie开发者提供系统时间、系统时区的获取能力。当时间时区服务出现参数校验失败、权限校验失败或系统运行异常时系统会抛出错误码-1。本文以时间时区服务错误码文档为核心完整梳理该错误码的定义、三种典型成因与处理步骤并结合仓颉 API 源码、权限声明配置与通用错误码体系给出可直接落地的排查方案与可运行示例帮助开发者在遇到-1错误时快速定位根因并修复。错误码 -1 总览一个通用兜底的错误码错误码-1是时间时区服务的通用错误码。与模块内逐条定义的业务错误码不同-1并不指向某一个具体异常而是对时间时区服务各类失败场景的兜底汇总。维度内容错误码 ID-1错误信息The parameter check failed or permission denied or system error.错误描述参数校验失败、权限校验失败或者时间时区服务异常所属模块BasicServicesKit 时间时区服务对应ohos.system_date_time模块错误信息本身即是排查的第一线索原文明确说明该错误码代表一种通用错误码可根据错误信息判断具体异常。也就是说当错误信息中出现参数校验parameter check相关描述时问题大概率出在调用方传参出现权限permission denied相关描述时问题大概率出在权限配置出现系统错误system error相关描述时则需要从运行环境侧入手。先认识主体触发该错误码的时间时区 API-1错误码由时间时区服务抛出对应的仓颉 API 集中在 ohos.system_date_time系统时间、时区 模块中。该模块在BasicServicesKit 能力范围中归属时间时区能力提供获取系统时间以及系统时区的功能。模块导入与核心类import kit.BasicServicesKit.*模块核心为SystemDateTime类系统能力为SystemCapability.MiscServices.Time起始版本 22public class SystemDateTime {}三个常用接口获取系统时间支持纳秒/毫秒public static func getTime(isNanoseconds!: Bool false): Int64功能获取自 Unix 纪元以来到当前系统时间所经过的时间。参数isNanoseconds为命名参数true返回纳秒数nsfalse返回毫秒数ms默认false。获取系统时区public static func getTimezone(): String功能获取系统时区返回值参考系统支持的时区列表。获取系统启动以来经过的时间public static func getUptime(timeType: TimeType, isNanoseconds!: Bool false): Int64参数timeType仅能为TimeType.Startup自系统启动以来经过的毫秒数包括深度睡眠时间或TimeType.Active自系统启动以来经过的毫秒数不包括深度睡眠时间。标准调用范式含异常捕获上述 API 在异常时均抛出BusinessException这也正是-1错误码出现的现场。文档给出的标准示例可放入仓颉模板工程index.cj编译运行// index.cj import kit.BasicServicesKit.* import ohos.business_exception.BusinessException import kit.PerformanceAnalysisKit.Hilog try { let time SystemDateTime.getTime() Hilog.info(0, cangjie_ohos_test, Succeeded in getting time : ${time}) } catch (e: BusinessException) { Hilog.info(0, test, ${e.message}) }同理获取时区与启动时长的调用均需包在try/catch中try { let time SystemDateTime.getTimezone() Hilog.info(0, cangjie_ohos_test, Succeeded to getTimezone, getTimezone is ${time} ) } catch (e: BusinessException) { Hilog.info(0, test, ${e.message}) }try { let time SystemDateTime.getUptime(TimeType.Active) Hilog.info(0, cangjie_ohos_test, Succeeded to getUptime : ${time}) } catch (e: BusinessException) { Hilog.info(0, test, ${e.message}) }需要说明的是文档中的示例均为获取系统时间/时区获取操作本身对权限要求较低而-1错误码中提到的权限问题通常发生在修改系统时间或时区如自动对时、时区切换的场景。示例工程与配置模板的说明见仓颉示例代码说明该文件位于 reference 目录下。成因一参数校验失败典型表现错误信息中包含参数校验相关描述。可能原因传入参数无效。例如调用getUptime时传入了TimeType之外的非法枚举值或方法签名中的必填参数未正确传入。处理步骤检查参数是否按照 API 文档要求传入重点核对必填参数是否缺失参数类型是否正确如getUptime的timeType必须是TimeType.Startup或TimeType.Active命名参数isNanoseconds的取值是否符合预期。与通用错误码 401 的关系参数类失败在 OpenHarmony 错误码体系中通常对应通用错误码 401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.其可能原因包括必选参数没有传入、参数类型错误、参数数量错误、空参数错误、参数格式错误、参数值范围错误等。当-1的错误信息指向参数问题时可对照 401 的成因清单逐项排查。成因二权限校验失败最常见典型表现错误信息中包含权限相关描述permission denied。可能原因权限未配置。应用设置时间时未配置ohos.permission.SET_TIME或者设置时区时未配置ohos.permission.SET_TIME_ZONE。处理步骤在应用配置文件中补齐对应权限。权限属性详解根据应用权限列表两个权限的完整属性如下权限名允许操作权限级别授权方式ACL 使能起始版本ohos.permission.SET_TIME允许应用修改系统时间system_basic系统授权system_granttrue12ohos.permission.SET_TIME_ZONE允许应用修改系统时区system_basic系统授权system_granttrue12两个权限均为system_basic级别的系统授权权限普通第三方应用默认不具备需要满足权限授予条件通常涉及系统应用或通过 ACL 申请并在module.json5中显式声明。module.json5 权限声明写法应用需要在src/main/module.json5配置文件的requestPermissions标签中声明权限完整标签说明见 module.json5 配置文件{ module: { // ... requestPermissions: [ { name: ohos.permission.SET_TIME, reason: $string:reason_set_time, usedScene: { abilities: [ EntryAbility ], when: inuse } }, { name: ohos.permission.SET_TIME_ZONE, reason: $string:reason_set_time_zone, usedScene: { abilities: [ EntryAbility ], when: inuse } } ] } }其中reason需使用$string:资源引用在src/main/resources/base/element/string.json中定义文案usedScene的when取值只能为inuse使用时或always始终。声明权限的完整约束详见声明权限。注意SET_TIME与SET_TIME_ZONE均为system_grant系统授权权限声明后由系统直接授予无需向用户弹窗申请但必须先在配置文件中声明否则应用无法获取授权调用对应 API 时就会触发-1错误码中的权限失败分支。与通用错误码 201/202 的关系权限校验失败在通用错误码体系中对应通用错误码 201权限校验失败应用无权限使用该 API与 202非系统应用使用了系统 API。当-1的错误信息指向权限问题时可结合 201/202 的排查思路确认应用是否具备调用该 API 的权限、是否为系统应用、是否误用了系统 API。成因三系统运行异常典型表现错误信息中包含系统错误system error相关描述。可能原因系统运行异常如内存申请、多线程处理等内核通用错误导致时间时区服务无法正常工作。处理步骤确认内存是否足够必要时释放应用侧内存占用、重启应用或设备后重试。这类问题通常属于偶发性的运行时故障与调用方代码本身无关重试往往即可恢复。提示在 BasicServicesKit 的事件错误码文档中也有类似描述——系统故障获取系统当前时间发生异常时建议稍后重新尝试。可见系统时间获取异常 稍后重试是 OpenHarmony 服务侧对运行时故障的统一处理策略可作为本成因的参考佐证。一图梳理-1 错误码排查决策流程遇到-1错误码时可按下述流程快速定位收到错误码 -1The parameter check failed or permission denied or system error. │ ▼ 根据错误信息中的关键字判断异常类型 │ ├─ 参数校验失败parameter check→ 检查参数是否按 API 规格传入 │ └─ 对照 getTime / getTimezone / getUptime 的参数说明修正调用 │ ├─ 权限校验失败permission denied→ 检查是否声明对应权限 │ ├─ 设置时间配置 ohos.permission.SET_TIME │ ├─ 设置时区配置 ohos.permission.SET_TIME_ZONE │ └─ 在 module.json5 的 requestPermissions 中声明后重新编译安装 │ └─ 系统运行异常system error→ 确认内存是否足够 └─ 释放内存、重启应用/设备后重试实战一个完整的诊断示例假设应用在修改系统时区时抛出-1且错误信息为Permission denied。按排查流程执行第 1 步确认调用点是否使用了需要权限的 API。仅读取时间/时区getTime、getTimezone、getUptime一般无需特殊权限一旦涉及修改系统时间或时区则必须声明SET_TIME/SET_TIME_ZONE。第 2 步检查src/main/module.json5中requestPermissions是否包含对应权限。若缺失按上文示例补充并重新编译安装。第 3 步检查应用是否满足system_basic权限级别要求。两个权限均为系统授权权限普通三方应用需确认自身是否具备申请资格ACL 使能字段为true意味着可通过 ACL 方式申请。第 4 步若错误信息为system error而非权限问题则检查设备内存、系统服务运行状态。可以重启应用后重试若持续出现则进一步检查设备侧系统服务是否异常。同类错误码横向参考时间时区服务错误码-1位于BasicServicesKit 错误码目录之下与该 Kit 内其他模块错误码的通用兜底 具体业务错误码设计保持一致设置数据项错误码14800000参数检查失败、14800010上下文参数不是 UIAbility 类型事件错误码1500001~1500009覆盖 want 参数、沙箱限制、事件频率、订阅者、userId、IPC 等具体失败场景系统电源管理错误码4900101连接服务失败建议使用hdc shell hidumper -ls检查系统服务列表。从这些文档的排版可以看到各模块错误码文档均遵循同一套结构——错误信息、错误描述、可能原因、处理步骤——并在开头注明以下仅介绍本模块特有错误码通用错误码请参考通用错误码说明文档。因此在排查-1时建议同时对照通用错误码 201/202权限、401参数和 801设备能力不支持形成完整的排查闭环。小结错误码-1是 OpenHarmony 时间时区服务的通用兜底错误码它的排查要点可以浓缩为一句话读错误信息、分三类处理——参数问题查 API 规格权限问题查module.json5中的SET_TIME/SET_TIME_ZONE声明系统问题查内存与系统服务状态。结合仓颉 API 文档中的参数说明与标准调用范式开发者可以在仓颉应用中快速定位并解决绝大多数与时间、时区相关的能力调用问题。赞分享文档知识库教程OpenHarmony【免费下载链接】CangjieCorpus本仓库为仓颉编程语言语料库聚焦 仓颉编程语言 核心知识体系整合官方开发指南、API 文档、典型代码示例及语法规范等多维度资源经结构化处理与专业标注构建为支持 RAG检索增强生成技术 的高质量知识基座适配智能编码助手、学习辅助工具等应用开发需求。 欢迎开发者基于本语料库构建仓颉语言智能应用推动鸿蒙开发生态智能化升级项目地址https://gitcode.com/Cangjie/CangjieCorpus点击查看免费下载相关推荐仓颉 std.time 包实战详解DateTimeFormat 时间格式与 TimeZone 时区 API仓颉 std.time 包实战详解DateTimeFormat 时间格式与 TimeZone 时区 API 本文围绕仓颉Cangjie标准库 std.ti编程语言语言运行时标准库垃圾回收并发编程OpenHarmony 仓颉开发Basic Services Kit 账号管理错误码全解与排查指南OpenHarmony 仓颉开发Basic Services Kit 账号管理错误码全解与排查指南 本文围绕仓颉CangjieOpenHarmony 开发文档知识库教程OpenHarmony仓颉 OpenHarmony 设置数据项模块错误码详解14800000 与 14800010 的排查与处理仓颉 OpenHarmony 设置数据项模块错误码详解14800000 与 14800010 的排查与处理 本篇基于仓颉语料库CangjieCorpus中文档知识库教程OpenHarmony上一篇Wand-Enhancer终极指南免费解锁WeMod专业版功能告别2小时限制下一篇Wand-Enhancer终极指南免费解锁Wand专业版功能告别2小时限制创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
