NaturalLanguage

Parse human-friendly date strings

Import

import { ... } from 'ts-time-utils/naturalLanguage';

Examples

Natural Date Parsing

Parse dates from natural language

import { parseNaturalDate, extractDatesFromText } from 'ts-time-utils/naturalLanguage';

// Parse natural language
console.log('tomorrow:', parseNaturalDate('tomorrow'));
console.log('next Friday:', parseNaturalDate('next Friday'));
console.log('in 2 weeks:', parseNaturalDate('in 2 weeks'));
console.log('3 days ago:', parseNaturalDate('3 days ago'));
console.log('end of month:', parseNaturalDate('end of month'));

// Extract dates from text
const text = 'Meeting tomorrow at 3pm and lunch next Friday at noon';
const dates = extractDatesFromText(text);

dates.forEach(({ date, text: matched, confidence }) => {
  console.log(`Found "${matched}" -> ${date.toDateString()} (confidence: ${confidence})`);
});