date

Comprehensive date and time manipulation utilities with support for multiple formats, locales, and timezone handling.

Functions

Function	Description	Example
days	Returns array of day names in specified language	dphelper.date.days('en')
months	Returns array of month names in specified language	dphelper.date.months('en')
year	Returns current year	dphelper.date.year()
toIso	Converts date to ISO format (localized)	dphelper.date.toIso(value, 'en')
toMMDDYYYY	Converts to MMDDYYYY format	dphelper.date.toMMDDYYYY(value)
toYYYYMMDD	Converts to YYYYMMDD format (database-friendly)	dphelper.date.toYYYYMMDD(value)
toHuman	Converts to human-readable format	dphelper.date.toHuman(value)
convert	Converts date between formats using month array	dphelper.date.convert(value, format)
iso2Epoch	Converts ISO date to epoch milliseconds	dphelper.date.iso2Epoch(value)
localIsoTime	Gets local ISO time for a date	dphelper.date.localIsoTime(value)
utc	Gets current UTC time string	dphelper.date.utc()
parse	Parses date with custom separator	dphelper.date.parse(value, '/')
addDays	Adds days to a date	dphelper.date.addDays(date, 5)
dateTimeToString	Converts date to formatted string	dphelper.date.dateTimeToString(date)
isoToHuman	Converts ISO to human format with time	dphelper.date.isoToHuman(value, '@')
fullDate	Returns DD-MM-YYYY HH:MM:SS format	dphelper.date.fullDate()
epoch	Returns current epoch time in milliseconds	dphelper.date.epoch()
diffInDays	Calculates difference between two dates in days	dphelper.date.diffInDays(d1, d2)
diffInWeeks	Calculates difference between two dates in weeks	dphelper.date.diffInWeeks(d1, d2)
diffInMonths	Calculates difference between two dates in months	dphelper.date.diffInMonths(d1, d2)
diffInYears	Calculates difference between two dates in years	dphelper.date.diffInYears(d1, d2)
dateToYMD	Converts date to YYYY-MM-DD format	dphelper.date.dateToYMD(date)
collection	Returns various date format representations	dphelper.date.collection({ type: 'toISOString' })
timeZones	Returns array of all supported timezones	dphelper.date.timeZones()

Description

Complete date manipulation library providing:

• Format Conversion - ISO, MMDDYYYY, YYYYMMDD, human-readable

• Localization - Multi-language day/month names

• Timezone Support - UTC, local time, timezone list

• Date Arithmetic - Add days, calculate differences

• Epoch/Unix Time - Convert to/from milliseconds

• Date Collections - Multiple format representations

Usage Examples

Getting Current Date Information

// Get current year
console.log(dphelper.date.year()); // 2026

// Get current UTC time
console.log(dphelper.date.utc()); // "Mon, 02 Mar 2026 09:44:55 GMT"

// Get full date and time
console.log(dphelper.date.fullDate()); // "02-03-2026 09:44:55"

// Get current epoch time
console.log(dphelper.date.epoch()); // 1709375095000

// Get supported timezones
console.log(dphelper.date.timeZones()); // ["Africa/Abidjan", "America/Adak", ...]

Format Conversions

const date = new Date('2026-03-15T10:30:00Z');

// To ISO format (localized)
console.log(dphelper.date.toIso(date, 'en'));  // "March 15, 2026"
console.log(dphelper.date.toIso(date, 'it'));  // "15 marzo 2026"

// To MMDDYYYY
console.log(dphelper.date.toMMDDYYYY(date)); // "03152026"

// To YYYYMMDD (database format)
console.log(dphelper.date.toYYYYMMDD(date)); // "20260315"

// To human readable
console.log(dphelper.date.toHuman(date)); // "Sunday, March 15, 2026"

// To YYYY-MM-DD
console.log(dphelper.date.dateToYMD(date)); // "2026-03-15"

// ISO to human with custom separator
console.log(dphelper.date.isoToHuman('2026-03-15T14:30:00', '@'));
// "15 March 2026 @ 14:30"

Date Parsing

// Parse date with custom separator
console.log(dphelper.date.parse('03152026', '/')); // "03/15/2026"
console.log(dphelper.date.parse('15.03.2026', '.')); // "15.03.2026"

// Convert between formats using month array
const months = dphelper.date.months('en');
console.log(dphelper.date.convert('03152026', months)); // "15 March 2026"

Date Arithmetic

const today = new Date('2026-03-15');

// Add days to a date
const nextWeek = dphelper.date.addDays(today, 7);
console.log(nextWeek); // Date object for 2026-03-22

const lastMonth = dphelper.date.addDays(today, -30);
console.log(lastMonth); // Date object for 2026-02-13

Date Differences

const date1 = new Date('2026-01-01');
const date2 = new Date('2026-03-15');

// Calculate differences
console.log(dphelper.date.diffInDays(date1, date2));   // 73 days
console.log(dphelper.date.diffInWeeks(date1, date2)); // 10 weeks
console.log(dphelper.date.diffInMonths(date1, date2)); // 2 months
console.log(dphelper.date.diffInYears(date1, date2));  // 0 years

// Calculate age
const birthDate = new Date('1990-05-20');
const now = new Date();
const age = dphelper.date.diffInYears(birthDate, now);
console.log(age); // 35 (approximately)

Epoch/Unix Time Conversion

const isoDate = '2026-03-15T10:30:00Z';

// ISO to epoch (milliseconds)
console.log(dphelper.date.iso2Epoch(isoDate)); // 1778979000000

// Current epoch
console.log(dphelper.date.epoch()); // 1709375095000

// Epoch back to date
const epoch = 1709375095000;
const date = new Date(epoch);
console.log(date.toISOString()); // "2026-03-02T09:44:55.000Z"

Local vs UTC Time

const date = new Date();

// Get local ISO time
console.log(dphelper.date.localIsoTime(date));
// "2026-03-02T02:44:55.123"

// Get UTC time
console.log(dphelper.date.utc());
// "Mon, 02 Mar 2026 09:44:55 GMT"

Date Collection (Multiple Formats)

const date = new Date('2026-03-15T14:30:00');

// Get various representations
console.log(dphelper.date.collection({ date, type: 'toDateString' }));
// "Sun Mar 15 2026"

console.log(dphelper.date.collection({ date, type: 'toISOString' }));
// "2026-03-15T14:30:00.000Z"

console.log(dphelper.date.collection({ date, type: 'toLocaleDateString' }));
// "3/15/2026"

console.log(dphelper.date.collection({ date, type: 'toLocaleString' }));
// "3/15/2026, 7:30:00 AM"

console.log(dphelper.date.collection({ date, type: 'toISOStringShort' }));
// "2026-03-15"

Localization

// Get day names in different languages
console.log(dphelper.date.days('en'));
// ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"]

console.log(dphelper.date.days('it'));
// ["lunedì", "martedì", "mercoledì", "giovedì", "venerdì", "sabato", "domenica"]

// Get month names in different languages
console.log(dphelper.date.months('en'));
// ["January", "February", "March", ...]

console.log(dphelper.date.months('it'));
// ["gennaio", "febbraio", "marzo", ...]

Advanced Usage

Date Range Calculator

function getDateRange(startDate, endDate) {
  const days = dphelper.date.diffInDays(startDate, endDate);
  const weeks = dphelper.date.diffInWeeks(startDate, endDate);
  const months = dphelper.date.diffInMonths(startDate, endDate);

  return { days, weeks, months };
}

const start = new Date('2026-01-01');
const end = new Date('2026-12-31');
console.log(getDateRange(start, end));
// { days: 364, weeks: 52, months: 11 }

Timestamp Logger

function logWithTimestamp(message) {
  const timestamp = dphelper.date.fullDate();
  console.log(`[${timestamp}] ${message}`);
}

logWithTimestamp('Application started');
// [02-03-2026 09:44:55] Application started

Database Date Handler

// Save to database
const dbDate = dphelper.date.toYYYYMMDD(new Date());
console.log(dbDate); // "20260302"

// Read from database
const dbValue = "20260315";
const displayDate = dphelper.date.toHuman(new Date(dbValue));
console.log(displayDate); // "Sunday, March 15, 2026"

Details

• Author: Dario Passariello

• Version: 0.0.2

• Creation Date: 20210101

• Last Modified: 20260220

• Environment: Works in both client and server environments

---

Automatically generated document