devkits-timestamp 1.0.0

package/README.md

@@ -0,0 +1,127 @@
+# devkits-timestamp
+
+> Convert Unix timestamps to human-readable dates and vice versa
+
+## Installation
+
+```bash
+npm install -g devkits-timestamp
+```
+
+Or use without installation:
+
+```bash
+npx devkits-timestamp [args]
+```
+
+## Usage
+
+```bash
+# Get current timestamp
+dk-timestamp                          # 1704067200
+
+# Convert timestamp to date
+dk-timestamp 1704067200               # Full date info (JSON)
+dk-timestamp 1704067200 -f iso        # 2024-01-01T00:00:00.000Z
+dk-timestamp 1704067200 -f utc        # Mon, 01 Jan 2024 00:00:00 GMT
+dk-timestamp 1704067200 -f date       # 1/1/2024
+dk-timestamp 1704067200 -f time       # 12:00:00 AM
+
+# Convert date to timestamp
+dk-timestamp -d "2024-01-01"          # 1704067200
+dk-timestamp -d "Jan 1, 2024"         # 1704067200
+dk-timestamp -d "2024-01-01 12:00:00" # 1704110400
+
+# Date to timestamp with format
+dk-timestamp -d "2024-01-01" -f iso   # 2024-01-01T00:00:00.000Z
+```
+
+## Why @devkits/timestamp?
+
+- ✅ Fast - Instant conversion
+- ✅ Zero dependencies - Pure Node.js
+- ✅ Offline - Works without internet
+- ✅ Free - Open source (MIT)
+- ✅ CLI - Use in your terminal
+- ✅ Multiple output formats
+
+## Output Formats
+
+- `iso` - ISO 8601 format (2024-01-01T00:00:00.000Z)
+- `utc` - UTC string (Mon, 01 Jan 2024 00:00:00 GMT)
+- `local` - Local timezone string
+- `date` - Date only (1/1/2024)
+- `time` - Time only (12:00:00 AM)
+
+## Web Version
+
+Prefer a GUI? Check out the web version: **https://devkits-tools.surge.sh/tools/timestamp**
+
+- 84 developer tools in one PWA
+- Works offline
+- No signup required
+
+## Pro Features
+
+Upgrade to Pro for advanced features:
+
+- 📦 Batch Processing
+- 🔗 API Access (1000 req/day free)
+- ☁️ Cloud Sync
+- 🎨 Custom Themes
+- 📊 Advanced Analytics
+- 💬 Priority Support
+
+**Price:** $9 one-time payment
+**Upgrade:** https://devkits-tools.surge.sh/pro
+**Discount:** Use code `EARLYBIRD-2026` for 20% off
+
+## See Also
+
+Part of the **[DevKits Tools](https://devkits-tools.surge.sh)** collection — 80+ free developer tools:
+
+### Popular Tools
+
+| Tool | npm Package | Description |
+|------|-------------|-------------|
+| **[Base64](https://devkits-tools.surge.sh/tools/base64)** | `@devkits/base64` | Encode/decode Base64 |
+| **[JSON Formatter](https://devkits-tools.surge.sh/tools/json-formatter)** | `@devkits/json-formatter` | Format and validate JSON |
+| **[Color Converter](https://devkits-tools.surge.sh/tools/color-converter)** | `@devkits/color-converter` | HEX/RGB/HSL conversion |
+| **[UUID Generator](https://devkits-tools.surge.sh/tools/uuid-generator)** | `@devkits/uuid-generator` | Generate unique UUIDs |
+| **[Hash Generator](https://devkits-tools.surge.sh/tools/hash-generator)** | `@devkits/hash-generator` | MD5, SHA1, SHA256, SHA512 |
+| **[Regex Tester](https://devkits-tools.surge.sh/tools/regex-tester)** | `@devkits/regex-tester` | Test regex patterns |
+
+### Other DevKits Tools
+
+- **[HTML Tools](https://devkits-tools.surge.sh/tools/html-entities)** — HTML entity encode/decode
+- **[CSS Tools](https://devkits-tools.surge.sh/tools/css-minifier)** — CSS minify/format
+- **[Cron Parser](https://devkits-tools.surge.sh/tools/cron-parser)** — Parse cron expressions
+- **[Case Convert](https://devkits-tools.surge.sh/tools/text-case)** — camelCase, snake_case, etc.
+- **[Slugify](https://devkits-tools.surge.sh/tools/slug-generator)** — Create URL-friendly slugs
+- **[Lorem Ipsum](https://devkits-tools.surge.sh/tools/lorem-ipsum)** — Generate placeholder text
+- **[Password Generator](https://devkits-tools.surge.sh/tools/password-generator)** — Secure passwords
+- **[Text Counter](https://devkits-tools.surge.sh/tools/text-counter)** — Word/char counter
+
+---
+
+### More from DevKits
+
+- **[Invoicely](https://invoicely-app.surge.sh)** — Free invoice generator for freelancers
+- **[SnapOG](https://snapog.surge.sh)** — Free OG image generator with 20+ templates
+- **[API Monitor](https://api-monitor-saas.surge.sh)** — Real-time API monitoring
+
+---
+
+👉 **Explore all 80+ developer tools at [DevKits Tools](https://devkits-tools.surge.sh)**
+
+## License
+
+MIT © [DevKits Team](https://devkits-tools.surge.sh)
+
+---
+
+## 🚀 API Monitoring for Developers
+
+Build better APIs with **API Monitor SaaS** — real-time monitoring, alerting, and analytics.
+
+👉 **Early Access: $1 pre-order (50% off for life)** → https://api-monitor-saas.surge.sh?utm_source=npm&utm_medium=readme&utm_campaign=phase0

package/index.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+
+/**
+ * @devkits/timestamp - Convert Unix timestamps to human-readable dates
+ *
+ * Usage:
+ *   dk-timestamp                     # Current timestamp
+ *   dk-timestamp 1704067200          # Convert to date
+ *   dk-timestamp -d "2024-01-01"     # Date to timestamp
+ *
+ * Web version: https://devkits-tools.surge.sh/tools/timestamp
+ * Pro features: https://devkits-tools.surge.sh/pro
+ */
+
+function formatTimestamp(ts) {
+  const date = new Date(ts * 1000);
+  return {
+    timestamp: ts,
+    iso: date.toISOString(),
+    utc: date.toUTCString(),
+    local: date.toString(),
+    date: date.toLocaleDateString(),
+    time: date.toLocaleTimeString(),
+  };
+}
+
+function parseDate(dateStr) {
+  const date = new Date(dateStr);
+  if (isNaN(date.getTime())) {
+    throw new Error(`Invalid date: ${dateStr}`);
+  }
+  return Math.floor(date.getTime() / 1000);
+}
+
+function showHelp() {
+  console.log(`
+@devkits/timestamp - Unix timestamp converter
+
+Usage:
+  dk-timestamp                       # Current timestamp
+  dk-timestamp 1704067200            # Timestamp to date
+  dk-timestamp -d "2024-01-01"       # Date to timestamp
+  dk-timestamp -d "Jan 1, 2024"      # Flexible date parsing
+
+Options:
+  -d, --date <date>     Convert date string to timestamp
+  -f, --format <fmt>    Output format: iso, utc, local, date, time
+  -h, --help            Show this help message
+
+Examples:
+  dk-timestamp                         # Current: 1704067200
+  dk-timestamp 1704067200              # 2024-01-01 00:00:00 UTC
+  dk-timestamp -d "2024-01-01"         # 1704067200
+  dk-timestamp -d "2024-01-01" -f iso  # 2024-01-01T00:00:00.000Z
+
+Web version: https://devkits-tools.surge.sh/tools/timestamp
+Pro features: https://devkits-tools.surge.sh/pro
+`);
+}
+
+// Main entry point
+const args = process.argv.slice(2);
+
+if (!args.length || args.includes('-h') || args.includes('--help')) {
+  showHelp();
+  process.exit(0);
+}
+
+// Parse options
+let dateStr = null;
+let format = null;
+let timestamp = null;
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === '-d' || args[i] === '--date') {
+    dateStr = args[++i];
+  } else if (args[i] === '-f' || args[i] === '--format') {
+    format = args[++i];
+  } else {
+    timestamp = parseInt(args[i], 10);
+  }
+}
+
+try {
+  if (dateStr) {
+    // Date to timestamp
+    const ts = parseDate(dateStr);
+    if (format) {
+      const date = new Date(ts * 1000);
+      switch (format) {
+        case 'iso':
+          console.log(date.toISOString());
+          break;
+        case 'utc':
+          console.log(date.toUTCString());
+          break;
+        case 'local':
+          console.log(date.toString());
+          break;
+        case 'date':
+          console.log(date.toLocaleDateString());
+          break;
+        case 'time':
+          console.log(date.toLocaleTimeString());
+          break;
+        default:
+          console.log(ts);
+      }
+    } else {
+      console.log(ts);
+    }
+  } else if (timestamp) {
+    // Timestamp to date
+    const result = formatTimestamp(timestamp);
+    if (format && result[format]) {
+      console.log(result[format]);
+    } else {
+      console.log(JSON.stringify(result, null, 2));
+    }
+  } else {
+    // Current timestamp
+    const now = Math.floor(Date.now() / 1000);
+    console.log(now);
+  }
+} catch (err) {
+  console.error(`Error: ${err.message}`);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "devkits-timestamp",
+  "version": "1.0.0",
+  "description": "Convert Unix timestamps to human-readable dates and vice versa",
+  "main": "index.js",
+  "bin": {
+    "dk-timestamp": "./index.js",
+    "timestamp-cli": "./index.js"
+  },
+  "scripts": {
+    "test": "node test.js"
+  },
+  "keywords": [
+    "timestamp",
+    "unix",
+    "epoch",
+    "date",
+    "convert",
+    "devkits",
+    "developer-tools",
+    "cli",
+    "command-line",
+    "nodejs",
+    "utility",
+    "productivity",
+    "dev-tools",
+    "free-tools"
+  ],
+  "author": "DevKits Team <devkits-auto@protonmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/devkits/tools"
+  },
+  "homepage": "https://devkits-tools.surge.sh/tools/timestamp",
+  "bugs": {
+    "url": "https://github.com/devkits/tools/issues"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "test.js"
+  ],
+  "dependencies": {}
+}

package/test.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+
+/**
+ * Tests for @devkits/timestamp
+ */
+
+const { execSync } = require('child_process');
+
+const tests = [
+  {
+    name: 'Current timestamp is a number',
+    cmd: 'node index.js',
+    check: (result) => /^\d{10}$/.test(result.trim())
+  },
+  {
+    name: 'Timestamp to date (JSON output)',
+    cmd: 'node index.js 1704067200',
+    check: (result) => result.includes('2024-01-01') && result.includes('1704067200')
+  },
+  {
+    name: 'Timestamp to ISO format',
+    cmd: 'node index.js 1704067200 -f iso',
+    check: (result) => result.includes('2024-01-01')
+  },
+  {
+    name: 'Date to timestamp',
+    cmd: 'node index.js -d "2024-01-01"',
+    check: (result) => parseInt(result.trim()) === 1704067200
+  },
+  {
+    name: 'Date with time to timestamp',
+    cmd: 'node index.js -d "2024-01-01 12:00:00"',
+    check: (result) => parseInt(result.trim()) === 1704110400
+  },
+];
+
+let passed = 0;
+let failed = 0;
+
+console.log('Running @devkits/timestamp tests...\n');
+
+for (const test of tests) {
+  try {
+    const result = execSync(test.cmd, { encoding: 'utf8' }).trim();
+    if (test.check(result)) {
+      console.log(`✅ ${test.name}`);
+      passed++;
+    } else {
+      console.log(`❌ ${test.name}`);
+      console.log(`   Got: ${result}`);
+      failed++;
+    }
+  } catch (err) {
+    console.log(`❌ ${test.name} - Error: ${err.message}`);
+    failed++;
+  }
+}
+
+console.log(`\n${passed}/${tests.length} tests passed`);
+process.exit(failed > 0 ? 1 : 0);