Compare

isToday

Performance: Timezone required for converting timestamp to current day

reference/compare/isToday.ts
import { isToday } from "datezone";

const now = Date.now();
console.log(isToday(now, "UTC"));

isTomorrow

Performance: Timezone required for converting timestamp to current day

reference/compare/isTomorrow.ts
import { isTomorrow } from "datezone";

const now = Date.now();
const tomorrow = now + 24 * 60 * 60 * 1000;
console.log(isTomorrow(tomorrow, "UTC"));

isYesterday

Performance: Timezone required for converting timestamp to current day

reference/compare/isYesterday.ts
import { isYesterday } from "datezone";

const now = Date.now();
const yesterday = now - 24 * 60 * 60 * 1000;
console.log(isYesterday(yesterday, "UTC"));

isPast

Performance: Timezone required for DST-aware comparison with current time

reference/compare/isPast.ts
import { isPast } from "datezone";

const past = Date.now() - 100000;
const future = Date.now() + 100000;

console.log(isPast(past)); // true
console.log(isPast(future)); // false

isFuture

Performance: Timezone required for DST-aware comparison with current time

reference/compare/isFuture.ts
import { isFuture } from "datezone";

const future = Date.now() + 100000;
console.log(isFuture(future)); // true

const past = Date.now() - 100000;
console.log(isFuture(past)); // false

isWeekend

Performance: Timezone only needed for timestamp-to-date conversion, not DST

reference/compare/isWeekend.ts
import { isWeekend } from "datezone";

const saturday = Date.UTC(2024, 0, 13); // Jan 13, 2024 (Saturday)
const monday = Date.UTC(2024, 0, 15); // Jan 15, 2024 (Monday)

console.log(isWeekend(saturday, "UTC")); // true
console.log(isWeekend(monday, "UTC")); // false

isBefore

Performance: Simple timestamp comparison, no timezone conversion needed

reference/compare/isBefore.ts
import { isBefore } from "datezone";

const ts1 = Date.UTC(2024, 0, 1); // Jan 1, 2024
const ts2 = Date.UTC(2024, 0, 2); // Jan 2, 2024

console.log(isBefore(ts1, ts2)); // true
console.log(isBefore(ts2, ts1)); // false

isAfter

Performance: Simple timestamp comparison, no timezone conversion needed

reference/compare/isAfter.ts
import { isAfter } from "datezone";

const ts1 = Date.UTC(2024, 0, 2); // Jan 2, 2024
const ts2 = Date.UTC(2024, 0, 1); // Jan 1, 2024

console.log(isAfter(ts1, ts2)); // true
console.log(isAfter(ts2, ts1)); // false

isEqual

Performance: Simple timestamp comparison, no timezone conversion needed

reference/compare/isEqual.ts
import { isEqual } from "datezone";

const ts1 = Date.UTC(2024, 0, 1, 12, 0, 0);
const ts2 = Date.UTC(2024, 0, 1, 12, 0, 0);
const ts3 = Date.UTC(2024, 0, 2, 12, 0, 0);

console.log(isEqual(ts1, ts2)); // true
console.log(isEqual(ts1, ts3)); // false

isSameDay

Performance: Timezone only needed for timestamp-to-date conversion, not DST

reference/compare/isSameDay.ts
import { isSameDay } from "datezone";

const ts1 = Date.UTC(2024, 0, 1, 10, 0, 0); // Jan 1, 2024, 10:00 UTC
const ts2 = Date.UTC(2024, 0, 1, 22, 0, 0); // Jan 1, 2024, 22:00 UTC

console.log(isSameDay(ts1, ts2, "UTC")); // true

isSameWeek

Performance: Timezone only needed for timestamp-to-date conversion, not DST

reference/compare/isSameWeek.ts
import { isSameWeek } from "datezone";

const ts1 = Date.UTC(2024, 0, 15); // Jan 15, 2024 (Monday)
const ts2 = Date.UTC(2024, 0, 16); // Jan 16, 2024 (Tuesday)

console.log(isSameWeek(ts1, ts2, "UTC")); // true

isSameMonth

Performance: Timezone only needed for timestamp-to-date conversion

reference/compare/isSameMonth.ts
import { isSameMonth } from "datezone";

const ts1 = Date.UTC(2024, 0, 1); // Jan 1, 2024
const ts2 = Date.UTC(2024, 0, 31); // Jan 31, 2024
const ts3 = Date.UTC(2024, 1, 1); // Feb 1, 2024

console.log(isSameMonth(ts1, ts2, "UTC")); // true
console.log(isSameMonth(ts1, ts3, "UTC")); // false

isSameYear

Performance: Timezone only needed for timestamp-to-date conversion

reference/compare/isSameYear.ts
import { isSameYear } from "datezone";

const ts1 = Date.UTC(2024, 0, 1); // Jan 1, 2024
const ts2 = Date.UTC(2024, 11, 31); // Dec 31, 2024
const ts3 = Date.UTC(2025, 0, 1); // Jan 1, 2025

console.log(isSameYear(ts1, ts2, "UTC")); // true
console.log(isSameYear(ts1, ts3, "UTC")); // false

On this page