Time Filter Utility

A highly optimized, timezone-aware npm package for generating common date ranges and filters.

Installation

npm install time-filter-utility

Usage

const timeFilters = require("time-filter-utility");

const filters = timeFilters("Asia/Kolkata"); // Specify your timezone

// Get current month range
const currentMonth = filters.currentMonth();
console.log(currentMonth.start); // Start date in UTC
console.log(currentMonth.end); // End date in UTC

// Available filters:
console.log(filters.lastMonth());
console.log(filters.last7Days());
console.log(filters.lastWeek());
console.log(filters.last24Hours());
console.log(filters.lastYear());
console.log(filters.last3Months());
console.log(filters.currentYear());
console.log(filters.last30Days());
console.log(filters.yesterday());
console.log(filters.last6Months());
console.log(filters.today());

Each filter returns an object with start and end properties, both as Date objects in UTC, representing the full range from 00:00:00 to 23:59:59 in the specified timezone.

Supported Timezones

Use IANA timezone identifiers like:

• 'America/New_York'
• 'Europe/London'
• 'Asia/Tokyo'
• 'Asia/Kolkata'

Filters

• currentMonth(): Current month
• lastMonth(): Previous month
• last7Days(): Last 7 days including today
• lastWeek(): Last full week (Mon-Sun)
• last24Hours(): Last 24 hours
• lastYear(): Previous year
• last3Months(): Last 3 months
• last6Months(): Last 6 months
• currentYear(): Current year
• last30Days(): Last 30 days including today
• yesterday(): Yesterday
• today(): Today

License

MIT