diff-ymd-package

diff-ymd-package

diff-ymd-package a javascript package provides APIs to difference dates in formatted ways(like (aYears bMonths cDays) or (aY bM cD) etc., eg. age = 20Y 2M 23D or datesDifference = 2Years 11Months 20Days) or customized formats like aY-bM-cD or aYears-bMonths-cDays etc.

Installation

Install from npm registry

npm install diff-ymd-package

Install from Github Packages registry

npm install @farhan7reza7/diff-ymd-package

Usage

//const DatesYMD = require('@farhan7reza7/diff-ymd-package'); or

const DatesYMD = require('diff-ymd-package'); // can use any

const date1 = '2022-01-01';
const date2 = '2023-12-31';

const Formatter = new DatesYMD(date1, date2);

const result = Formatter.formattedYMD();
const resultArray = Formatter.diffArray();

console.log(result); // Output: "1Y 11M 30D"
// formatted output in aY bM cD format

console.log(resultArray); // Output: [1, 11, 30, '1Y 11M 30D']
/* you can access each of Y, M, D separately from output array and can format as per your choice like aY-bM-cD or aYears-bMonths-cDays etc.*/

/*example: 
let Y, M, D;

Y = resultArray[0];
M = resultArray[1];
D = resultArray[2];

const customFormat = Y + 'years ' + M + 'months ' + D + 'days';
console.log(customFormat); // output: 1years 11months 30days
*/

// you can use this method for creating format of your choice
const customizedFormat = Formatter.customizeFormat('Ys', 'Ms', 'Ds', '-');

console.log(customizedFormat); // Output: "1Ys-2Ms-2Ds"

API Documentation

DatesYMD

Represents a utility class for calculating the formatted and customized difference between two dates in all cases.

Create an instance of DatesYMD:

const Formatter = new DatesYMD(firstDate, secondDate);

• firstDate: The first date in the format 'yyyy-mm-dd' or 'yyyy/mm/dd' or 'yyyy.mm.dd'.
• secondDate: The second date in the format 'yyyy-mm-dd' or 'yyyy/mm/dd' or 'yyyy.mm.dd'.

Methods:

diffArray Calculates the difference between two dates and returns an array containing Y(years), M(months), D(days), and a formatted 'aY bM cD' difference string.

const result = Formatter.diffArray();

• Returns: An array containing the calculated years, months, days, and the formatted difference.

formattedYMD() Returns the formatted difference between two dates in aY bM cD(aYears bMonths cDays) format.

const result = Formatter.formattedYMD();

• Returns: A string in the format 'aY bM cD'.

customizeFormat(yearUnit, monthUnit, dayUnit, partSeparator) Customizes the difference using specified units and separators

const result = Formatter.customizeFormat(
  yearUnit,
  monthUnit,
  dayUnit,
  partSeparator,
);

• Returns: A customized formatted difference string of form (a + yearUnit + partSeparator + b + monthUnit + partSeparator + c + dayUnit), eg. aYs-bMs-cDs etc.

For more informations, See diff-ymd-package documentation

Contributing

If you find any issues or have suggestions for improvement, please open an issue or create a pull request on the GitHub repository.

See CONTRIBUTING.md for more informations.

Best Practices:

The code adheres to recommended practices for readability and maintainability, including:

• Meaningful variable and function names for clarity.
• Clear and concise comments to enhance understanding.
• Proper indentation and formatting for visual organization.

License

This project is licensed under the MIT License - see the LICENSE file for details.

See License

History

For more details about what has changed in each version of this project.
See CHANGELOG.md.

Changelog

[v1.1.0]

Added

• Improved handling of customized formatting.
• Includes method for creating customized differrence formats.
• Included Unit test using Jest for customizing method.
• Included through comments in tests script

Changed

• Included through comments in tests script

Fixed

fixed some issues and configured files for publishing diff-ymd-package v1.1.0 on npm registry