JSDate库操作日期与时间的实用方法

JSDate库是一个轻量级的JavaScript日期时间处理工具，专为解决原生Date对象的局限性而设计。它提供了简单易用的API来处理日期格式化、时间计算和时区转换等常见需求。

JSDate基础操作与初始化

使用JSDate库的第一步是创建日期对象。以下是几种常见的初始化方式：

1. 获取当前时间：

const now = JSDate() // 等同于JSDate.now()

2. 从字符串解析日期：

const date1 = JSDate("2023-11-20") // 自动识别ISO格式
const date2 = JSDate("2023年11月20日", "YYYY年MM月DD日") // 自定义格式

3. 从时间戳创建：

const timestampDate = JSDate(1679328000000) // 毫秒级时间戳
const unixDate = JSDate.unix(1679328000) // 秒级时间戳

4. 通过日期组件构造：

const customDate = JSDate({
  year: 2023,
  month: 10, // 1-12表示月份，不像原生Date从0开始
  day: 20,
  hour: 14,
  minute: 30
})

日期格式化与显示

JSDate提供了强大的格式化功能，比原生Date对象更易用：

1. 基础格式化：

JSDate().format("YYYY-MM-DD") // "2023-11-20"
JSDate().format("HH:mm:ss") // "14:30:45"

2. 本地化显示：

JSDate().locale("zh-cn").format("dddd") // "星期一"

3. 相对时间显示：

JSDate().add(-3, "minutes").fromNow() // "3分钟前"

4. 自定义格式扩展：

JSDate.extend({
  Q: function() {
    return Math.ceil((this.month() + 1) / 3)
  }
})
JSDate().format("YYYY年第Q季度") // "2023年第4季度"

日期计算与操作

JSDate简化了日期计算过程：

1. 日期加减：

JSDate().add(7, "days") // 加7天
JSDate().add(-1, "months") // 减1个月

2. 日期差值计算：

const start = JSDate("2023-01-01")
const end = JSDate("2023-12-31")
end.diff(start, "days") // 364

3. 获取时间边界：

JSDate().startOf("month") // 当月第一天00:00:00
JSDate().endOf("year") // 当年最后一天23:59:59

4. 日期比较：

JSDate("2023-11-20").isAfter("2023-11-19") // true
JSDate("2023-11-20").isSame("2023-11-20", "day") // true

高级功能

JSDate还提供了一些高级功能：

1. 时区转换：

JSDate().tz("America/New_York").format()

2. 工作日判断：

JSDate().isWeekend() // 周末返回true

3. 闰年判断：

JSDate("2024-01-01").isLeapYear() // true

4. 获取月份天数：

JSDate("2023-02-01").daysInMonth() // 28

性能优化建议

1. 对于频繁操作的场景，建议重用JSDate对象而不是重复创建：

const baseDate = JSDate()
const dates = Array(1000).fill(0).map(() => baseDate.clone().add(Math.random(), "days"))

2. 如果只需要格式化功能，可以使用轻量级构建：

import { format } from "jsdate/light"

JSDate库通过简洁的API设计，解决了JavaScript原生Date对象的许多痛点，是处理日期时间任务的理想选择。