js-apis-enterpriseDeviceManager-DeviceSettingsManager.md 2.5 KB
Newer Older
F
fangyun 已提交
1
# 设备设置管理
F
fangyun 已提交
2

F
fangyun 已提交
3
本模块提供设备设置管理能力,包括设置时间等。仅企业设备管理员应用才能调用。
F
fangyun 已提交
4

F
fangyun 已提交
5 6 7
> **说明**:
> 
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
F
fangyun 已提交
8

F
fangyun 已提交
9 10
## DeviceSettingsManager.setDateTime

F
fangyun 已提交
11
setDateTime(admin: Want, time: number, callback: AsyncCallback<void>): void
F
fangyun 已提交
12

F
fangyun 已提交
13
设置系统时间。使用callback异步回调。
F
fangyun 已提交
14

F
fangyun 已提交
15
**需要权限:** ohos.permission.EDM_MANAGE_DATETIME
F
fangyun 已提交
16 17 18 19 20 21 22

**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager

**参数:**

| 参数名   | 类型                                  | 必填   | 说明      |
| ----- | ----------------------------------- | ---- | ------- |
F
fangyun 已提交
23 24
| admin | [Want](js-apis-application-Want.md) | 是    | 设备管理员应用。 |
| time  | number | 是 | 时间戳(ms)。 |
F
fangyun 已提交
25
| callback | AsyncCallback<void> | 是 | 回调函数。当系统时间设置成功err为null,否则为错误对象。 |
F
fangyun 已提交
26 27 28 29 30 31 32 33

**示例:**

```js
let wantTemp = {
    bundleName: "bundleName",
    abilityName: "abilityName",
};
F
fangyun 已提交
34 35 36 37 38 39 40 41
let deviceSettingsMgr = enterpriseDeviceManager.getDeviceSettingsManager();
deviceSettingsMgr.setDateTime(wantTemp, 1526003846000, (error, value) => { 
    if (error) {
        console.log(error);
    } else {
        console.log(value);
    }
});
F
fangyun 已提交
42 43
```

F
fangyun 已提交
44
## DeviceSettingsManager.setDateTime
F
fangyun 已提交
45

F
fangyun 已提交
46
setDateTime(admin: Want, time: number): Promise<void>
F
fangyun 已提交
47

F
fangyun 已提交
48
设置系统时间。使用Promise异步回调。
F
fangyun 已提交
49

F
fangyun 已提交
50
**需要权限:** ohos.permission.EDM_MANAGE_DATETIME
F
fangyun 已提交
51 52 53 54 55 56 57

**系统能力:** SystemCapability.Customization.EnterpriseDeviceManager

**参数:**

| 参数名   | 类型                                  | 必填   | 说明      |
| ----- | ----------------------------------- | ---- | ------- |
F
fangyun 已提交
58 59
| admin | [Want](js-apis-application-Want.md) | 是    | 设备管理员应用。 |
| time  | number | 是 | 时间戳(ms)。 |
F
fangyun 已提交
60 61 62 63 64

**返回值:**

| 类型   | 说明                                  |
| ----- | ----------------------------------- |
F
fangyun 已提交
65
| Promise<void> | Promise对象。无返回结果的Promise对象。 |
F
fangyun 已提交
66 67 68 69 70 71 72 73 74


**示例:**

```js
let wantTemp = {
    bundleName: "bundleName",
    abilityName: "abilityName",
};
F
fangyun 已提交
75 76 77
let deviceSettingsMgr = enterpriseDeviceManager.getDeviceSettingsManager();
deviceSettingsMgr.setDateTime(wantTemp, 1526003846000).then((value) => {
    console.log(value);
F
fangyun 已提交
78 79 80 81
}).catch((error) => {
    console.log(error);
})
```