docs: 重构文档,将详细指南从README中移出

This commit is contained in:
熊熊熊子路 committed 2026-07-31 14:17:13 +08:00
1 parent 880d8e758f
commit 9e2cf53dc9
7 files changed
+286 -250

No files matched your search

+64
View File
@@ -0,0 +1,64 @@
# 时间日期格式化工具
灵活的时间日期格式化工具,位于 `miniprogram/utils/util.ts`。
## 主要功能
- 支持 Date 对象、时间戳、日期字符串等多种输入格式
- 自定义格式化模板,支持丰富的占位符
- 兼容中文日期格式(如 "2020年1月1日")
- 兼容 iOS/Safari 日期解析问题
- 支持 12/24 小时制转换
- 支持毫秒显示
## 使用示例
```typescript
import { formatTime, formatDateTime } from '../utils/util'
// 标准格式:YYYY/MM/DD HH:mm:ss
const time1 = formatTime(new Date())
// 输出:2024/01/15 14:30:45
// 自定义格式
const time2 = formatDateTime(new Date(), 'YYYY-MM-DD HH:mm:ss')
// 输出:2024-01-15 14:30:45
// 只显示日期
const date = formatDateTime(new Date(), 'YYYY年MM月DD日')
// 输出:2024年01月15日
// 12小时制
const time12 = formatDateTime(new Date(), 'YYYY/MM/DD hh:mm:ss A')
// 输出:2024/01/15 02:30:45 下午
// 时间戳格式化
const timestamp = formatDateTime(1705291845000, 'YYYY-MM-DD HH:mm')
// 输出:2024-01-15 14:30
// 字符串日期格式化
const strDate = formatDateTime('2024-01-15', 'YYYY年MM月DD日')
// 输出:2024年01月15日
```
## 占位符一览
| 占位符 | 说明 | 示例 |
|--------|------|------|
| `YYYY` | 4位年份 | 2024 |
| `YY` | 2位年份 | 24 |
| `MM` | 2位月份 | 01 |
| `M` | 1位月份 | 1 |
| `DD` | 2位日期 | 15 |
| `D` | 1位日期 | 15 |
| `HH` | 2位小时(24小时制) | 14 |
| `H` | 1位小时(24小时制) | 14 |
| `hh` | 2位小时(12小时制) | 02 |
| `h` | 1位小时(12小时制) | 2 |
| `mm` | 2位分钟 | 30 |
| `m` | 1位分钟 | 30 |
| `ss` | 2位秒 | 45 |
| `s` | 1位秒 | 45 |
| `SSS` | 3位毫秒 | 123 |
| `A` | 上午/下午 | 下午 |
| `a` | am/pm | pm |