/** * Pre-constructed tools for ISO datetime arithmetic, differences, and timezone-aware formatting. * * @module @nhtio/adk/batteries/tools/datetime_math * * @remarks * Pre-constructed bundled tools for the `datetime_math` category. Import individually, the whole * category, or import every tool via `@nhtio/adk/batteries`. */ import { Tool } from "../../../common"; /** * Add or subtract a duration from a date/time. * * @remarks * All duration components (years/months/weeks/days/hours/minutes/seconds) are optional and * combined into a single Duration. Output formatting includes a time component when the input * itself has one or when any sub-day component is non-zero. */ export declare const dateAddTool: Tool; /** * Calculate the difference between two dates/times in a chosen unit. * * @remarks * Result is signed — positive when `to` is after `from`, negative otherwise — but rendered as * `|value| after/before` for readability. Uses luxon's `diff().as(unit)` which respects * calendar arithmetic for months/years. */ export declare const dateDiffTool: Tool; /** * Convert total seconds into a human-readable duration string. * * @remarks * Examples: `3725` → `1 hour, 2 minutes and 5 seconds`. Negative inputs are prefixed with `-`. * Zero seconds returns the literal `0 seconds`. */ export declare const durationFormatTool: Tool;