tpmjs/packages/tools/official/date-parse
Ajax Davis 5926373be6 chore: update ai package to 6.0.49 across all packages
- Updated all packages from ai@6.0.23 to ai@6.0.49
- Added pnpm override to ensure consistent version
- Created changeset for publishing affected packages
2026-01-25 11:33:03 +10:00
..
src feat: add 100+ official TPMJS tools 2025-12-31 22:55:56 +10:00
CHANGELOG.md chore: version packages 2025-12-31 23:54:47 +10:00
package.json chore: update ai package to 6.0.49 across all packages 2026-01-25 11:33:03 +10:00
README.md feat: add 100+ official TPMJS tools 2025-12-31 22:55:56 +10:00
tsconfig.json feat: add 100+ official TPMJS tools 2025-12-31 22:55:56 +10:00
tsup.config.bundled_ko2hafosm0g.mjs feat: add use cases marketing product with AI-generated content 2026-01-20 16:17:35 +10:00
tsup.config.ts feat: add 100+ official TPMJS tools 2025-12-31 22:55:56 +10:00

@tpmjs/tools-date-parse

Parse dates in various natural language formats using chrono-node.

Installation

npm install @tpmjs/tools-date-parse

Usage

import { dateParseTool } from '@tpmjs/tools-date-parse';

const result = await dateParseTool.execute({
  text: 'Meeting tomorrow at 3pm and follow-up next Friday'
});

console.log(result.count);
// => 2

console.log(result.dates[0]);
// => {
//   parsed: "Thursday, January 16, 2025 at 3:00:00 PM EST",
//   original: "tomorrow at 3pm",
//   iso: "2025-01-16T20:00:00.000Z",
//   timestamp: 1737057600000
// }

Options

// Use a custom reference date
const result = await dateParseTool.execute({
  text: 'in 2 weeks',
  referenceDate: '2024-01-01T00:00:00Z'
});

// Use strict mode for fewer false positives
const result = await dateParseTool.execute({
  text: 'The year 2024 was great',
  strict: true
});

Features

  • Natural language: Parses dates like "tomorrow", "next week", "in 3 days"
  • Absolute dates: Handles "December 25th, 2024", "Jan 1", "2024-01-15"
  • Times: Supports "3pm", "15:30", "9:00 AM"
  • Multiple dates: Extracts all dates from a single text input
  • Reference dates: Calculate relative dates from a custom starting point
  • Strict mode: Reduce false positives with stricter parsing

License

MIT