bd-date-utils

বাংলাদেশি তারিখ, সময় এবং সংখ্যাকে React কিংবা যেকোনো জাভাস্ক্রিপ্ট প্রোজেক্টে সহজে দেখানোর জন্য তৈরি হালকা একটি ইউটিলিটি প্যাকেজ।

Lightweight Bangladeshi date helpers that lean on modern Intl APIs, export TypeScript types out of the box, and work identically in React, Next.js, Vite, or vanilla JS apps.

✨ Features

• Locale-aware formatting with sensible defaults for bn-BD & Asia/Dhaka
• Ready-made helpers for React (formatForReact) plus plain functions
• Convert English digits to Bangla numerals everywhere with one flag
• Calendar-friendly breakdowns (toBanglaDateParts, toBanglaCalendarDate)
• Relative time strings powered by Intl.RelativeTimeFormat
• Fully typed TypeScript API, bundles ship as both ESM and CJS

📦 Installation

npm install bd-date-utils
# বা
yarn add bd-date-utils

🚀 Quick start

import {
  formatBanglaDate,
  formatBanglaDateTime,
  relativeTimeFromNow
} from "bd-date-utils";

formatBanglaDate(new Date()); // "১৫ নভেম্বর, ২০২৫"
formatBanglaDateTime("2025-12-01T10:30:00Z"); // "১ ডিসেম্বর, ২০২৫, ৪:৩০ PM"
relativeTimeFromNow("2025-11-20"); // "৫ দিনের মধ্যে"

⚛️ React example

import { formatForReact } from "bd-date-utils";

export function PaymentDue({ dueDate }: { dueDate: string }) {
  const date = formatForReact(dueDate, {
    timeStyle: "short"
  });

  return (
    <time dateTime={date.machineValue} aria-label={date.ariaLabel}>
      {date.day} {date.month}, {date.year}
    </time>
  );
}

formatForReact returns:

{
  iso: string;
  localeString: string;
  day: string;
  month: string;
  monthNumber: string;
  year: string;
  weekday: string;
  ariaLabel: string;
  machineValue: string;
}

🧰 API overview

| Helper | What it does | | --- | --- | | formatBanglaDate(date?, options?) | Formats any date in Bangla using dateStyle (long by default). | | formatBanglaDateTime(date?, options?) | Includes timeStyle (defaults to short). | | getBanglaMonthName(input?, opts?) | Month name from a Date, timestamp, ISO string, or month index. | | getBanglaWeekdayName(date?) | Bangla weekday (রবিবার ... শনিবার). | | toBanglaDateParts(date?, options?) | Returns { weekday, day, monthName, monthNumber, year }. | | toBanglaCalendarDate(date?, options?) | Rich object perfect for calendars/detail cards. | | relativeTimeFromNow(target, options?) | Human friendly phrases like "২ দিন আগে". | | convertToBanglaDigits(value) | Converts any digits to Bangla numerals. | | ensureBanglaDigits(record) | Mass-convert every string/number value in an object. | | formatForReact(date?, options?) | Convenience wrapper that adds ariaLabel + machineValue. |

Common options

All formatters share a common subset of options:

| Option | Type | Default | Notes | | --- | --- | --- | --- | | locale | string | "bn-BD" | Use a different locale but still keep Bangla digits if you want. | | timeZone | string | "Asia/Dhaka" | Override when rendering from other regions. | | dateStyle | "full" \| "long" \| "medium" \| "short" | "long" | Passed through to Intl.DateTimeFormat. | | timeStyle | Same as dateStyle | "short" for formatBanglaDateTime | Controls the time portion. | | weekday | "long" \| "short" \| "narrow" | undefined | Include weekday in the formatted string. | | useBanglaDigits | boolean | true | Turn off if you want English numerals with Bangla labels. |

Relative time options

relativeTimeFromNow(target, {
  baseDate?: Date | string | number;
  locale?: string; // defaults to "bn"
  numeric?: "always" | "auto"; // "auto" => "গতকাল", "আগামীকাল"
  style?: "long" | "short" | "narrow";
});

🛠 Development scripts

• npm run build – bundles ESM + CJS outputs with type declarations.
• npm run dev – watch mode while iterating on helpers.
• npm run typecheck – strict TypeScript diagnostics without emitting files.

📄 License

MIT © Kawsar Ahmed