設置系統時間

本模塊用來設置、獲取當前系統時間，設置、獲取當前系統日期和設置、獲取當前系統時區。

說明： 本模塊首批接口從API version 7開始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。 開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導入模塊

import systemTime from '@ohos.systemTime';

systemTime.setTime

setTime(time : number, callback : AsyncCallback) : void

設置系統時間。

需要權限： ohos.permission.SET_TIME

系統能力： SystemCapability.Miscservices.Time

參數：

示例：

// 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

設置系統時間。

需要權限： ohos.permission.SET_TIME

系統能力： SystemCapability.MiscServices.Time

參數：

返回值：

示例：

// 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 紀元以來經過的時間，使用callback形式返回結果。

系統能力： SystemCapability.MiscServices.Time

參數：

示例：

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 紀元以來經過的時間，使用Promise形式返回結果。

系統能力： SystemCapability.MiscServices.Time

參數：

返回值：

示例：

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

獲取自系統啟動以來經過的時間，不包括深度睡眠時間，使用callback形式返回結果。

系統能力： SystemCapability.MiscServices.Time

參數：

示例：

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

獲取自系統啟動以來經過的時間，不包括深度睡眠時間，使用Promise形式返回結果。

系統能力： SystemCapability.MiscServices.Time

參數：

返回值：

示例：

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

獲取自系統啟動以來經過的時間，包括深度睡眠時間，使用callback形式返回結果。

系統能力： SystemCapability.MiscServices.Time

參數：

示例：

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

獲取自系統啟動以來經過的時間，包括深度睡眠時間，使用Promise形式返回結果。

系統能力： SystemCapability.MiscServices.Time

參數：

返回值：

示例：

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

設置系統日期，使用callback形式返回結果。

需要權限： ohos.permission.SET_TIME

系統能力： SystemCapability.MiscServices.Time

參數：

示例：

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

設置系統日期，使用Promise形式返回結果。

需要權限： ohos.permission.SET_TIME

系統能力： SystemCapability.MiscServices.Time

參數：

返回值：

示例：

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

獲取當前系統日期，使用callback形式返回結果。

系統能力： SystemCapability.MiscServices.Time

參數：

示例：

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

獲取當前系統日期，使用Promise形式返回結果。

系統能力： SystemCapability.MiscServices.Time

返回值：

示例：

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

設置系統時區。

需要權限： ohos.permission.SET_TIME_ZONE

系統能力： SystemCapability.MiscServices.Time

參數：

示例：

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

設置系統時區。

需要權限： ohos.permission.SET_TIME_ZONE

系統能力： SystemCapability.MiscServices.Time

參數：

返回值：

示例：

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

獲取系統時區，使用callback形式返回結果。

系統能力： SystemCapability.MiscServices.Time

參數：

示例：

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

獲取系統時區，使用Promise形式返回結果。

系統能力： SystemCapability.MiscServices.Time

返回值：

示例：

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));
});

審核編輯 黃宇