Date Converter

A versatile JavaScript library for converting Date objects into human-readable, beautifully formatted date strings. Easily integrate it into your projects and applications to display dates in a more user-friendly way.

Installation

To install the date2word library, you can use npm or yarn or pnpm:

npm install @nexisltd/date2word
# or
yarn add @nexisltd/date2word
# or
pnpm install @nexisltd/date2word

Usage

Here's how you can use the library in your JavaScript or TypeScript code:

import dateConverter from '@nexisltd/date2word';

const myDate = new Date();
const formattedDate = dateConverter(myDate,{});

console.log(formattedDate);

The dateConverter function takes a Date object and provides a variety of formatting options. You can capitalize the month and year, choose between displaying the date or the month first, and more.

Features

• Customizable: Tailor the date format to your needs by specifying various options.
• Human-Readable: The library converts dates into user-friendly, natural language strings.
• Month and Year Formatting: Control the capitalization of the month and year.
• Date Order: Choose whether to display the date or month first in the output.

Example

import dateConverter from '@nexisltd/date2word';

const myDate = new Date('2023-10-15');
const formattedDate = dateConverter(myDate, {
  isCapitalized: true, // Capitalize the month and year
  isDateFirst: true,   // Display the date before the month
});

console.log(formattedDate); // Outputs "Fifteenth October, Twenty Twenty-Three"

Options

• isCapitalized (boolean, optional): Capitalize the month and year in the output. Default is true.
• isDateFirst (boolean, optional): Choose whether to display the date or month first. Default is true.

Acknowledgments

This library relies on the fantastic number-to-words package for converting numbers to words. Kudos to their team for their excellent work.

License

This library is open-source and available under the MIT License.

Feel free to use this library to enhance the date formatting in your projects, and if you have any questions or suggestions, don't hesitate to open an issue or contribute to its development.

Happy coding! 📅🚀