Mastering Date and Time in JavaScript with moment-date-utils

Working with dates and times in JavaScript can be daunting, but the moment-date-utils npm package simplifies these operations with an extensive set of utilities. Whether you need to format dates, calculate time differences, or manipulate date ranges, this package has got you covered.

Installation

First, install the package via npm:

npm install moment-date-utils

Features and Functions

The moment-date-utils package provides a wide range of functions to handle various date and time operations. Let's dive into some of the key functionalities:

Formatting Dates and Times

• formatDate(date, format): Formats a date according to the specified format.
• formatTime(time, format): Formats a time according to the specified format.
• formatDateTime(dateTime, format): Formats both date and time.
• formatCustom(dateTime, customFormat): Allows for custom date and time formatting.

Retrieving Date Ranges

• getLast7Days(): Returns an array of the last 7 days.
• getLast30Days(): Returns an array of the last 30 days.
• getLast3Months(): Returns an array of the last 3 months.
• getLast7Months(): Returns an array of the last 7 months.

Current Date and Time

• getCurrentMonth(): Returns the current month.
• getCurrentYear(): Returns the current year.
• getCurrentDay(): Returns the current day.
• getCurrentTime(): Returns the current time.
• getRelativeTime(pastDate): Returns the relative time from a past date to now.
• getCurrentTimeInTimeZone(timeZone): Returns the current time in a specified time zone.

Time Zone Utilities

• convertTimeBetweenTimeZones(time, fromTimeZone, toTimeZone): Converts time between time zones.
• getTimeDifferenceBetweenTimeZones(timeZone1, timeZone2): Calculates the time difference between two time zones.
• formatTimeInTimeZone(time, timeZone, format): Formats time in a specified time zone.
• getAllTimeZones(): Returns a list of all time zones.

Date and Time Manipulation

• addTime(date, amount, unit): Adds time to a date.
• subtractTime(date, amount, unit): Subtracts time from a date.
• getStartOf(date, unit): Gets the start of a specified unit (e.g., month, week).
• getEndOf(date, unit): Gets the end of a specified unit.
• getDaysInMonth(month, year): Returns the number of days in a given month and year.

Week and Month Utilities

• isWeekend(date): Checks if a date falls on a weekend.
• getWeekNumber(date): Returns the week number of the year for a given date.
• parseAndFormatISODate(isoDate, format): Parses and formats an ISO date.
• isLeapYear(year): Checks if a year is a leap year.
• getQuarter(date): Returns the quarter of the year for a given date.
• getISOWeek(date): Returns the ISO week of the year for a given date.

Business Days and Holidays

• getBusinessDays(startDate, endDate): Returns the business days between two dates.
• isDaylightSavingTime(date): Checks if a date falls within daylight saving time.
• isHoliday(date, holidays): Checks if a date is a holiday.

Additional Utilities

• calculateAge(birthdate): Calculates age based on birthdate.
• isToday(date): Checks if a date is today.
• isPast(date): Checks if a date is in the past.
• isFuture(date): Checks if a date is in the future.
• doRangesOverlap(range1, range2): Checks if two date ranges overlap.

Practical Examples

Formatting a Date

const { formatDate } = require('moment-date-utils');

const date = new Date();
const formattedDate = formatDate(date, 'YYYY-MM-DD');
console.log(formattedDate); // Outputs: 2024-06-23

Getting the Last 7 Days

const { getLast7Days } = require('moment-date-utils');

const last7Days = getLast7Days();
console.log(last7Days)

Calculating Time Difference Between Time Zones

const { getTimeDifferenceBetweenTimeZones } = require('moment-date-utils');

const timeDifference = getTimeDifferenceBetweenTimeZones('America/New_York', 'Europe/London');
console.log(`Time difference: ${timeDifference} hours`);

Stackademic 🎓

Thank you for reading until the end. Before you go:

• Please consider clapping and following the writer! 👏
• Follow us X | LinkedIn | YouTube | Discord
• Visit our other platforms: In Plain English | CoFeed | Differ
• More content at Stackademic.com