設置系統(tǒng)時間
本模塊用來設置、獲取當前系統(tǒng)時間,設置、獲取當前系統(tǒng)日期和設置、獲取當前系統(tǒng)時區(qū)。
說明: 本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口,采用上角標單獨標記接口的起始版本。 開發(fā)前請熟悉鴻蒙開發(fā)指導文檔 :[
gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
導入模塊
import systemTime from '@ohos.systemTime';
systemTime.setTime
setTime(time : number, callback : AsyncCallback) : void
設置系統(tǒng)時間。
需要權限: ohos.permission.SET_TIME
系統(tǒng)能力: SystemCapability.Miscservices.Time
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
time | number | 是 | 目標時間戳(ms)。 |
callback | AsyncCallback | 是 | 回調(diào)函數(shù),可以在回調(diào)函數(shù)中處理接口返回值。 |
示例:
// 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(`systemTime.setTime success data : ` + JSON.stringify(data));
});
systemTime.setTime
setTime(time : number) : Promise
設置系統(tǒng)時間。
需要權限: ohos.permission.SET_TIME
系統(tǒng)能力: SystemCapability.MiscServices.Time
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
time | number | 是 | 目標時間戳(ms)。 |
返回值:
類型 | 說明 |
---|---|
Promise | 返回的異步回調(diào)函數(shù)。 |
示例:
// time對應的時間為2021-01-20 02:36:25
var time = 1611081385000;
systemTime.setTime(time).then((data) = > {
console.log(`systemTime.setTime success data : ` + JSON.stringify(data));
}).catch((error) = > {
console.error(`failed to systemTime.setTime because ` + JSON.stringify(error));
});
systemTime.getCurrentTime8+
getCurrentTime(isNano?: boolean, callback: AsyncCallback): void
獲取自 Unix 紀元以來經(jīng)過的時間,使用callback形式返回結果。
系統(tǒng)能力: SystemCapability.MiscServices.Time
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
isNano | boolean | 否 | 如果是true,返回納秒數(shù);否則返回毫秒數(shù)。 |
callback | AsyncCallback | 是 | 回調(diào)函數(shù),返回自 Unix 紀元以來經(jīng)過的時間。 |
示例:
systemTime.getCurrentTime(true, (error, data) = > {
if (error) {
console.error(`failed to systemTime.getCurrentTime because ` + JSON.stringify(error));
return;
}
console.log(`systemTime.getCurrentTime success data : ` + JSON.stringify(data));
});
systemTime.getCurrentTime8+
getCurrentTime(isNano?: boolean): Promise
獲取自 Unix 紀元以來經(jīng)過的時間,使用Promise形式返回結果。
系統(tǒng)能力: SystemCapability.MiscServices.Time
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
isNano | boolean | 否 | 如果是true,返回納秒數(shù);否則返回毫秒數(shù)。 |
返回值:
類型 | 說明 |
---|---|
Promise | 以Promise形式返回結果,返回自 Unix 紀元以來經(jīng)過的時間。 |
示例:
systemTime.getCurrentTime().then((data) = > {
console.log(`systemTime.getCurrentTime success data : ` + JSON.stringify(data));
}).catch((error) = > {
console.error(`failed to systemTime.getCurrentTime because ` + JSON.stringify(error));
});
systemTime.getRealActiveTime8+
getRealActiveTime(isNano?: boolean, callback: AsyncCallback): void
獲取自系統(tǒng)啟動以來經(jīng)過的時間,不包括深度睡眠時間,使用callback形式返回結果。
系統(tǒng)能力: SystemCapability.MiscServices.Time
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
isNano | boolean | 否 | 如果是true,返回納秒數(shù);否則返回毫秒數(shù)。 |
callback | AsyncCallback | 是 | 回調(diào)函數(shù),返回自系統(tǒng)啟動以來但不包括度睡眠時間經(jīng)過的時間。 |
示例:
systemTime.getRealActiveTime(true, (error, data) = > {
if (error) {
console.error(`failed to systemTime.getRealActiveTimebecause ` + JSON.stringify(error));
return;
}
console.log(`systemTime.getRealActiveTime success data : ` + JSON.stringify(data));
});
systemTime.getRealActiveTime8+
getRealActiveTime(isNano?: boolean): Promise
獲取自系統(tǒng)啟動以來經(jīng)過的時間,不包括深度睡眠時間,使用Promise形式返回結果。
系統(tǒng)能力: SystemCapability.MiscServices.Time
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
isNano | boolean | 否 | 如果是true,返回納秒數(shù);否則返回毫秒數(shù)。 |
返回值:
類型 | 說明 |
---|---|
Promise | 以Promise形式返回結果,返回自系統(tǒng)啟動以來經(jīng)過的時間,但不包括深度睡眠時間。 |
示例:
systemTime.getRealActiveTime().then((data) = > {
console.log(`systemTime.getRealActiveTime success data : ` + JSON.stringify(data));
}).catch((error) = > {
console.error(`failed to systemTime.getRealActiveTime because ` + JSON.stringify(error));
});
systemTime.getRealTime8+
getRealTime(callback: AsyncCallback): void
獲取自系統(tǒng)啟動以來經(jīng)過的時間,包括深度睡眠時間,使用callback形式返回結果。
系統(tǒng)能力: SystemCapability.MiscServices.Time
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
isNano | boolean | 否 | 如果是true,返回納秒數(shù);否則返回毫秒數(shù)。 |
callback | AsyncCallback | 是 | 回調(diào)函數(shù),返回自系統(tǒng)啟動以來經(jīng)過的時間,包括深度睡眠時間。 |
示例:
systemTime.getRealTime(true, (error, data) = > {
if (error) {
console.error(`failed to systemTime.getRealTime because ` + JSON.stringify(error));
return;
}
console.log(`systemTime.getRealTime success data: ` + JSON.stringify(data));
});
systemTime.getRealTime8+
getRealTime(): Promise
獲取自系統(tǒng)啟動以來經(jīng)過的時間,包括深度睡眠時間,使用Promise形式返回結果。
系統(tǒng)能力: SystemCapability.MiscServices.Time
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
isNano | boolean | 否 | 如果是true,返回納秒數(shù);否則返回毫秒數(shù)。 |
返回值:
類型 | 說明 |
---|---|
Promise | 以Promise形式返回結果,返回自系統(tǒng)啟動以來經(jīng)過的時間,包括深度睡眠時間。 |
示例:
systemTime.getRealTime().then((data) = > {
console.log(`systemTime.getRealTime success data: ` + JSON.stringify(data));
}).catch((error) = > {
console.error(`failed to systemTime.getRealTime because ` + JSON.stringify(error));
});
systemTime.setDate
setDate(date: Date, callback: AsyncCallback): void
設置系統(tǒng)日期,使用callback形式返回結果。
需要權限: ohos.permission.SET_TIME
系統(tǒng)能力: SystemCapability.MiscServices.Time
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
date | Date | 是 | 目標日期。 |
callback | AsyncCallback | 是 | 回調(diào)函數(shù),可以在回調(diào)函數(shù)中處理接口返回值。 |
示例:
var data = new Date("October 13, 2020 11:13:00");
systemTime.setDate(data,(error, data) = > {
if (error) {
console.error('failed to systemTime.setDate because ' + JSON.stringify(error));
return;
}
console.info('systemTime.setDate success data : ' + JSON.stringify(data));
});
systemTime.setDate
setDate(date: Date): Promise
設置系統(tǒng)日期,使用Promise形式返回結果。
需要權限: ohos.permission.SET_TIME
系統(tǒng)能力: SystemCapability.MiscServices.Time
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
date | Date | 是 | 目標日期。 |
返回值:
類型 | 說明 |
---|---|
Promise | 返回的異步回調(diào)函數(shù)。 |
示例:
var data = new Date("October 13, 2020 11:13:00");
systemTime.setDate(data).then((value) = > {
console.log(`systemTime.setDate success data : ` + JSON.stringify(value));
}).catch((error) = > {
console.error(`failed to systemTime.setDate because: ` + JSON.stringify(error));
});
systemTime.getDate8+
getDate(callback: AsyncCallback): void
獲取當前系統(tǒng)日期,使用callback形式返回結果。
系統(tǒng)能力: SystemCapability.MiscServices.Time
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback | 是 | 回調(diào)函數(shù),返回當前系統(tǒng)日期。 |
示例:
systemTime.getDate((error, data) = > {
if (error) {
console.error(`failed to systemTime.getDate because ` + JSON.stringify(error));
return;
}
console.log(`systemTime.getDate success data : ` + JSON.stringify(data));
});
systemTime.getDate8+
getDate(): Promise
獲取當前系統(tǒng)日期,使用Promise形式返回結果。
系統(tǒng)能力: SystemCapability.MiscServices.Time
返回值:
類型 | 說明 |
---|---|
Promise | 以Promise形式返回結果,返回當前系統(tǒng)日期。 |
示例:
systemTime.getDate().then((data) = > {
console.log(`systemTime.getDate success data : ` + JSON.stringify(data));
}).catch((error) = > {
console.error(`failed to systemTime.getDate because ` + JSON.stringify(error));
});
systemTime.setTimezone
setTimezone(timezone: string, callback: AsyncCallback): void
設置系統(tǒng)時區(qū)。
需要權限: ohos.permission.SET_TIME_ZONE
系統(tǒng)能力: SystemCapability.MiscServices.Time
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
timezone | string | 是 | 系統(tǒng)時區(qū)。 |
callback | AsyncCallback | 是 | 回調(diào)函數(shù),可以在回調(diào)函數(shù)中處理接口返回值。 |
示例:
systemTime.setTimezone('Asia/Shanghai', (error, data) = > {
if (error) {
console.error('failed to systemTime.setTimezone because ' + JSON.stringify(error));
return;
}
console.info('SystemTimePlugin systemTime.setTimezone success data : ' + JSON.stringify(data));
});
systemTime.setTimezone
setTimezone(timezone: string): Promise
設置系統(tǒng)時區(qū)。
需要權限: ohos.permission.SET_TIME_ZONE
系統(tǒng)能力: SystemCapability.MiscServices.Time
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
timezone | string | 是 | 系統(tǒng)時區(qū)。 |
返回值:
類型 | 說明 |
---|---|
Promise | 返回的異步回調(diào)函數(shù)。 |
示例:
systemTime.setTimezone('Asia/Shanghai').then((data) = > {
console.log(`systemTime.setTimezone success data : ` + JSON.stringify(data));
}).catch((error) = > {
console.error(`failed to systemTime.setTimezone because: ` + JSON.stringify(error));
});
systemTime.getTimezone8+
getTimezone(callback: AsyncCallback): void
獲取系統(tǒng)時區(qū),使用callback形式返回結果。
系統(tǒng)能力: SystemCapability.MiscServices.Time
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback | 是 | 回調(diào)函數(shù),返回系統(tǒng)時區(qū)。 |
示例:
systemTime.getTimezone((error, data) = > {
if (error) {
console.error(`failed to systemTime.getTimezone because ` + JSON.stringify(error));
return;
}
console.log(`systemTime.getTimezone success data : ` + JSON.stringify(data));
});
systemTime.getTimezone8+
getTimezone(): Promise
獲取系統(tǒng)時區(qū),使用Promise形式返回結果。
系統(tǒng)能力: SystemCapability.MiscServices.Time
返回值:
類型 | 說明 |
---|---|
Promise | 以Promise形式返回結果,返回系統(tǒng)時區(qū)。HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿 |
示例:
systemTime.getTimezone().then((data) = > {
console.log(`systemTime.getTimezone success data : ` + JSON.stringify(data));
}).catch((error) = > {
console.error(`failed to systemTime.getTimezone because ` + JSON.stringify(error));
});
審核編輯 黃宇
-
開發(fā)系統(tǒng)
+關注
關注
0文章
38瀏覽量
9997 -
鴻蒙
+關注
關注
59文章
2531瀏覽量
43788
發(fā)布評論請先 登錄
HarmonyOS/OpenHarmony應用開發(fā)-ArkTSAPI系統(tǒng)能力SystemCapability
鴻蒙原生應用/元服務開發(fā)-Stage模型能力接口(二)
鴻蒙原生應用/元服務開發(fā)-Stage模型能力接口(四)
鴻蒙系統(tǒng)2021年正式推送時間
鴻蒙系統(tǒng)是基于什么開發(fā)的
鴻蒙系統(tǒng)是基于什么開發(fā)的
鴻蒙系統(tǒng)用的什么語言開發(fā)的
華為鴻蒙系統(tǒng)桌面怎么設置?
嵌入式Linux 硬件時間-系統(tǒng)時間-時區(qū)設置

鴻蒙開發(fā)UI界面——@ohos.font (注冊自定義字體)
鴻蒙開發(fā)系統(tǒng)基礎能力:ohos.hilog 日志打印
鴻蒙開發(fā)系統(tǒng)基礎能力:ohos.pasteboard 剪貼板

鴻蒙開發(fā)系統(tǒng)基礎能力:ohos.screenLock 鎖屏管理

鴻蒙開發(fā)管理:ohos.account.osAccount 系統(tǒng)帳號管理

評論