harmony 鸿蒙@ohos.systemTimer (系统定时器)
@ohos.systemTimer (系统定时器)
本模块主要由系统定时器功能组成。开发者可以使用定时功能实现定时服务,如闹钟等。
说明:
- 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
- 本模块接口为系统接口。
导入模块
import systemTimer from '@ohos.systemTimer';
常量
支持创建的定时器类型。
系统能力: SystemCapability.MiscServices.Time
名称 | 类型 | 值 | 说明 |
---|---|---|---|
TIMER_TYPE_REALTIME | number | 1 | 系统启动时间定时器。(定时器启动时间不能晚于当前设置的系统时间) |
TIMER_TYPE_WAKEUP | number | 2 | 唤醒定时器。 |
TIMER_TYPE_EXACT | number | 4 | 精准定时器。 |
TIMER_TYPE_IDLE | number | 8 | IDLE模式定时器(暂不支持)。 |
## TimerOptions
创建系统定时器的初始化选项。
系统能力: SystemCapability.MiscServices.Time
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
type | number | 是 | 定时器类型。 取值为1,表示为系统启动时间定时器(定时器启动时间不能晚于当前设置的系统时间) ; 取值为2,表示为唤醒定时器; 取值为4,表示为精准定时器; 取值为8,表示为IDLE模式定时器(暂不支持)。 |
repeat | boolean | 是 | 是否为循环定时器。 true为循环定时器,false为单次定时器。 |
interval | number | 否 | 定时器时间间隔。 如果是循环定时器,interval值应大于5000毫秒;单次定时器interval值为0。 |
wantAgent | WantAgent | 否 | 设置通知的WantAgent,定时器到期后通知。(支持拉起应用MainAbility,暂不支持拉起ServiceAbility。) |
callback | number | 是 | 以回调函数的形式返回定时器的ID。 |
systemTimer.createTimer
createTimer(options: TimerOptions, callback: AsyncCallback<number>): void
创建定时器,使用callback异步回调。
系统能力: SystemCapability.MiscServices.Time
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
options | TimerOptions | 是 | 创建系统定时器的初始化选项,包括定时器类型、是否循环触发、间隔时间、WantAgent通知机制等。 |
callback | AsyncCallback<number> | 是 | 回调函数,返回定时器的ID。 |
示例:
import { BusinessError } from '@ohos.base';
let options: systemTimer.TimerOptions = {
type: systemTimer.TIMER_TYPE_REALTIME,
repeat: false
};
try {
systemTimer.createTimer(options, (error: BusinessError, timerId: Number) => {
if (error) {
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
return;
}
console.info(`Succeeded in creating timer. timerId: ${timerId}`);
});
} catch(e) {
let error = e as BusinessError;
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
}
systemTimer.createTimer
createTimer(options: TimerOptions): Promise<number>
创建定时器,使用Promise异步回调。
系统能力: SystemCapability.MiscServices.Time
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
options | TimerOptions | 是 | 创建系统定时器的初始化选项,包括定时器类型、是否循环触发、间隔时间、WantAgent通知机制等。 |
返回值:
类型 | 说明 |
---|---|
Promise<number> | Promise对象,返回定时器的ID。 |
示例:
import { BusinessError } from '@ohos.base';
let options: systemTimer.TimerOptions = {
type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false
};
try {
systemTimer.createTimer(options).then((timerId: Number) => {
console.info(`Succeeded in creating timer. timerId: ${timerId}`);
}).catch((error: BusinessError) => {
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
});
} catch(e) {
let error = e as BusinessError;
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
}
systemTimer.startTimer
startTimer(timer: number, triggerTime: number, callback: AsyncCallback<void>): void
开启定时器,使用callback异步回调。
系统能力: SystemCapability.MiscServices.Time
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
timer | number | 是 | 定时器的ID。 |
triggerTime | number | 是 | 定时器的触发时间,单位:毫秒。 |
callback | AsyncCallback<void> | 是 | 回调函数。 |
示例:
import { BusinessError } from '@ohos.base';
let options: systemTimer.TimerOptions = {
type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false
}
let triggerTime = new Date().getTime();
triggerTime += 3000;
try {
systemTimer.createTimer(options).then((timerId: number) => {
systemTimer.startTimer(timerId, triggerTime, (error: BusinessError) => {
if (error) {
console.info(`Failed to start timer. message: ${error.message}, code: ${error.code}`);
return;
}
console.info(`Succeeded in starting timer.`);
});
console.info(`Succeeded in creating timer. timerId: ${timerId}`);
}).catch((error: BusinessError) => {
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
});
} catch(e) {
let error = e as BusinessError;
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
}
systemTimer.startTimer
startTimer(timer: number, triggerTime: number): Promise<void>
开启定时器,使用Promise异步回调。
系统能力: SystemCapability.MiscServices.Time
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
timer | number | 是 | 定时器的ID。 |
triggerTime | number | 是 | 定时器的触发时间,单位:毫秒。 |
返回值:
类型 | 说明 |
---|---|
Promise<void> | 无返回结果的Promise对象。 |
示例:
import { BusinessError } from '@ohos.base';
let options: systemTimer.TimerOptions = {
type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false
}
let triggerTime = new Date().getTime();
triggerTime += 3000;
try {
systemTimer.createTimer(options).then((timerId: number) => {
systemTimer.startTimer(timerId, triggerTime).then(() => {
console.info(`Succeeded in starting timer.`);
}).catch((error: BusinessError) => {
console.info(`Failed to start timer. message: ${error.message}, code: ${error.code}`);
});
console.info(`Succeeded in creating timer. timerId: ${timerId}`);
}).catch((error: BusinessError) => {
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
});
} catch(e) {
let error = e as BusinessError;
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
}
systemTimer.stopTimer
stopTimer(timer: number, callback: AsyncCallback<void>): void
停止定时器,使用callback异步回调。
系统能力: SystemCapability.MiscServices.Time
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
timer | number | 是 | 定时器的ID。 |
callback | AsyncCallback<void> | 是 | 回调函数。 |
示例:
import { BusinessError } from '@ohos.base';
let options: systemTimer.TimerOptions = {
type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false
}
let triggerTime = new Date().getTime();
triggerTime += 3000;
try {
systemTimer.createTimer(options).then((timerId: number) => {
systemTimer.startTimer(timerId, triggerTime);
systemTimer.stopTimer(timerId, (error: BusinessError) => {
if (error) {
console.info(`Failed to stop timer. message: ${error.message}, code: ${error.code}`);
return;
}
console.info(`Succeeded in stopping timer.`);
});
console.info(`Succeeded in creating timer. timerId: ${timerId}`);
}).catch((error: BusinessError) => {
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
});
} catch(e) {
let error = e as BusinessError;
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
}
systemTimer.stopTimer
stopTimer(timer: number): Promise<void>
停止定时器,使用Promise异步回调。
系统能力: SystemCapability.MiscServices.Time
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
timer | number | 是 | 定时器的ID。 |
返回值:
类型 | 说明 |
---|---|
Promise<void> | 无返回结果的Promise对象。 |
示例:
import { BusinessError } from '@ohos.base';
let options: systemTimer.TimerOptions = {
type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false
}
let triggerTime = new Date().getTime();
triggerTime += 3000;
try {
systemTimer.createTimer(options).then((timerId: number) => {
systemTimer.startTimer(timerId, triggerTime);
systemTimer.stopTimer(timerId).then(() => {
console.info(`Succeeded in stopping timer.`);
}).catch((error: BusinessError) => {
console.info(`Failed to stop timer. message: ${error.message}, code: ${error.code}`);
});
console.info(`Succeeded in creating timer. timerId: ${timerId}`);
}).catch((error: BusinessError) => {
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
});
} catch(e) {
let error = e as BusinessError;
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
}
systemTimer.destroyTimer
destroyTimer(timer: number, callback: AsyncCallback<void>): void
销毁定时器,使用callback异步回调。
系统能力: SystemCapability.MiscServices.Time
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
timer | number | 是 | 定时器的ID。 |
callback | AsyncCallback<void> | 是 | 回调函数。 |
示例:
import { BusinessError } from '@ohos.base';
let options: systemTimer.TimerOptions = {
type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false
}
let triggerTime = new Date().getTime();
triggerTime += 3000;
try {
systemTimer.createTimer(options).then((timerId: number) => {
systemTimer.startTimer(timerId, triggerTime);
systemTimer.stopTimer(timerId);
systemTimer.destroyTimer(timerId, (error: BusinessError) => {
if (error) {
console.info(`Failed to destroy timer. message: ${error.message}, code: ${error.code}`);
return;
}
console.info(`Succeeded in destroying timer.`);
});
console.info(`Succeeded in creating timer. timerId: ${timerId}`);
}).catch((error: BusinessError) => {
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
});
} catch(e) {
let error = e as BusinessError;
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
}
systemTimer.destroyTimer
destroyTimer(timer: number): Promise<void>
销毁定时器,使用Promise异步回调。
系统能力: SystemCapability.MiscServices.Time
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
timer | number | 是 | 定时器的ID。 |
返回值:
类型 | 说明 |
---|---|
Promise<void> | 无返回结果的Promise对象。 |
示例:
import { BusinessError } from '@ohos.base';
let options: systemTimer.TimerOptions = {
type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false
}
let triggerTime = new Date().getTime();
triggerTime += 3000;
try {
systemTimer.createTimer(options).then((timerId: number) => {
systemTimer.startTimer(timerId, triggerTime);
systemTimer.stopTimer(timerId);
systemTimer.destroyTimer(timerId).then(() => {
console.info(`Succeeded in destroying timer.`);
}).catch((error: BusinessError) => {
console.info(`Failed to destroy timer. message: ${error.message}, code: ${error.code}`);
});
console.info(`Succeeded in creating timer. timerId: ${timerId}`);
}).catch((error: BusinessError) => {
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
});
} catch(e) {
let error = e as BusinessError;
console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
}
你可能感兴趣的鸿蒙文章
harmony 鸿蒙BundleStatusCallback
harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)
harmony 鸿蒙@ohos.distributedBundle (分布式包管理)
harmony 鸿蒙@ohos.bundle (Bundle模块)
harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦