yy-date-format

日期格式化工具，支持多种日期格式转换。

安装

npm install yy-date-format

使用

基础用法

import { 
  formatTimestamp,
  formatDate,
  formatDateDash,
  formatDateTime,
  formatRelativeTime
} from 'yy-date-format';

// 格式化时间戳
const time = formatTimestamp(Date.now());
// "2024-01-01 12:00:00"

// 格式化日期（斜杠格式）
const date = formatDate(new Date());
// "2024/01/01"

// 格式化日期（横杠格式）
const dateDash = formatDateDash(new Date());
// "2024-01-01"

// 自定义格式
const datetime = formatDateTime(new Date(), 'YYYY-MM-DD HH:mm');
// "2024-01-01 12:00"

// 相对时间
const relative = formatRelativeTime(new Date(Date.now() - 3600000));
// "1小时前"

Excel日期转换

import { excelDateToJSDate } from 'yy-date-format';

// 将Excel日期序列号转换为Date对象
const date = excelDateToJSDate(44927); // Excel中的2023-01-01

获取今天的时间范围

import { getTodayTimeRange } from 'yy-date-format';

const [start, end] = getTodayTimeRange();
// ["2024-01-01 00:00:00", "2024-01-01 23:59:59"]

API

formatTimestamp(timestamp)

将毫秒时间戳转换为 YYYY-MM-DD HH:mm:ss 格式。

参数：

• timestamp (number) - 毫秒时间戳

formatDate(value)

格式化日期为 YYYY/MM/DD 格式。

参数：

• value (Date|string|number) - 日期值

formatDateDash(value)

格式化日期为 YYYY-MM-DD 格式。

参数：

• value (Date|string|number) - 日期值

formatDateTime(value, format)

格式化日期时间。

参数：

• value (Date|string|number) - 日期值
• format (string) - 格式字符串，默认 'YYYY-MM-DD HH:mm:ss'

excelDateToJSDate(excelDate)

将 Excel 日期序列号转换为 Date 对象。

参数：

• excelDate (number) - Excel日期序列号

getTodayTimeRange()

获取今天的开始和结束时间。

返回值：

• string[] - [开始时间, 结束时间]

getDateFormat(days)

根据天数差获取日期格式。

参数：

• days (number) - 天数差

返回值：

• 'YY/MM' - 如果天数 > 90
• 'YY/MM/DD' - 如果天数 <= 90

formatRelativeTime(date)

格式化相对时间（如：刚刚、1分钟前、1小时前等）。

参数：

• date (Date|string|number) - 日期值

特性

• ✅ 多种日期格式支持
• ✅ Excel日期转换
• ✅ 相对时间格式化
• ✅ 零依赖
• ✅ TypeScript 支持