Skip to content

Main content

Random Date Generator Source Code

Browse the implementation files for Random Date Generator.
tool.ts typescript
import { calculateRandomDate } from '@tool.io/tools/random/date';
import type { RandomSource } from '@tool.io/tools/random/number';
import {
	parseCalendarDate,
	type ParsedCalendarDate
} from '../../parse/date/tool';

const currentYear = new Date().getUTCFullYear();
const defaultStartDate = `${currentYear}-01-01`;
const defaultEndDate = `${currentYear}-12-31`;

export const randomDate = (
	startDate: unknown,
	endDate: unknown,
	random: RandomSource = Math.random
): string => {
	const start = parseCalendarDate(startDate);
	const end = parseCalendarDate(endDate);
	if (start === null || end === null) return '';

	return calculateRandomDate(start.iso, end.iso, random) ?? '';
};

export const calculateRandomCalendarDate = (
	start: ParsedCalendarDate,
	end: ParsedCalendarDate,
	random: RandomSource = Math.random
): ParsedCalendarDate | null => {
	const iso = calculateRandomDate(start.iso, end.iso, random);
	return iso === null ? null : parseCalendarDate(iso);
};

export const Tool: TypeTool = {
	name: 'Random Date Generator',
	slug: 'random/date',
	intro:
		'Generate a random calendar date within an inclusive date range.',
	tool: randomDate,
	i: [
		{
			example: defaultStartDate,
			label: 'Start date',
			placeholder: 'YYYY-MM-DD',
			type: 'date',
			value: defaultStartDate
		},
		{
			example: defaultEndDate,
			label: 'End date',
			placeholder: 'YYYY-MM-DD',
			type: 'date',
			value: defaultEndDate
		}
	],
	o: [
		{
			example: '2026-07-22',
			label: 'Random date',
			placeholder: 'Random date',
			render: 'textarea',
			type: 'text'
		}
	],
	rerunnable: true,
	alternative: [
		{ title: 'Random Time', url: '/random/time' },
		{ title: 'Random Timestamp', url: '/random/timestamp' }
	],
	cite: [
		{
			title: 'Calendar date - Wikipedia',
			url: 'https://en.wikipedia.org/wiki/Calendar_date'
		}
	]
};

export default Tool;

Description

Browse the implementation files for Random Date Generator.

References

  1. Tool.io on GitHub
  2. Tool.io TypeScript tools library

Similar or alternative tools