Skip to main content

isAfterDate

Checks whether the target date is after the compare date.

The inclusive option allows comparing dates that are equal as well.


Code​

🔗 View source code


Interface​

typescript
interface IsAfterDateParams {
  targetDate: string | number | Date;
  compareDate?: string | number | Date;
  inclusive?: boolean;
}
typescript
function isAfterDate({
  targetDate,
  compareDate = new Date(),
  inclusive = false,
}: IsAfterDateParams): boolean;

Usage​

without compareDate​

  • When no compareDate is provided, returns true if the target date is after the current date.
typescript
import { isAfterDate } from '@modern-kit/utils';

// When the current date is January 1, 2025 00:00:00
isAfterDate({ targetDate: new Date('2025-01-02') }); // true
isAfterDate({ targetDate: new Date('2024-12-31') }); // false

// String format is also accepted.
isAfterDate({ targetDate: '2025-01-02' }); // true

with compareDate​

  • When a compareDate is provided, returns true if the target date is after the compare date.
typescript
import { isAfterDate } from '@modern-kit/utils';

isAfterDate({ targetDate: new Date('2025-01-01'), compareDate: new Date('2024-12-31') }); // true
isAfterDate({ targetDate: new Date('2024-12-31'), compareDate: new Date('2025-01-01') }); // false

// String format is also accepted.
isAfterDate({ targetDate: '2025-01-02', compareDate: '2025-01-01' }); // true

inclusive option​

  • When inclusive is true, equal dates are also considered as "after".
typescript
import { isAfterDate } from '@modern-kit/utils';

isAfterDate({
  targetDate: new Date('2025-01-01'),
  compareDate: new Date('2025-01-01'),
  inclusive: false,
});
// false

isAfterDate({
  targetDate: new Date('2025-01-01'),
  compareDate: new Date('2025-01-01'),
  inclusive: true,
});
// true