# Timer

**Repository Path**: chinasoft_ohos/timer

## Basic Information

- **Project Name**: Timer
- **Description**: HarmonyJS 计时器控件
- **Primary Language**: JavaScript
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2021-08-26
- **Last Updated**: 2025-03-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 计时器, 鸿蒙

## README

# Timer计时器

简介: 一个可以精确到毫秒的倒计时 Harmony JS UI控件, 支持多种显示格式, 开发者可根据需求制定格式、样式, 支持计时结束方法回调

## 效果展示
![图片](ext/timer_demo_callback.gif) 

## 使用示例
1. [下载组件代码](demo/src/main/js/default/pages/timer)到本地, 添加到你的项目中
2. 通过`element`导入timer组件
    ```hml
    <element src="../timer/timer.hml"></element>
    ```
3. 根据需要选择计时器格式, 设置倒计时时长, 刷新频率等参数

    ```hml
    <timer duration="900090000" format="d天HH小时mm分钟:ss秒SSS毫秒" update-rate="10" class="text"></timer>
    <timer duration="900090000" format="d-HH:mm:ss:SSS" update-rate="10" class="red"></timer>
    <timer duration="90000" format="mm:ss:SS" update-rate="10" class="bold"></timer>
    <timer duration="90000" format="mm:ss:S" update-rate="100"></timer>
    <timer duration="90000" format="mm:ss" update-rate="100" @on-end="onTimerEnd"></timer>
    ```

## 参数说明
|  参数  | 说明 | 类型  | 是否必填 
| :----  | ----  | ----  | ----  |
| duration  | 倒计时时长(单位毫秒) | number | 是 |
| format  | 显示格式, 支持 d/天 HH/小时 mm/分钟 ss/秒 S/分秒 SS/厘秒 SSS/毫秒, 可按需裁剪拼接 | string | 否, 默认值:HH:mm:ss 
| update-rate  | 刷新频率(单位毫秒) | number | 否, 默认1000(1秒) |

## 回调方法
|  方法名   | 说明 | 参数  |
|  :----  | ----  | ----  |
| @on-end | 计时结束回调 | 无 |
  

## License

MulanPSL2, See the [LICENSE](./LICENSE) file for details.