# timestampUtils

**Repository Path**: terrell-tan/timestamp-utils

## Basic Information

- **Project Name**: timestampUtils
- **Description**: 时间戳工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-15
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 在线时间戳转换工具

一个纯前端、开箱即用的 Unix 时间戳转换工具。无需后端、无需安装，浏览器打开 HTML 即可使用。

## 功能特性

- **实时时钟**：页面顶部实时显示当前日期、星期与时间，并展示当前时间戳（毫秒/秒），支持「开始 / 停止」刷新。
- **时间戳 → 时间**：输入 10 位（秒）或 13 位（毫秒）时间戳，自动识别单位并转换为 `yyyy-MM-dd HH:mm:ss` 格式。
- **时间 → 时间戳**：输入日期时间，转换为秒或毫秒级时间戳，兼容 `2026-06-08 11:17:33`、`2026/06/08 11:17:33`、`2026-06-08T11:17:33` 等多种写法。
- **粘贴即转换**：在输入框粘贴或输入内容后自动触发转换（带防抖），也可按回车或点「转换」按钮手动转换。
- **单位换算**：年 / 月 / 天 / 时 / 分 / 秒 / 毫秒之间互相换算，输入任意一个值即可算出其余单位。
- **中英文自适应**：根据浏览器语言自动切换中英文界面文案。
- **FAQ 说明**：内置常见问题解答，帮助理解时间戳概念与用法。

## 快速开始

1. 下载或克隆本项目到本地。
2. 直接双击打开根目录下的 `时间戳转换工具.html`，或用浏览器打开。
3. 无需任何依赖安装、无需启动服务器，打开即用。

> 所有依赖（jQuery、Bootstrap、jQuery UI 等）均已放在 `static/` 目录下本地引用，离线也能正常使用。

## 使用说明

### 1. 查看当前时间戳
页面顶部「当前时间戳与时间」卡片会实时刷新。点击「停止」可暂停刷新，「开始」恢复刷新。

### 2. 时间戳转时间
- 在「时间戳转时间」输入框中粘贴或输入时间戳。
- 10 位数字按「秒」处理，13 位数字按「毫秒」处理，单位会自动识别。
- 结果实时显示在右侧「日期时间结果」框中。

### 3. 时间转时间戳
- 在「时间转时间戳」输入框中输入日期时间。
- 通过下拉框选择输出单位（毫秒 / 秒）。
- 结果实时显示在右侧「时间戳结果」框中。

### 4. 年月日时分秒换算
- 在任意一个单位输入框中填入数值。
- 点击「转换」，其余单位会按换算规则自动计算；点「清除」重置。

> 换算规则：1 年 = 12 个月，1 个月 = 30 天，1 天 = 24 小时，1 小时 = 60 分钟，1 分钟 = 60 秒，1 秒 = 1000 毫秒。

## 项目结构

```
时间戳转换/
├── 时间戳转换工具.html      # 主页面（含全部业务逻辑）
├── README.md               # 项目说明
└── static/                 # 本地静态资源
    ├── jquery.min.js
    ├── bootstrap5.min.css / .js
    ├── jquery-ui.*         # 日期时间选择器组件
    ├── common.js           # Date.prototype.Format 等公共方法
    ├── common.css
    └── ...                 # 字体、图片等
```

## 技术栈

- HTML + 原生 JavaScript
- [jQuery](https://jquery.com/)
- [Bootstrap 5](https://getbootstrap.com/)
- jQuery UI（日期时间选择组件）

## 注意事项

- 时间转换基于**浏览器本地时区**，跨时区使用时请注意时差。
- 时间戳仅支持标准格式：10 位（秒）或 13 位（毫秒）纯数字。
- 标准 Unix 时间戳从 1970-01-01 00:00:00 UTC 起算，早于该时间的日期可能无法正常表示。