@franelfers/date-utils

Utilities for working with simple date format (YYYYMMDD). This package provides tools for converting between JavaScript Date objects and a compact 8-digit date representation.

Setup

npm install @franelfers/date-utils

API

fromSimpleDate(date)

Converts a simple date format (YYYYMMDD) to a JavaScript Date object.

Parameters:

• date: number - The date in simple format (8 digits: YYYYMMDD). Example: 20130109

Returns: Date - A Date object representing the given date

Example:

import { fromSimpleDate } from "@franelfers/date-utils"

const date = fromSimpleDate(20130109)
console.log(date) // Date: January 9, 2013

toSimpleDate(date)

Converts a JavaScript Date object to simple date format (YYYYMMDD).

Parameters:

• date: Date - A Date object to convert

Returns: number - The date as an 8-digit number in format YYYYMMDD

Example:

import { toSimpleDate } from "@franelfers/date-utils"

const date = new Date("2013-01-09")
const simple = toSimpleDate(date)
console.log(simple) // 20130109

parseSimpleDate(date)

Extracts year, month, and day components from a simple date format.

Parameters:

• date: number - A date in simple format (8 digits: YYYYMMDD)

Returns: [number, number, number] - A tuple containing [year, month, day] as separate numbers

Example:

import { parseSimpleDate } from "@franelfers/date-utils"

const [year, month, day] = parseSimpleDate(20130109)
console.log(year, month, day) // 2013, 1, 9

Date Format

The simple date format is an 8-digit number representing YYYYMMDD:

• YYYY - Four-digit year (e.g., 2013)
• MM - Two-digit month (01-12)
• DD - Two-digit day (01-31)

Examples:

• January 9, 2013 → 20130109
• December 25, 2023 → 20231225
• February 29, 2020 (leap year) → 20200229

Features

✅ Convert between JavaScript Date and simple format
✅ Parse date components
✅ Handle leap years and edge cases
✅ Timezone-aware conversion
✅ Full TypeScript support