{"_id":"@amgoku/date-utils","_rev":"6-75269b93bb7f110eb5df39c87759c4bf","name":"@amgoku/date-utils","dist-tags":{"latest":"1.0.5"},"versions":{"1.0.0":{"name":"@amgoku/date-utils","version":"1.0.0","keywords":["date","time","utils","typescript"],"author":{"name":"Your Name"},"license":"MIT","_id":"@amgoku/date-utils@1.0.0","maintainers":[{"name":"amgoku","email":"amkrishna2483@gmail.com"}],"dist":{"shasum":"5c38a29586ce558c14d5e2ba814256ca09734330","tarball":"https://registry.npmjs.org/@amgoku/date-utils/-/date-utils-1.0.0.tgz","fileCount":6,"integrity":"sha512-5IvBrrtHXd/Hj3rc9nDiUMqkRtqugNfWZAZrs62nEee2HdQIpW9cjFnUJhkQK3z86Vz0lDenMdbZ7re2SKrNZg==","signatures":[{"sig":"MEQCIBMA8SYM/qWWG/WltKcMf24DF/idNLBjZ7JLgujJeuCyAiBdYAclyUAEzr2yWJXVZFyU9H+d/55/nJc8SqvPiRcebA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":5861},"main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc"},"_npmUser":{"name":"amgoku","email":"amkrishna2483@gmail.com"},"_npmVersion":"10.5.0","description":"Lightweight TypeScript date utility functions","directories":{},"_nodeVersion":"20.12.2","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/date-utils_1.0.0_1753366379527_0.36092429221084243","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@amgoku/date-utils","version":"1.0.1","keywords":["date","time","utils","typescript"],"author":{"name":"Your Name"},"license":"MIT","_id":"@amgoku/date-utils@1.0.1","maintainers":[{"name":"amgoku","email":"amkrishna2483@gmail.com"}],"dist":{"shasum":"2d550357d3566b75dc1b84c591e170037362db4d","tarball":"https://registry.npmjs.org/@amgoku/date-utils/-/date-utils-1.0.1.tgz","fileCount":6,"integrity":"sha512-kXrFZiwxjjYOuP32GVhkiV8Cej8hAYvI1aOlqm1fGeUICKsjNLdTaKydPPjA9doEsY6XxDYi9tKLBkAPq3zErg==","signatures":[{"sig":"MEQCIG9vkuE6XmTtHLr1vPtzU/HzVrKizGD6LSwLkcx00ob3AiAiSAKqi2WZ0xgMqqfeThdMl7MG3fIoFmzxNZKvH6ZIVw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8996},"main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc"},"_npmUser":{"name":"amgoku","email":"amkrishna2483@gmail.com"},"_npmVersion":"10.5.0","description":"Lightweight TypeScript date utility functions","directories":{},"_nodeVersion":"20.12.2","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/date-utils_1.0.1_1753366747136_0.42001987764190174","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@amgoku/date-utils","version":"1.0.2","keywords":["date","time","utils","typescript"],"author":{"name":"Your Name"},"license":"MIT","_id":"@amgoku/date-utils@1.0.2","maintainers":[{"name":"amgoku","email":"amkrishna2483@gmail.com"}],"dist":{"shasum":"cb1966610fb9bd10d1fa3c5b1f3b7aeedda40013","tarball":"https://registry.npmjs.org/@amgoku/date-utils/-/date-utils-1.0.2.tgz","fileCount":6,"integrity":"sha512-WffbGckbGEhgAqeOyB0wnYjJ35Glzt8Zc2UEhHDob4ose5hrn3NevbuTbXcds9EGjR/J/FQkfiQrYNlzOuNalA==","signatures":[{"sig":"MEUCIQDBivcxAKPq5nDP/eXkIi3O+nZLSGRm05ixDFQeyqzscwIgIlbpAAVMt/nD9qwLxG/eruLoES7CDzxYHPyqdXNfWl0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8333},"main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc"},"_npmUser":{"name":"amgoku","email":"amkrishna2483@gmail.com"},"_npmVersion":"10.5.0","description":"Lightweight TypeScript date utility functions","directories":{},"_nodeVersion":"20.12.2","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/date-utils_1.0.2_1753367266625_0.07493880550655718","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@amgoku/date-utils","version":"1.0.3","keywords":["date","time","utils","typescript"],"author":{"name":"Your Name"},"license":"MIT","_id":"@amgoku/date-utils@1.0.3","maintainers":[{"name":"amgoku","email":"amkrishna2483@gmail.com"}],"dist":{"shasum":"dfdac056b407176a7d822cd7976a965b9968dd8a","tarball":"https://registry.npmjs.org/@amgoku/date-utils/-/date-utils-1.0.3.tgz","fileCount":6,"integrity":"sha512-r2SZtOYeNRON43+MCS84NLxNi3BlX2J4hY5Azpcg3hNLqc+ACmTS5PUvRwNo0OPINBAr1XeazP48tzMnvhdVKQ==","signatures":[{"sig":"MEUCIFTLEBlWer1jU7+ZoLSH39vY8w/+yyeAR30AK53BG09YAiEAqXoU1cTZ0I2pYYTsH/v7+LaULRIoN/B3j76vK95uUTA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8373},"main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc"},"_npmUser":{"name":"amgoku","email":"amkrishna2483@gmail.com"},"_npmVersion":"10.5.0","description":"Lightweight TypeScript date utility functions","directories":{},"_nodeVersion":"20.12.2","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/date-utils_1.0.3_1753367638118_0.13875202381488028","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@amgoku/date-utils","version":"1.0.4","keywords":["date","time","utils","typescript"],"author":{"name":"Your Name"},"license":"MIT","_id":"@amgoku/date-utils@1.0.4","maintainers":[{"name":"amgoku","email":"amkrishna2483@gmail.com"}],"dist":{"shasum":"fc78f8852d1570508845bf8a5bd1fcf9755e84d7","tarball":"https://registry.npmjs.org/@amgoku/date-utils/-/date-utils-1.0.4.tgz","fileCount":6,"integrity":"sha512-+MjXwSaN+ojLfiEMne3DSiECotmot5Pvuagy8EyWU4W9AfXkqoEVXSEoUg3wuyZr6XgOD8GEmIoc3HNFdL8fBw==","signatures":[{"sig":"MEQCIFgOJYwRax94N7W9oCyvDg+nQIg5EUkClBuypERnphClAiA8RPB4ZODSjDc2xOD94rsShhKxcZdms6e0bZO+FmyShA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8371},"main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc"},"_npmUser":{"name":"amgoku","email":"amkrishna2483@gmail.com"},"_npmVersion":"10.5.0","description":"Lightweight TypeScript date utility functions","directories":{},"_nodeVersion":"20.12.2","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/date-utils_1.0.4_1753367817881_0.6700526050668714","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@amgoku/date-utils","version":"1.0.5","description":"Lightweight TypeScript date utility functions","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc"},"keywords":["date","time","utils","typescript"],"author":{"name":"Your Name"},"license":"MIT","devDependencies":{"typescript":"^5.8.3"},"_id":"@amgoku/date-utils@1.0.5","_nodeVersion":"20.12.2","_npmVersion":"10.5.0","dist":{"integrity":"sha512-PyVKJMs21Thsbsph7sQj2tXTee5oiNuniXxYUrGZ4QkXm6KljRXtMhBFJuvpE5N+5ecuh4+APHoEtWsot3WMHg==","shasum":"4ac697de818151e7947aaf38d6becd76275ed528","tarball":"https://registry.npmjs.org/@amgoku/date-utils/-/date-utils-1.0.5.tgz","fileCount":6,"unpackedSize":8369,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHYhvtrwaEyFdWk3+aRAAi3k+z4gyJ2kjcWf2edcjvE6AiBlmZ5Qu0lMNPSXE5/ZoISjCHLpRkL9MUoy6lHL7+1pJQ=="}]},"_npmUser":{"name":"amgoku","email":"amkrishna2483@gmail.com"},"directories":{},"maintainers":[{"name":"amgoku","email":"amkrishna2483@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/date-utils_1.0.5_1753368073977_0.20720739968927582"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-24T14:12:59.458Z","modified":"2025-07-24T14:41:14.408Z","1.0.0":"2025-07-24T14:12:59.720Z","1.0.1":"2025-07-24T14:19:07.331Z","1.0.2":"2025-07-24T14:27:46.811Z","1.0.3":"2025-07-24T14:33:58.310Z","1.0.4":"2025-07-24T14:36:58.083Z","1.0.5":"2025-07-24T14:41:14.196Z"},"author":{"name":"Your Name"},"license":"MIT","keywords":["date","time","utils","typescript"],"description":"Lightweight TypeScript date utility functions","maintainers":[{"name":"amgoku","email":"amkrishna2483@gmail.com"}],"readme":"# @amgoku/date-utils\n\nA lightweight **TypeScript date utility library** with commonly used date and time functions — no external dependencies.\n\n![npm](https://img.shields.io/npm/v/@amgoku/date-utils)\n![license](https://img.shields.io/npm/l/@amgoku/date-utils)\n![downloads](https://img.shields.io/npm/dm/@amgoku/date-utils)\n\n---\n\n## Features\n\n- Format dates with custom patterns (`YYYY-MM-DD`, `DD/MM/YYYY`, etc.)\n- Get human-readable relative times (`timeAgo(new Date()) → \"2h ago\"`)\n- Check if a date is today or yesterday\n- Add or compare dates easily\n- Get start or end of a day\n- Retrieve weekday names in plain English\n- Convert dates to ISO strings\n- Written in **TypeScript**, with full type definitions\n- Zero dependencies\n\n---\n\n## Installation\n\n```bash\nnpm install @amgoku/date-utils\n```\nor\n```bash\nyarn add @amgoku/date-utils\n```\n\n## Usage\n\n```ts\nimport { formatDate, timeAgo, isToday, addDays } from \"@amgoku/date-utils\";\n\n// Format a date\nconsole.log(formatDate(new Date(), \"DD/MM/YYYY\")); // Output: \"24/07/2025\"\n\n// Time ago\nconsole.log(timeAgo(new Date(Date.now() - 3600 * 1000))); // Output: \"1h ago\"\n\n// Check if today\nconsole.log(isToday(new Date())); // true\n\n// Add 7 days\nconst nextWeek = addDays(new Date(), 7);\nconsole.log(formatDate(nextWeek)); // Output: \"2025-07-31\"\n```\n\n## API Reference\n\n- formatDate(date: Date, format?: string): string\nFormats a date using these tokens:\n\nYYYY → 4-digit year\n\nMM → 2-digit month\n\nDD → 2-digit day\n\nHH → 2-digit hours (24-hour format)\n\nmm → 2-digit minutes\n\nss → 2-digit seconds\n\nDefault format: \"YYYY-MM-DD\"\n\n- timeAgo(date: Date): string\nReturns a relative time string, like:\n\n\"45s ago\"\n\n\"5m ago\"\n\n\"2h ago\"\n\n\"3d ago\"\n\n- isToday(date: Date): boolean\nReturns true if the given date is today.\n\n- isYesterday(date: Date): boolean\nReturns true if the given date is yesterday.\n\n- daysBetween(date1: Date, date2: Date): number\nReturns the absolute difference between two dates in days.\n\n- addDays(date: Date, days: number): Date\nReturns a new date by adding (or subtracting, if negative) the given number of days.\n\n- startOfDay(date: Date): Date\nReturns a new Date object representing the start of the given day (00:00:00).\n\n- endOfDay(date: Date): Date\nReturns a new Date object representing the end of the given day (23:59:59).\n\n- getWeekday(date: Date): string\nReturns the weekday name, e.g., \"Monday\".\n\n- toISO(date: Date): string\nReturns the ISO 8601 string representation of the date.\n\n\n## License\nMIT © 2025 Gokul Krishna\n\n---\n","readmeFilename":"README.md"}