系統(tǒng)時間、時區(qū)

導(dǎo)入模塊

import systemDateTime from '@ohos.systemDateTime';

systemDateTime.getCurrentTime

getCurrentTime(isNano: boolean, callback: AsyncCallback<number>): void

獲取自Unix紀(jì)元以來經(jīng)過的時間，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.Time

參數(shù)：

示例：

try {
    systemDateTime.getCurrentTime(true, (error, time) => {
        if (error) {
            console.info(`Failed to get currentTime. message:${error.message}, code:${error.code}`);
            return;
        }
        console.info(`Succeeded in getting currentTime : ${time}`);
    });
} catch(e) {
    console.info(`Failed to get currentTime. message:${e.message}, code:${e.code}`);
}

systemDateTime.getCurrentTime

getCurrentTime(callback: AsyncCallback<number>): void

獲取自Unix紀(jì)元以來經(jīng)過的時間，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.Time

參數(shù)：

示例：

try {
    systemDateTime.getCurrentTime((error, time) => {
        if (error) {
            console.info(`Failed to get currentTime. message:${error.message}, code:${error.code}`);
            return;
        }
        console.info(`Succeeded in getting currentTime : ${time}`);
    });
} catch(e) {
    console.info(`Failed to get currentTime. message:${e.message}, code:${e.code}`);
}

systemDateTime.getCurrentTime

getCurrentTime(isNano?: boolean): Promise<number>

獲取自Unix紀(jì)元以來經(jīng)過的時間，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.Time

參數(shù)：

返回值：

示例：

try {
    systemDateTime.getCurrentTime().then((time) => {
        console.info(`Succeeded in getting currentTime : ${time}`);
    }).catch((error) => {
        console.info(`Failed to get currentTime. message:${error.message}, code:${error.code}`);
    });
} catch(e) {
    console.info(`Failed to get currentTime. message:${e.message}, code:${e.code}`);
}

systemDateTime.getRealActiveTime

getRealActiveTime(isNano: boolean, callback: AsyncCallback<number>): void

獲取自系統(tǒng)啟動以來經(jīng)過的時間，不包括深度睡眠時間，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.Time

參數(shù)：

示例：

try {
    systemDateTime.getRealActiveTime(true, (error, time) => {
        if (error) {
            console.info(`Failed to get real active time. message:${error.message}, code:${error.code}`);
            return;
        }
        console.info(`Succeeded in getting real active time : ${time}`);
    });
} catch(e) {
    console.info(`Failed to get real active time. message:${e.message}, code:${e.code}`);
}

systemDateTime.getRealActiveTime

getRealActiveTime(callback: AsyncCallback<number>): void

獲取自系統(tǒng)啟動以來經(jīng)過的時間，不包括深度睡眠時間，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.Time

參數(shù)：

示例：

try {
    systemDateTime.getRealActiveTime((error, time) => {
        if (error) {
            console.info(`Failed to get real active time. message:${error.message}, code:${error.code}`);
            return;
        }
        console.info(`Succeeded in getting real active time : ${time}`);
    });
} catch(e) {
    console.info(`Failed to get real active time. message:${e.message}, code:${e.code}`);
}

systemDateTime.getRealActiveTime

getRealActiveTime(isNano?: boolean): Promise<number>

獲取自系統(tǒng)啟動以來經(jīng)過的時間，不包括深度睡眠時間，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.Time

參數(shù)：

返回值：

示例：

try {
    systemDateTime.getRealActiveTime().then((time) => {
        console.info(`Succeeded in getting real active time : ${time}`);
    }).catch((error) => {
        console.info(`Failed to get real active time. message:${error.message}, code:${error.code}`);
    });
} catch(e) {
    console.info(`Failed to get real active time. message:${e.message}, code:${e.code}`);
}

systemDateTime.getRealTime

getRealTime(isNano: boolean, callback: AsyncCallback<number>): void

獲取自系統(tǒng)啟動以來經(jīng)過的時間，包括深度睡眠時間，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.Time

參數(shù)：

示例：

try {
    systemDateTime.getRealTime(true, (error, time) => {
        if (error) {
            console.info(`Failed to get real time. message:${error.message}, code:${error.code}`);
            return;
        }
        console.info(`Succeeded in getting real time : ${time}`);
    });
} catch(e) {
    console.info(`Failed to get real time. message:${e.message}, code:${e.code}`);
}

systemDateTime.getRealTime

getRealTime(callback: AsyncCallback<number>): void

獲取自系統(tǒng)啟動以來經(jīng)過的時間，包括深度睡眠時間，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.Time

參數(shù)：

示例：

try {
    systemDateTime.getRealTime((error, time) => {
        if (error) {
            console.info(`Failed to get real time. message:${error.message}, code:${error.code}`);
            return;
        }
        console.info(`Succeeded in getting real time : ${time}`);
    });
} catch(e) {
    console.info(`Failed to get real time. message:${e.message}, code:${e.code}`);
}

systemDateTime.getRealTime

getRealTime(isNano?: boolean): Promise<number>

獲取自系統(tǒng)啟動以來經(jīng)過的時間，包括深度睡眠時間，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.Time

參數(shù)：

返回值：

示例：

try {
    systemDateTime.getRealTime().then((time) => {
        console.info(`Succeeded in getting real time : ${time}`);
    }).catch((error) => {
        console.info(`Failed to get real time. message:${error.message}, code:${error.code}`);
    });
} catch(e) {
    console.info(`Failed to get real time. message:${e.message}, code:${e.code}`);
}

systemDateTime.getDate

getDate(callback: AsyncCallback<Date>): void

獲取當(dāng)前系統(tǒng)日期，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.Time

參數(shù)：

示例：

try {
    systemDateTime.getDate((error, date) => {
        if (error) {
            console.info(`Failed to get date. message:${error.message}, code:${error.code}`);
            return;
        }
        console.info(`Succeeded in getting date : ${date}`);;
    });
} catch(e) {
    console.info(`Failed to get date. message:${e.message}, code:${e.code}`);
}

systemDateTime.getDate

getDate(): Promise<Date>

獲取當(dāng)前系統(tǒng)日期，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.Time

返回值：

示例：

try {
    systemDateTime.getDate().then((date) => {
        console.info(`Succeeded in getting date : ${date}`);
    }).catch((error) => {
        console.info(`Failed to get date. message:${error.message}, code:${error.code}`);
    });
} catch(e) {
    console.info(`Failed to get date. message:${e.message}, code:${e.code}`);
}

systemDateTime.getTimezone

getTimezone(callback: AsyncCallback<string>): void

獲取系統(tǒng)時區(qū)，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.Time

參數(shù)：

示例：

try {
    systemDateTime.getTimezone((error, data) => {
        if (error) {
            console.info(`Failed to get timezone. message:${error.message}, code:${error.code}`);
            return;
        }
        console.info(`Succeeded in get timezone : ${data}`);;
    });
} catch(e) {
    console.info(`Failed to get timezone. message:${e.message}, code:${e.code}`);
}

systemDateTime.getTimezone

getTimezone(): Promise<string>

獲取系統(tǒng)時區(qū)，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.Time

返回值：

示例：

try {
    systemDateTime.getTimezone().then((data) => {
        console.info(`Succeeded in getting timezone: ${data}`);
    }).catch((error) => {
        console.info(`Failed to get timezone. message:${error.message}, code:${error.code}`);
    });
} catch(e) {
    console.info(`Failed to get timezone. message:${e.message}, code:${e.code}`);
}

支持的系統(tǒng)時區(qū)

支持的系統(tǒng)時區(qū)及各時區(qū)與0時區(qū)相比的偏移量（單位：h）可見下表。