🚀 A simple utility for calculating future UNIX timestamps by adding seconds, minutes, hours, or days.

🔧 Lightweight | ⚡ Fast | ✅ Zero dependencies

Install via npm or yarn:

npm install unix-time-utils
# or
yarn add unix-time-utils

If your project uses ES Modules (import), simply:

import {
  unixTime,
  unixTimeInSeconds,
  unixTimeInMinutes,
  unixTimeInHours,
  unixTimeInDays,
} from "unix-time-utils";

// Get UNIX timestamps for future dates
console.log(unixTimeInSeconds(30)); // 📌 30 seconds from now
console.log(unixTimeInMinutes(10)); // 📌 10 minutes from now
console.log(unixTimeInHours(1)); // 📌 1 hour from now
console.log(unixTimeInDays(7)); // 📌 7 days from now

// Custom timestamp with multiple time units
console.log(unixTime({ days: 1, hours: 2 })); // 📌 1 day & 2 hours from now

For Node.js projects using CommonJS (require), add this to package.json:

"exports": {
  "import": "./index.js",
  "require": "./index.cjs"
}

Then use:

const { unixTime } = require("unix-time-utils");

console.log(unixTime({ days: 1, hours: 2 }));

This package uses Vitest for unit testing.
To run tests:

npm test

Or with watch mode:

npx vitest --watch

We welcome contributions! To contribute:

1. Fork this repository
2. Clone your forked repo:

   git clone https://github.com/razdacoder/unix-time-utils.git

3. Navigate into the project:

   cd unix-time-utils

4. Install dependencies:

   npm install

5. Create a new branch for your feature:

   git checkout -b my-new-feature

6. Make your changes and commit:

   git add .
   git commit -m "Added a new feature"

7. Push to your fork and create a Pull Request 🚀

This project is licensed under the MIT License.
Feel free to use and contribute! 🎉

If this package helps you, please 🌟 Star the repo on GitHub!

📩 Questions or Suggestions? Open an issue.