Date & Time Nodes

> Work with dates, timestamps, and time calculations in your flows.

Current Time

The Current Time node returns the current date and time in various formats.

| Input | Type | Description | |-------|------|-------------| | format | Enum | Output format: iso, unix, unix_seconds, date, time, datetime, rfc2822, relative | | timezone | String | Timezone (e.g., Europe/Berlin, America/New_York) |

| Output | Type | Description | |--------|------|-------------| | timestamp | Number | Unix timestamp in milliseconds | | iso | String | ISO 8601 string | | formatted | String | Formatted according to selected format | | date | String | Date only (YYYY-MM-DD) | | time | String | Time only (HH:MM:SS) |

Date Formatter

The Date Formatter node converts a date or timestamp into a specific format.

| Input | Type | Description | |-------|------|-------------| | input | Any | The date value to format (timestamp, ISO string, etc.) | | inputFormat | String | Format of the input (default: auto) | | outputFormat | String | Desired output format (default: YYYY-MM-DD HH:mm:ss) | | timezone | String | Target timezone |

| Output | Type | Description | |--------|------|-------------| | formatted | String | The formatted date string | | timestamp | Number | Unix timestamp | | valid | Boolean | Whether the input was a valid date |

Common format patterns: YYYY (year), MM (month), DD (day), HH (hour), mm (minute), ss (second). For example, DD/MM/YYYY produces 18/03/2026.

Time Difference

The Time Difference node calculates the difference between two dates.

| Input | Type | Description | |-------|------|-------------| | startDate | Any | Start date (timestamp, ISO string, etc.) | | endDate | Any | End date | | unit | Enum | Unit for the main output: milliseconds, seconds, minutes, hours, days, weeks, months, years |

| Output | Type | Description | |--------|------|-------------| | difference | Number | Difference in the selected unit | | milliseconds | Number | Difference in milliseconds | | seconds | Number | Difference in seconds | | minutes | Number | Difference in minutes | | hours | Number | Difference in hours | | days | Number | Difference in days | | humanReadable | String | Human-readable string (e.g., "2 hours, 30 minutes") |

Relative Time

The Relative Time node converts a timestamp into a human-readable relative format like "2 hours ago" or "in 3 days".

| Input | Type | Description | |-------|------|-------------| | timestamp | Any | The date to convert | | locale | String | Language for the output (default: en) |

| Output | Type | Description | |--------|------|-------------| | relative | String | Relative time string (e.g., "5 minutes ago") | | isPast | Boolean | Whether the date is in the past | | isFuture | Boolean | Whether the date is in the future |

What's next?

| Topic | Description | |-------|-------------| | String Nodes | Format and manipulate text | | Conversion Nodes | Convert between data types | | Logic Nodes | Conditional branching based on date values |