xw-devtool-cli 1.0.12 → 1.0.13

package/README.md

@@ -2,7 +2,7 @@
 
 一个基于 Node.js 的开发者命令行工具箱，旨在提供开箱即用的常用开发工具，帮助开发者快速处理日常任务。
 
-主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、特殊符号大全等。所有结果均自动复制到剪贴板，极大提升开发效率。
+主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、时间计算、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、特殊符号大全等。所有结果均自动复制到剪贴板，极大提升开发效率。
 
 ## ✨ 功能特性
 
@@ -17,6 +17,7 @@
 - **时间工具**：
   - **时间格式化**：时间戳/日期字符串 -> `YYYY-MM-DD HH:mm:ss`。
   - **获取时间戳**：快速获取当前毫秒级时间戳。
+  - **时间计算**：计算日期差值或日期偏移 (Add/Subtract)。
 - **开发辅助工具**：
   - **URL 编解码**：Encode/Decode URL。
   - **Unicode 编解码**：文本与 Unicode 转义序列 (\uXXXX) 互转。
@@ -73,12 +74,13 @@ xw-devtool
 9. Variable Format Converter
 a. Chinese to Pinyin
 b. Time Format / Timestamp
-c. Color Converter (Hex <-> RGB)
-d. Get UUID
-e. Hash Calculator (MD5/SHA/SM3)
-f. Mock Text
-g. Special Characters (Symbols)
-h. Emoji Picker
+c. Time Calculation (Diff/Offset)
+d. Color Converter (Hex <-> RGB)
+e. Get UUID
+f. Hash Calculator (MD5/SHA/SM3)
+g. Mock Text
+h. Special Characters (Symbols)
+i. Emoji Picker
 0. Exit
 =================================
 ```
@@ -173,32 +175,40 @@ h. Emoji Picker
 - 支持时间戳转日期字符串，或日期字符串转时间戳。
 - 直接回车可获取当前时间戳。
 
-### 12. 颜色转换 (Hex <-> RGB)
+### 12. 时间计算 (Time Calculation)
 - 选择 `c` 进入。
+- **Diff**: 计算两个日期之间的时间差 (天、小时、分、秒)。
+- **Offset**: 计算指定偏移量后的日期。
+  - 支持单位：Years, Months, Weeks, Days, Hours, Minutes, Seconds。
+  - 支持操作：Add (+), Subtract (-)。
+  - 示例：计算 "当前时间 3 天后" 或 "2025-01-01 5 小时前"。
+
+### 13. 颜色转换 (Hex <-> RGB)
+- 选择 `d` 进入。
 - 输入 Hex 颜色值 (如 #333) 或 RGB 值 (如 rgb(51,51,51))。
 - 自动转换并显示对应格式。
 
-### 13. Get UUID
-- 选择 `d` 进入。
+### 14. Get UUID
+- 选择 `e` 进入。
 - 自动生成一个 UUID v4 并复制到剪贴板。
 
-### 14. 哈希计算 (Encryption)
-- 选择 `e` 进入。
+### 15. 哈希计算 (Encryption)
+- 选择 `f` 进入。
 - 输入文本（支持直接回车读取剪贴板）。
 - 同时计算并显示 MD5, SHA1, SHA256, SHA512, SM3 哈希值。
 
-### 15. Mock 数据生成
-- 选择 `f` 进入。
+### 16. Mock 数据生成
+- 选择 `g` 进入。
 - 提供多种数据类型：英文段落、中文字符、身份证号、邮箱、手机号等。
 - 支持指定生成数量。
 
-### 16. 特殊符号大全
-- 选择 `g` 进入。
+### 17. 特殊符号大全
+- 选择 `h` 进入。
 - 网格化展示常用特殊符号。
 - 输入符号对应的编号即可一键复制。
 
-### 17. Emoji 输入
-- 选择 `h` 进入。
+### 18. Emoji 输入
+- 选择 `i` 进入。
 - 分类展示常用 Emoji (表情、手势、动物、食物等)。
 - 输入编号选择并复制 Emoji 到剪贴板。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",

package/src/commands/timeCalc.js

@@ -0,0 +1,151 @@
+import inquirer from 'inquirer';
+import dayjs from 'dayjs';
+import duration from 'dayjs/plugin/duration.js';
+import { copy } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+
+dayjs.extend(duration);
+
+export async function timeCalcHandler() {
+    const mode = await selectFromMenu('Time Calculation', [
+        { name: 'Diff (Calculate difference between two dates)', value: 'diff' },
+        { name: 'Add/Subtract (Calculate new date from offset)', value: 'offset' }
+    ]);
+
+    if (mode === 'diff') {
+        await handleDiff();
+    } else {
+        await handleOffset();
+    }
+}
+
+async function handleDiff() {
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'start',
+            message: 'Enter Start Date (YYYY-MM-DD HH:mm:ss or timestamp):',
+            default: dayjs().format('YYYY-MM-DD HH:mm:ss')
+        },
+        {
+            type: 'input',
+            name: 'end',
+            message: 'Enter End Date (YYYY-MM-DD HH:mm:ss or timestamp):',
+            default: dayjs().format('YYYY-MM-DD HH:mm:ss')
+        }
+    ]);
+
+    const start = parseDate(answers.start);
+    const end = parseDate(answers.end);
+
+    if (!start.isValid() || !end.isValid()) {
+        console.error('Invalid date format.');
+        return;
+    }
+
+    const diffMs = end.diff(start);
+    const dur = dayjs.duration(diffMs);
+
+    const result = [
+        `Start: ${start.format('YYYY-MM-DD HH:mm:ss')}`,
+        `End:   ${end.format('YYYY-MM-DD HH:mm:ss')}`,
+        '---------------------------------',
+        `Total Days:    ${dur.asDays().toFixed(2)}`,
+        `Total Hours:   ${dur.asHours().toFixed(2)}`,
+        `Total Minutes: ${dur.asMinutes().toFixed(2)}`,
+        `Total Seconds: ${dur.asSeconds().toFixed(0)}`,
+        '---------------------------------',
+        `Human Readable: ${formatDuration(dur)}`
+    ].join('\n');
+
+    console.log(`\n${result}\n`);
+    await copy(result);
+}
+
+async function handleOffset() {
+    const { startInput } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'startInput',
+            message: 'Enter Start Date:',
+            default: dayjs().format('YYYY-MM-DD HH:mm:ss')
+        }
+    ]);
+
+    const start = parseDate(startInput);
+    if (!start.isValid()) {
+        console.error('Invalid date format.');
+        return;
+    }
+
+    const operator = await selectFromMenu('Select Operation', [
+        { name: 'Add (+)', value: 'add' },
+        { name: 'Subtract (-)', value: 'subtract' }
+    ]);
+
+    const unit = await selectFromMenu('Select Unit', [
+        { name: 'Days', value: 'day' },
+        { name: 'Hours', value: 'hour' },
+        { name: 'Minutes', value: 'minute' },
+        { name: 'Seconds', value: 'second' },
+        { name: 'Weeks', value: 'week' },
+        { name: 'Months', value: 'month' },
+        { name: 'Years', value: 'year' }
+    ]);
+
+    const { amount } = await inquirer.prompt([
+        {
+            type: 'number',
+            name: 'amount',
+            message: `Enter Amount of ${unit}s (number):`,
+            validate: val => !isNaN(val) || 'Please enter a number'
+        }
+    ]);
+
+    let resultDate;
+    if (operator === 'add') {
+        resultDate = start.add(amount, unit);
+    } else {
+        resultDate = start.subtract(amount, unit);
+    }
+
+    const result = resultDate.format('YYYY-MM-DD HH:mm:ss');
+    console.log(`\nResult Date: ${result}\n`);
+    await copy(result);
+}
+
+function parseDate(input) {
+    if (!input) return dayjs();
+    if (/^\d+$/.test(input)) {
+        const ts = parseInt(input);
+        if (input.length === 10) return dayjs.unix(ts);
+        return dayjs(ts);
+    }
+    return dayjs(input);
+}
+
+function formatDuration(dur) {
+    const parts = [];
+    const years = Math.floor(dur.asYears());
+    if (years > 0) parts.push(`${years} years`);
+    
+    // Calculate remaining duration after removing years is tricky with dayjs duration directly
+    // simplified approach:
+    
+    const d = Math.abs(dur.asMilliseconds());
+    const seconds = Math.floor((d / 1000) % 60);
+    const minutes = Math.floor((d / (1000 * 60)) % 60);
+    const hours = Math.floor((d / (1000 * 60 * 60)) % 24);
+    const days = Math.floor(d / (1000 * 60 * 60 * 24));
+
+    // Note: This simple day calc doesn't account for variable month lengths perfectly if we wanted "X months Y days"
+    // But for "X days Y hours..." it's accurate enough for absolute diff.
+    
+    let str = '';
+    if (days > 0) str += `${days} days `;
+    if (hours > 0) str += `${hours} hours `;
+    if (minutes > 0) str += `${minutes} mins `;
+    if (seconds > 0) str += `${seconds} secs`;
+    
+    return str.trim() || '0 secs';
+}

package/src/index.js

@@ -6,6 +6,7 @@ import { unicodeHandler } from './commands/unicode.js';
 import { imgBase64Handler } from './commands/imgBase64.js';
 import { imgConvertHandler } from './commands/imgConvert.js';
 import { timeFormatHandler } from './commands/timeFormat.js';
+import { timeCalcHandler } from './commands/timeCalc.js';
 import { mockHandler } from './commands/mock.js';
 import { uuidHandler } from './commands/uuid.js';
 import { pinyinHandler } from './commands/pinyin.js';
@@ -50,6 +51,7 @@ const features = [
 
     // Utils (Time, Color, UUID, Hash)
     { name: 'Time Format / Timestamp', value: 'timeFormat' },
+    { name: 'Time Calculation (Diff/Offset)', value: 'timeCalc' },
     { name: 'Color Converter (Hex <-> RGB)', value: 'color' },
     { name: 'Get UUID', value: 'uuid' },
     { name: 'Hash Calculator (MD5/SHA/SM3)', value: 'hashing' },
@@ -154,6 +156,9 @@ async function handleAction(action) {
         case 'timeFormat':
             await timeFormatHandler();
             break;
+        case 'timeCalc':
+            await timeCalcHandler();
+            break;
         case 'mock':
             await mockHandler();
             break;