# timehelper

**Repository Path**: xsklf/timehelper

## Basic Information

- **Project Name**: timehelper
- **Description**: 录像时长计算器说明文档
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-09-15
- **Last Updated**: 2023-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 功能说明

计算两个时间点之间时长，支持夸录像计算，支持多种填写格式，计算结果格式统一：x时x分x秒

### 支持格式

| 示例               | 说明                         | 支持情况 |
| -------------------- | ------------------------------ | ---------- |
| 录像一：01：10     | 各字段之间以中文冒号分割     | ✅       |
| 录像一:01:10       | 各字段之间以英文冒号分割     | ✅       |
| 录像一；01；10     | 各字段之间以中文分号分割     | ✅       |
| 录像一;01;10       | 字段之间包含英文分号分割     | ✅       |
| 录像一       01:10 | 录像与时间字段之间以空格分割 | ✅       |
| 录像一01:10        | 录像与时间字段之间无分割     | ✅       |
| 15:20              | 仅填写时间不写录像字段       | ✅       |
| 1:2:3              | 各时间字段可补0也可不补0     | ✅       |

### 不支持格式

| 示例        | 说明                                              | 支持情况 |
| ------------- | --------------------------------------------------- | ---------- |
| 录像2:15:40 | 录像段数不能以数字表示，否则计算时识别为：2:15:40 | ❌       |

### 时间范围合理性

* 小时：0<=h<=2
* 分钟：m<=59
* 秒：s<=59
* 同一时间段的开始时间不能大于结束时间

  💡 进店录像几乎不存在超过2小时情况，为防止误填写，小时部分限制不可超过2

### 快捷键

* ​   ​**TAB**​  ​ 切换输入焦点到下一个输入框
* **​   ENTER ​**​ ​ 触发计算功能
*  **​  CTRL   ​**+**​   C   ​**复制计算结果到剪贴板

### 使用示例

1. 不跨录像时间段计算：录像一:10:20-录像一18:05

![不跨录像时间段计算](image1.png)

2. 只跨两段录像时间段计算：录像一:10:20-录像二18:05，假设**录像一总时长为30:00**

![只跨两段录像时间段计算](image2.png)

3. 跨两段以上录像时间段计算：录像一10:20-录像三18:05，**假设录像一总时长为30:00，录像二总时长为14:33**

![跨两段以上录像时间段计算](image3.png)

### 填写提示

* 时间段1表示第一个时间点与其所在录像结束时间之间的时长
* 时间段2表示第二个时间点与其所在录像开始时间之间的时长
* 附加时长表示两个时间点夸的录像的时长

  * 假设时间段跨3个录像，被跨过的录像时长是14:33可直接在三个附加时长输入框中任一个写入即可
  * 假设时间段跨3个以上录像，被跨过的录像时长固定且易于口算时，可口算出扩过的总时长填写到附加时长，如：录像一10:20-录像六18:05，录像二、三、四、五的时长都是10:00，可直接在附加时长填写40:00
  * 假设时间段跨3个以上录像，且被跨过的录像时长不固定或不易于口算时，可将每段跨过的录像时长填写到附加时长，由于输入框数量限制此种情况最多填写3个附加时长

### 待更新

* [ ] 选择服务环节，校验计算结果是否在该环节的合理时长范围

### 更新记录

* 2023-09-15

  * 项目初始化