📅 Date Utilities

Date utilities provide a set of helpers to work with dates and times in a type-safe, ergonomic way. Use these tools for checking expiration, calculating intervals, and finding precise time differences without the weight of large date libraries.

📚 Quick Reference

Method	Description
expires	Check if a given date or timestamp has already passed.
interval	Calculate the duration between two dates in human-readable units.
timeDiff	Get the raw difference between two dates in specific units.

💡 Practical Examples

Expiration Checks

import { expires } from '@vielzeug/toolkit';

// Check if a token is still valid
const tokenExpiry = '2026-01-01T00:00:00Z';
if (expires(tokenExpiry)) {
  console.log('Token has expired');
}

Intervals & Durations

import { interval, timeDiff } from '@vielzeug/toolkit';

const start = new Date('2024-01-01');
const end = new Date('2024-01-02 12:30:00');

// Detailed interval breakdown
const duration = interval(start, end);
// { days: 1, hours: 12, minutes: 30, seconds: 0 }

// Specific difference
const diffInDays = timeDiff(start, end, ['days']); // "1 day"

🔗 All Date Utilities

• expires
• interval
• timeDiff