# 设置系统时间
> **说明：**
>从 API Version 7 开始支持。
## 支持设备
手机
|
平板
|
智慧屏
|
智能穿戴
|
|---|
支持
|
支持
|
支持
|
支持
|
## 导入模块
```
import systemTime from '@ohos.systemTime';
```
## systemTime.setTime
setTime\(time : number, callback : AsyncCallback\) : void
设置系统时间，需要ohos.permission.SET\_TIME权限。
- 参数：
参数名
|
类型
|
必填
|
说明
|
|---|
time
|
number
|
是
|
目标时间戳（毫秒）。
|
callback
|
AsyncCallback<void>
|
是
|
回调函数，可以在回调函数中处理接口返回值。
|
- 示例：
```
// time对应的时间为2021-01-20 02:36:25
var time = 1611081385000;
systemTime.setTime(time, (error, data) => {
if (error) {
console.error(`failed to systemTime.setTime because ` + JSON.stringify(error));
return;
}
console.log(`success to systemTime.setTime: ` + JSON.stringify(data));
});
```
## systemTime.setTime
setTime\(time : number\) : Promise
设置系统时间，需要ohos.permission.SET\_TIME权限。
- 参数：
参数名
|
类型
|
必填
|
说明
|
|---|
time
|
number
|
是
|
目标时间戳（毫秒）。
|
- 返回值：
类型
|
说明
|
|---|
Promise<void>
|
返回的异步回调函数。
|
- 示例：
```
// time对应的时间为2021-01-20 02:36:25
var time = 1611081385000;
systemTime.setTime(time).then((data) => {
console.log(`success to systemTime.setTime: ` + JSON.stringify(data));
}).catch((error) => {
console.error(`failed to systemTime.setTime because ` + JSON.stringify(error));
});
```
## systemTime.setDate
setDate\(date: Date, callback: AsyncCallback\): void
设置系统日期，需要ohos.permission.SET\_TIME权限。
- 参数：
参数名
|
类型
|
必填
|
说明
|
|---|
date
|
Date
|
是
|
目标日期。
|
callback
|
AsyncCallback<void>
|
是
|
回调函数，可以在回调函数中处理接口返回值。
|
- 示例：
```
var data = new Date("October 13, 2020 11:13:00");
systemTime.setDate(data,(error, data) => {
if (error) {
console.error('SystemTimePlugin setDate failed because ' + JSON.stringify(error));
return;
}
console.info('SystemTimePlugin setDate success data : ' + JSON.stringify(data));
});
```
## systemTime.setDate
setDate\(date: Date\): Promise
设置系统日期，需要ohos.permission.SET\_TIME权限。
- 参数：
参数名
|
类型
|
必填
|
说明
|
|---|
date
|
Date
|
是
|
目标日期。
|
- 返回值：
类型
|
说明
|
|---|
Promise<void>
|
返回的异步回调函数。
|
- 示例：
```
var data = new Date("October 13, 2020 11:13:00");
systemTime.setDate(data).then((value) => {
console.log(`SystemTimePlugin success to systemTime.setDate: ` + JSON.stringify(value));
}).catch((error) => {
console.error(`SystemTimePlugin failed to systemTime.setDate because: ` + JSON.stringify(error));
});
```
## systemTime.setTimezone
setTimezone\(timezone: string, callback: AsyncCallback\): void
设置系统时区，需要ohos.permission.SET\_TIME\_ZONE权限。
- 参数：
参数名
|
类型
|
必填
|
说明
|
|---|
timezone
|
string
|
是
|
系统时区。
|
callback
|
AsyncCallback<void>
|
是
|
回调函数，可以在回调函数中处理接口返回值。
|
- 示例：
```
systemTime.setTimezone('Asia/Shanghai', (error, data) => {
if (error) {
console.error('SystemTimePlugin setTimezone failed because ' + JSON.stringify(error));
return;
}
console.info('SystemTimePlugin setTimezone success data : ' + JSON.stringify(data));
});
```
## systemTime.setTimezone
setTimezone\(timezone: string\): Promise
设置系统时区，需要ohos.permission.SET\_TIME\_ZONE权限。
- 参数：
参数名
|
类型
|
必填
|
说明
|
|---|
timezone
|
string
|
是
|
系统时区。
|
- 返回值：
类型
|
说明
|
|---|
Promise<void>
|
返回的异步回调函数。
|
- 示例：
```
systemTime.setTimezone('Asia/Shanghai').then((data) => {
console.log(`SystemTimePlugin success to systemTime.setTimezone: ` + JSON.stringify(data));
}).catch((error) => {
console.error(`SystemTimePlugin failed to systemTime.setTimezone because: ` + JSON.stringify(error));
});
```