@lloydjatkinson/date-fns-additional/dist/date-time-format.js

Additional functionality built on date-fns

import { format, isSameDay, subDays } from 'date-fns';
/**
 * Formats a Date using the specified {@link FormatPattern}. Note the similarity to the {@link formatUsingPattern} function.
 * Both functions format the date based on the format pattern, it is simply a choice of whether to use the {@link FormatName} or {@link FormatPattern}.
 * Which function is more appropriate to use depends on the use case.
 * @param { Date } date The date.
 * @param { FormatPattern } pattern The format pattern.
 * @returns { string } The formatted string.
 */
export const formatUsingPattern = (date, pattern) => format(date, pattern);
/**
 * Formats a Date into "twelve hour time". For example, 3:23. This is "h:mm" format from date-fns.
 * @param { Date } date The date.
 * @returns { string } The formatted string.
 */
export const formatAsTwelveHourTime = (date) => formatUsingPattern(date, 'h:mm');
/**
 * Formats a Date into "twelve hour time with period". For example, 3:23 PM. This is "h:mm a" format from date-fns.
 * @param { Date } date The date.
 * @returns { string } The formatted string.
 */
export const formatAsTwelveHourTimeWithPeriod = (date) => formatUsingPattern(date, 'h:mm a');
/**
 * Formats a Date into "twenty four hour time". For example, 3:23. This is "HH:mm" format from date-fns.
 * @param { Date } date The date.
 * @returns { string } The formatted string.
 */
export const formatAsTwentyFourHourTime = (date) => formatUsingPattern(date, 'HH:mm');
/**
 * Formats a Date into "month name with day number". For example, October 21. This is "LLLL d" format from date-fns.
 * @param { Date } date The date.
 * @returns { string } The formatted string.
 */
export const formatAsMonthNameWithDayNumber = (date) => formatUsingPattern(date, 'LLLL d');
/**
 * Formats a Date into "month name with day number". For example, October 21. This is "PPP" format from date-fns.
 * @param { Date } date The date.
 * @returns { string } The formatted string.
 */
export const formatAsMonthNameWithOrdinalDate = (date) => formatUsingPattern(date, 'PPP');
/**
 * Formats a Date into "date month year and with twelve hour time". For example, 13/05/2021 - 03:50 PM
 * @param { Date } date The date.
 * @returns { string } The formatted string.
 */
export const formatAsDateMonthYearAndTwelveHourTimeWithPeriod = (date) => formatUsingPattern(date, 'dd/MM/yyyy - hh:mm a');
/**
 * Formats a Date into "date in ISO format without the time". For example, 2022-11-29.
 * @param { Date } date The date.
 * @returns { string } The formatted string.
 */
export const formatAsIsoDate = (date) => formatUsingPattern(date, 'yyyy-MM-dd');
/**
 * Formats a Date into "relative date". For example, a date that is today would be formatted as "Today".
 * @example
 * formatAsRelativeDate(new Date(2020, 10, 21), new Date(2020, 10, 21)) // Today
 * formatAsRelativeDate(new Date(2020, 10, 20), new Date(2020, 10, 21)) // Yesterday
 * formatAsRelativeDate(new Date(2020, 10, 19), new Date(2020, 10, 21)) // October 19
 * @param { Date } date The date.
 * @param { Date } baseDate The date from which to calculate the relative formatting.
 * @returns { string } The formatted string.
 */
export const formatAsRelativeDate = (date, baseDate) => {
    if (isSameDay(date, baseDate)) {
        return 'Today';
    }
    const daysAgo = 1;
    const yesterday = subDays(baseDate, daysAgo);
    if (isSameDay(date, yesterday)) {
        return 'Yesterday';
    }
    return formatAsMonthNameWithDayNumber(date);
};
/**
 * Formats a Date using the specified {@link FormatName}. Note the similarity to the {@link formatUsingPattern} function.
 * This function is a convenient wrapper around {@link formatUsingPattern} that provides the ability to format based on {@link FormatName}.
 * Both functions format the date based on the format pattern, it is simply a choice of whether to use the {@link FormatName} or {@link FormatPattern}.
 * Which function is more appropriate to use depends on the use case.
 * @param { Date } date The date.
 * @param { FormatPattern } pattern The format pattern.
 * @returns { string } The formatted string.
 */
export const formatUsingName = (date, formatName) => {
    const lookup = {
        'twelve-hour-time': 'h:mm',
        'twelve-hour-time-with-period': 'h:mm a',
        'twenty-four-hour-time': 'HH:mm',
        'month-name-with-day-number': 'LLLL d',
        'month-name-with-ordinal-date': 'PPP',
        'month-with-year': 'MMMM yyyy',
        'date-month-year-and-twelve-hour-time-with-period': 'dd/MM/yyyy - hh:mm a',
        'date-year-month-date': 'yyyy-MM-dd',
        'year': 'yyyy',
    };
    if (formatName === 'relative') {
        return formatAsRelativeDate(date, new Date());
    }
    return formatUsingPattern(date, lookup[formatName]);
};