@duplojs/utils 1.1.15 → 1.2.16

package/dist/date/createOrThrow.mjs

@@ -0,0 +1,49 @@
+import { kindHeritage } from '../common/kind.mjs';
+import '../common/stringToBytes.mjs';
+import '../common/stringToMillisecond.mjs';
+import { unwrap } from '../common/unwrap.mjs';
+import '../common/globalStore.mjs';
+import '../common/builder.mjs';
+import '../either/bool/falsy.mjs';
+import '../either/bool/truthy.mjs';
+import '../either/bool/base.mjs';
+import '../either/left/create.mjs';
+import '../either/left/error.mjs';
+import '../either/left/fail.mjs';
+import { isLeft } from '../either/left/is.mjs';
+import '../either/right/success.mjs';
+import '../either/kind.mjs';
+import '../either/right/create.mjs';
+import '../either/right/ok.mjs';
+import '../either/future/success.mjs';
+import '../either/future/error.mjs';
+import '../either/future/base.mjs';
+import '../either/nullable/empty.mjs';
+import '../either/nullable/filled.mjs';
+import '../either/nullable/base.mjs';
+import '../either/nullish/empty.mjs';
+import '../either/nullish/filled.mjs';
+import '../either/nullish/base.mjs';
+import '../either/optional/empty.mjs';
+import '../either/optional/filled.mjs';
+import '../either/optional/base.mjs';
+import '../common/override.mjs';
+import { createErrorKind } from '../common/errorKindNamespace.mjs';
+import { create } from './create.mjs';
+
+class CreateTheDateError extends kindHeritage("create-the-date-error", createErrorKind("create-the-date-error"), Error) {
+    input;
+    constructor(input) {
+        super({}, [`Invalid input: ${input.toString()}`]);
+        this.input = input;
+    }
+}
+function createOrThrow(input) {
+    const result = create(input);
+    if (isLeft(result)) {
+        throw new CreateTheDateError(input);
+    }
+    return unwrap(result);
+}
+
+export { CreateTheDateError, createOrThrow };

package/dist/date/each.cjs

@@ -0,0 +1,47 @@
+'use strict';
+
+var loop = require('../generator/loop.cjs');
+var constants = require('./constants.cjs');
+var toTimestamp = require('./toTimestamp.cjs');
+var createOrThrow = require('./createOrThrow.cjs');
+
+const stepMapper = {
+    millisecond: (timestamp, direction) => timestamp + direction,
+    second: (timestamp, direction) => timestamp + (direction * constants.millisecondsInOneSecond),
+    minute: (timestamp, direction) => timestamp + (direction * constants.millisecondInOneMinute),
+    hour: (timestamp, direction) => timestamp + (direction * constants.millisecondInOneHour),
+    day: (timestamp, direction) => timestamp + (direction * constants.millisecondsInOneDay),
+    month: (timestamp, direction) => {
+        const date = new Date(timestamp);
+        date.setUTCMonth(date.getUTCMonth() + direction);
+        return date.getTime();
+    },
+    year: (timestamp, direction) => {
+        const date = new Date(timestamp);
+        date.setUTCFullYear(date.getUTCFullYear() + direction);
+        return date.getTime();
+    },
+};
+function each(range, unit = "day") {
+    const startTimestamp = toTimestamp.toTimestamp(range.start);
+    const endTimestamp = toTimestamp.toTimestamp(range.end);
+    const direction = startTimestamp <= endTimestamp ? 1 : -1;
+    const advanceTimestamp = stepMapper[unit];
+    return loop.loop(({ exit, next, previousOutput, }) => {
+        if (!previousOutput) {
+            return next(range.start);
+        }
+        const currentTimestamp = advanceTimestamp(toTimestamp.toTimestamp(previousOutput), direction);
+        const isWithinRange = direction === 1
+            ? currentTimestamp < endTimestamp
+            : currentTimestamp > endTimestamp;
+        if (!isWithinRange) {
+            return exit(currentTimestamp === endTimestamp
+                ? createOrThrow.createOrThrow(currentTimestamp)
+                : undefined);
+        }
+        return next(createOrThrow.createOrThrow(currentTimestamp));
+    });
+}
+
+exports.each = each;

package/dist/date/each.d.ts

@@ -0,0 +1,5 @@
+import type { TheDate, Unit } from "./types";
+export declare function each(range: {
+    start: TheDate;
+    end: TheDate;
+}, unit?: Unit): Generator<`date${number}-` | `date${number}+`, unknown, unknown>;

package/dist/date/each.mjs

@@ -0,0 +1,45 @@
+import { loop } from '../generator/loop.mjs';
+import { millisecondsInOneDay, millisecondInOneHour, millisecondInOneMinute, millisecondsInOneSecond } from './constants.mjs';
+import { toTimestamp } from './toTimestamp.mjs';
+import { createOrThrow } from './createOrThrow.mjs';
+
+const stepMapper = {
+    millisecond: (timestamp, direction) => timestamp + direction,
+    second: (timestamp, direction) => timestamp + (direction * millisecondsInOneSecond),
+    minute: (timestamp, direction) => timestamp + (direction * millisecondInOneMinute),
+    hour: (timestamp, direction) => timestamp + (direction * millisecondInOneHour),
+    day: (timestamp, direction) => timestamp + (direction * millisecondsInOneDay),
+    month: (timestamp, direction) => {
+        const date = new Date(timestamp);
+        date.setUTCMonth(date.getUTCMonth() + direction);
+        return date.getTime();
+    },
+    year: (timestamp, direction) => {
+        const date = new Date(timestamp);
+        date.setUTCFullYear(date.getUTCFullYear() + direction);
+        return date.getTime();
+    },
+};
+function each(range, unit = "day") {
+    const startTimestamp = toTimestamp(range.start);
+    const endTimestamp = toTimestamp(range.end);
+    const direction = startTimestamp <= endTimestamp ? 1 : -1;
+    const advanceTimestamp = stepMapper[unit];
+    return loop(({ exit, next, previousOutput, }) => {
+        if (!previousOutput) {
+            return next(range.start);
+        }
+        const currentTimestamp = advanceTimestamp(toTimestamp(previousOutput), direction);
+        const isWithinRange = direction === 1
+            ? currentTimestamp < endTimestamp
+            : currentTimestamp > endTimestamp;
+        if (!isWithinRange) {
+            return exit(currentTimestamp === endTimestamp
+                ? createOrThrow(currentTimestamp)
+                : undefined);
+        }
+        return next(createOrThrow(currentTimestamp));
+    });
+}
+
+export { each };

package/dist/date/getters/getDayOfMonth.cjs

@@ -0,0 +1,47 @@
+'use strict';
+
+require('../types/timezone.cjs');
+require('../../either/bool/falsy.cjs');
+require('../../either/bool/truthy.cjs');
+require('../../either/bool/base.cjs');
+require('../../either/left/create.cjs');
+require('../../either/left/error.cjs');
+require('../../either/left/fail.cjs');
+require('../../either/kind.cjs');
+require('../../common/stringToBytes.cjs');
+require('../../common/stringToMillisecond.cjs');
+require('../../common/globalStore.cjs');
+require('../../common/builder.cjs');
+require('../../common/override.cjs');
+require('../../either/right/success.cjs');
+require('../../either/right/create.cjs');
+require('../../either/right/ok.cjs');
+require('../../either/future/success.cjs');
+require('../../either/future/error.cjs');
+require('../../either/future/base.cjs');
+require('../../either/nullable/empty.cjs');
+require('../../either/nullable/filled.cjs');
+require('../../either/nullable/base.cjs');
+require('../../either/nullish/empty.cjs');
+require('../../either/nullish/filled.cjs');
+require('../../either/nullish/base.cjs');
+require('../../either/optional/empty.cjs');
+require('../../either/optional/filled.cjs');
+require('../../either/optional/base.cjs');
+var toNative = require('../toNative.cjs');
+require('../toTimestamp.cjs');
+require('../createOrThrow.cjs');
+
+function getDayOfMonth(input, timezone = "UTC") {
+    const nativeDate = toNative.toNative(input);
+    if (timezone === "UTC") {
+        return nativeDate.getUTCDate();
+    }
+    const formatter = new Intl.DateTimeFormat("en-US", {
+        timeZone: timezone,
+        day: "numeric",
+    });
+    return Number(formatter.format(nativeDate));
+}
+
+exports.getDayOfMonth = getDayOfMonth;

package/dist/date/getters/getDayOfMonth.d.ts

@@ -0,0 +1,2 @@
+import { type TheDate, type Timezone } from "..";
+export declare function getDayOfMonth<GenericInput extends TheDate>(input: GenericInput, timezone?: Timezone): number;

package/dist/date/getters/getDayOfMonth.mjs

@@ -0,0 +1,45 @@
+import '../types/timezone.mjs';
+import '../../either/bool/falsy.mjs';
+import '../../either/bool/truthy.mjs';
+import '../../either/bool/base.mjs';
+import '../../either/left/create.mjs';
+import '../../either/left/error.mjs';
+import '../../either/left/fail.mjs';
+import '../../either/kind.mjs';
+import '../../common/stringToBytes.mjs';
+import '../../common/stringToMillisecond.mjs';
+import '../../common/globalStore.mjs';
+import '../../common/builder.mjs';
+import '../../common/override.mjs';
+import '../../either/right/success.mjs';
+import '../../either/right/create.mjs';
+import '../../either/right/ok.mjs';
+import '../../either/future/success.mjs';
+import '../../either/future/error.mjs';
+import '../../either/future/base.mjs';
+import '../../either/nullable/empty.mjs';
+import '../../either/nullable/filled.mjs';
+import '../../either/nullable/base.mjs';
+import '../../either/nullish/empty.mjs';
+import '../../either/nullish/filled.mjs';
+import '../../either/nullish/base.mjs';
+import '../../either/optional/empty.mjs';
+import '../../either/optional/filled.mjs';
+import '../../either/optional/base.mjs';
+import { toNative } from '../toNative.mjs';
+import '../toTimestamp.mjs';
+import '../createOrThrow.mjs';
+
+function getDayOfMonth(input, timezone = "UTC") {
+    const nativeDate = toNative(input);
+    if (timezone === "UTC") {
+        return nativeDate.getUTCDate();
+    }
+    const formatter = new Intl.DateTimeFormat("en-US", {
+        timeZone: timezone,
+        day: "numeric",
+    });
+    return Number(formatter.format(nativeDate));
+}
+
+export { getDayOfMonth };

package/dist/date/getters/getDayOfWeek.cjs

@@ -0,0 +1,57 @@
+'use strict';
+
+require('../types/timezone.cjs');
+require('../../either/bool/falsy.cjs');
+require('../../either/bool/truthy.cjs');
+require('../../either/bool/base.cjs');
+require('../../either/left/create.cjs');
+require('../../either/left/error.cjs');
+require('../../either/left/fail.cjs');
+require('../../either/kind.cjs');
+require('../../common/stringToBytes.cjs');
+require('../../common/stringToMillisecond.cjs');
+require('../../common/globalStore.cjs');
+require('../../common/builder.cjs');
+require('../../common/override.cjs');
+require('../../either/right/success.cjs');
+require('../../either/right/create.cjs');
+require('../../either/right/ok.cjs');
+require('../../either/future/success.cjs');
+require('../../either/future/error.cjs');
+require('../../either/future/base.cjs');
+require('../../either/nullable/empty.cjs');
+require('../../either/nullable/filled.cjs');
+require('../../either/nullable/base.cjs');
+require('../../either/nullish/empty.cjs');
+require('../../either/nullish/filled.cjs');
+require('../../either/nullish/base.cjs');
+require('../../either/optional/empty.cjs');
+require('../../either/optional/filled.cjs');
+require('../../either/optional/base.cjs');
+var toNative = require('../toNative.cjs');
+require('../toTimestamp.cjs');
+require('../createOrThrow.cjs');
+
+const weekdayMapper = {
+    Sunday: 0,
+    Monday: 1,
+    Tuesday: 2,
+    Wednesday: 3,
+    Thursday: 4,
+    Friday: 5,
+    Saturday: 6,
+};
+function getDayOfWeek(input, timezone = "UTC") {
+    const nativeDate = toNative.toNative(input);
+    if (timezone === "UTC") {
+        return nativeDate.getUTCDay();
+    }
+    const formatter = new Intl.DateTimeFormat("en-US", {
+        timeZone: timezone,
+        weekday: "long",
+    });
+    const weekday = formatter.format(nativeDate);
+    return weekdayMapper[weekday];
+}
+
+exports.getDayOfWeek = getDayOfWeek;

package/dist/date/getters/getDayOfWeek.d.ts

@@ -0,0 +1,2 @@
+import { type TheDate, type Timezone } from "..";
+export declare function getDayOfWeek<GenericInput extends TheDate>(input: GenericInput, timezone?: Timezone): number;

package/dist/date/getters/getDayOfWeek.mjs

@@ -0,0 +1,55 @@
+import '../types/timezone.mjs';
+import '../../either/bool/falsy.mjs';
+import '../../either/bool/truthy.mjs';
+import '../../either/bool/base.mjs';
+import '../../either/left/create.mjs';
+import '../../either/left/error.mjs';
+import '../../either/left/fail.mjs';
+import '../../either/kind.mjs';
+import '../../common/stringToBytes.mjs';
+import '../../common/stringToMillisecond.mjs';
+import '../../common/globalStore.mjs';
+import '../../common/builder.mjs';
+import '../../common/override.mjs';
+import '../../either/right/success.mjs';
+import '../../either/right/create.mjs';
+import '../../either/right/ok.mjs';
+import '../../either/future/success.mjs';
+import '../../either/future/error.mjs';
+import '../../either/future/base.mjs';
+import '../../either/nullable/empty.mjs';
+import '../../either/nullable/filled.mjs';
+import '../../either/nullable/base.mjs';
+import '../../either/nullish/empty.mjs';
+import '../../either/nullish/filled.mjs';
+import '../../either/nullish/base.mjs';
+import '../../either/optional/empty.mjs';
+import '../../either/optional/filled.mjs';
+import '../../either/optional/base.mjs';
+import { toNative } from '../toNative.mjs';
+import '../toTimestamp.mjs';
+import '../createOrThrow.mjs';
+
+const weekdayMapper = {
+    Sunday: 0,
+    Monday: 1,
+    Tuesday: 2,
+    Wednesday: 3,
+    Thursday: 4,
+    Friday: 5,
+    Saturday: 6,
+};
+function getDayOfWeek(input, timezone = "UTC") {
+    const nativeDate = toNative(input);
+    if (timezone === "UTC") {
+        return nativeDate.getUTCDay();
+    }
+    const formatter = new Intl.DateTimeFormat("en-US", {
+        timeZone: timezone,
+        weekday: "long",
+    });
+    const weekday = formatter.format(nativeDate);
+    return weekdayMapper[weekday];
+}
+
+export { getDayOfWeek };

package/dist/date/getters/getDayOfYear.cjs

@@ -0,0 +1,64 @@
+'use strict';
+
+require('../types/timezone.cjs');
+require('../../either/bool/falsy.cjs');
+require('../../either/bool/truthy.cjs');
+require('../../either/bool/base.cjs');
+require('../../either/left/create.cjs');
+require('../../either/left/error.cjs');
+require('../../either/left/fail.cjs');
+require('../../either/kind.cjs');
+require('../../common/stringToBytes.cjs');
+require('../../common/stringToMillisecond.cjs');
+require('../../common/globalStore.cjs');
+require('../../common/builder.cjs');
+require('../../common/override.cjs');
+require('../../either/right/success.cjs');
+require('../../either/right/create.cjs');
+require('../../either/right/ok.cjs');
+require('../../either/future/success.cjs');
+require('../../either/future/error.cjs');
+require('../../either/future/base.cjs');
+require('../../either/nullable/empty.cjs');
+require('../../either/nullable/filled.cjs');
+require('../../either/nullable/base.cjs');
+require('../../either/nullish/empty.cjs');
+require('../../either/nullish/filled.cjs');
+require('../../either/nullish/base.cjs');
+require('../../either/optional/empty.cjs');
+require('../../either/optional/filled.cjs');
+require('../../either/optional/base.cjs');
+var toNative = require('../toNative.cjs');
+require('../toTimestamp.cjs');
+require('../createOrThrow.cjs');
+
+function getDayOfYear(input, timezone = "UTC") {
+    const nativeDate = toNative.toNative(input);
+    let year = 0;
+    let month = 0;
+    let day = 0;
+    if (timezone === "UTC") {
+        year = nativeDate.getUTCFullYear();
+        month = nativeDate.getUTCMonth();
+        day = nativeDate.getUTCDate();
+    }
+    else {
+        const parts = new Intl.DateTimeFormat("en-US", {
+            timeZone: timezone,
+            day: "numeric",
+            year: "numeric",
+            month: "numeric",
+        }).formatToParts(nativeDate);
+        const partsMap = new Map(parts.map((part) => [part.type, part.value]));
+        year = Number(partsMap.get("year"));
+        month = Number(partsMap.get("month")) - 1;
+        day = Number(partsMap.get("day"));
+    }
+    const yearStart = Date.UTC(year, 0, 1);
+    const currentDate = Date.UTC(year, month, day);
+    const millisecondsDiff = currentDate - yearStart;
+    const dayOfYear = Math.floor(millisecondsDiff / 86400000) + 1;
+    return dayOfYear;
+}
+
+exports.getDayOfYear = getDayOfYear;

package/dist/date/getters/getDayOfYear.d.ts

@@ -0,0 +1,2 @@
+import { type TheDate, type Timezone } from "..";
+export declare function getDayOfYear<GenericInput extends TheDate>(input: GenericInput, timezone?: Timezone): number;

package/dist/date/getters/getDayOfYear.mjs

@@ -0,0 +1,62 @@
+import '../types/timezone.mjs';
+import '../../either/bool/falsy.mjs';
+import '../../either/bool/truthy.mjs';
+import '../../either/bool/base.mjs';
+import '../../either/left/create.mjs';
+import '../../either/left/error.mjs';
+import '../../either/left/fail.mjs';
+import '../../either/kind.mjs';
+import '../../common/stringToBytes.mjs';
+import '../../common/stringToMillisecond.mjs';
+import '../../common/globalStore.mjs';
+import '../../common/builder.mjs';
+import '../../common/override.mjs';
+import '../../either/right/success.mjs';
+import '../../either/right/create.mjs';
+import '../../either/right/ok.mjs';
+import '../../either/future/success.mjs';
+import '../../either/future/error.mjs';
+import '../../either/future/base.mjs';
+import '../../either/nullable/empty.mjs';
+import '../../either/nullable/filled.mjs';
+import '../../either/nullable/base.mjs';
+import '../../either/nullish/empty.mjs';
+import '../../either/nullish/filled.mjs';
+import '../../either/nullish/base.mjs';
+import '../../either/optional/empty.mjs';
+import '../../either/optional/filled.mjs';
+import '../../either/optional/base.mjs';
+import { toNative } from '../toNative.mjs';
+import '../toTimestamp.mjs';
+import '../createOrThrow.mjs';
+
+function getDayOfYear(input, timezone = "UTC") {
+    const nativeDate = toNative(input);
+    let year = 0;
+    let month = 0;
+    let day = 0;
+    if (timezone === "UTC") {
+        year = nativeDate.getUTCFullYear();
+        month = nativeDate.getUTCMonth();
+        day = nativeDate.getUTCDate();
+    }
+    else {
+        const parts = new Intl.DateTimeFormat("en-US", {
+            timeZone: timezone,
+            day: "numeric",
+            year: "numeric",
+            month: "numeric",
+        }).formatToParts(nativeDate);
+        const partsMap = new Map(parts.map((part) => [part.type, part.value]));
+        year = Number(partsMap.get("year"));
+        month = Number(partsMap.get("month")) - 1;
+        day = Number(partsMap.get("day"));
+    }
+    const yearStart = Date.UTC(year, 0, 1);
+    const currentDate = Date.UTC(year, month, day);
+    const millisecondsDiff = currentDate - yearStart;
+    const dayOfYear = Math.floor(millisecondsDiff / 86400000) + 1;
+    return dayOfYear;
+}
+
+export { getDayOfYear };

package/dist/date/getters/getFirstDayOfMonth.cjs

@@ -0,0 +1,14 @@
+'use strict';
+
+var toNative = require('../toNative.cjs');
+
+function getFirstDayOfMonth(input) {
+    const nativeDate = toNative.toNative(input);
+    nativeDate.setUTCDate(1);
+    nativeDate.setUTCHours(0, 0, 0, 0);
+    const timestamp = nativeDate.getTime();
+    const isNegative = timestamp < 0;
+    return `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`;
+}
+
+exports.getFirstDayOfMonth = getFirstDayOfMonth;

package/dist/date/getters/getFirstDayOfMonth.d.ts

@@ -0,0 +1,2 @@
+import type { TheDate } from "../types";
+export declare function getFirstDayOfMonth(input: TheDate): TheDate;

package/dist/date/getters/getFirstDayOfMonth.mjs

@@ -0,0 +1,12 @@
+import { toNative } from '../toNative.mjs';
+
+function getFirstDayOfMonth(input) {
+    const nativeDate = toNative(input);
+    nativeDate.setUTCDate(1);
+    nativeDate.setUTCHours(0, 0, 0, 0);
+    const timestamp = nativeDate.getTime();
+    const isNegative = timestamp < 0;
+    return `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`;
+}
+
+export { getFirstDayOfMonth };

package/dist/date/getters/getFirstDayOfWeek.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+var toNative = require('../toNative.cjs');
+
+function getFirstDayOfWeek(input) {
+    const nativeDate = toNative.toNative(input);
+    const dayOfWeek = nativeDate.getUTCDay();
+    const daysToMonday = dayOfWeek === 0 ? -6 : 1 - dayOfWeek;
+    nativeDate.setUTCHours(0, 0, 0, 0);
+    nativeDate.setUTCDate(nativeDate.getUTCDate() + daysToMonday);
+    const timestamp = nativeDate.getTime();
+    const isNegative = timestamp < 0;
+    return `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`;
+}
+
+exports.getFirstDayOfWeek = getFirstDayOfWeek;

package/dist/date/getters/getFirstDayOfWeek.d.ts

@@ -0,0 +1,2 @@
+import type { TheDate } from "../types";
+export declare function getFirstDayOfWeek(input: TheDate): TheDate;

package/dist/date/getters/getFirstDayOfWeek.mjs

@@ -0,0 +1,14 @@
+import { toNative } from '../toNative.mjs';
+
+function getFirstDayOfWeek(input) {
+    const nativeDate = toNative(input);
+    const dayOfWeek = nativeDate.getUTCDay();
+    const daysToMonday = dayOfWeek === 0 ? -6 : 1 - dayOfWeek;
+    nativeDate.setUTCHours(0, 0, 0, 0);
+    nativeDate.setUTCDate(nativeDate.getUTCDate() + daysToMonday);
+    const timestamp = nativeDate.getTime();
+    const isNegative = timestamp < 0;
+    return `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`;
+}
+
+export { getFirstDayOfWeek };

package/dist/date/getters/getHour.cjs

@@ -0,0 +1,48 @@
+'use strict';
+
+require('../types/timezone.cjs');
+require('../../either/bool/falsy.cjs');
+require('../../either/bool/truthy.cjs');
+require('../../either/bool/base.cjs');
+require('../../either/left/create.cjs');
+require('../../either/left/error.cjs');
+require('../../either/left/fail.cjs');
+require('../../either/kind.cjs');
+require('../../common/stringToBytes.cjs');
+require('../../common/stringToMillisecond.cjs');
+require('../../common/globalStore.cjs');
+require('../../common/builder.cjs');
+require('../../common/override.cjs');
+require('../../either/right/success.cjs');
+require('../../either/right/create.cjs');
+require('../../either/right/ok.cjs');
+require('../../either/future/success.cjs');
+require('../../either/future/error.cjs');
+require('../../either/future/base.cjs');
+require('../../either/nullable/empty.cjs');
+require('../../either/nullable/filled.cjs');
+require('../../either/nullable/base.cjs');
+require('../../either/nullish/empty.cjs');
+require('../../either/nullish/filled.cjs');
+require('../../either/nullish/base.cjs');
+require('../../either/optional/empty.cjs');
+require('../../either/optional/filled.cjs');
+require('../../either/optional/base.cjs');
+var toNative = require('../toNative.cjs');
+require('../toTimestamp.cjs');
+require('../createOrThrow.cjs');
+
+function getHour(input, timezone = "UTC") {
+    const nativeDate = toNative.toNative(input);
+    if (timezone === "UTC") {
+        return nativeDate.getUTCHours();
+    }
+    const formatter = new Intl.DateTimeFormat("en-US", {
+        timeZone: timezone,
+        hour: "numeric",
+        hour12: false,
+    });
+    return Number(formatter.format(nativeDate));
+}
+
+exports.getHour = getHour;

package/dist/date/getters/getHour.d.ts

@@ -0,0 +1,2 @@
+import { type TheDate, type Timezone } from "..";
+export declare function getHour<GenericInput extends TheDate>(input: GenericInput, timezone?: Timezone): number;