Date / Time
Timestamps, date formatting, parsing, arithmetic, epoch conversion, and comparison nodes.
Date / Time nodes handle temporal operations — getting the current time, formatting dates for display, parsing date strings, computing durations, and converting to and from Unix timestamps.
All Date / Time nodes are pure (blue header, no execution pins).
Now
Get the current date and time.
| Pin | Direction | Type | Description |
|---|---|---|---|
| Date/Time | Output | DateTime | Current UTC date and time |
Pure. Use Now to timestamp events, compute deadlines, or create time-based filenames.
Format Date
Format a date/time value as a human-readable string.
| Pin | Direction | Type | Description |
|---|---|---|---|
| Date | Input | DateTime | The date to format |
| Format | Input | String | Format pattern (default: "YYYY-MM-DD") |
| Result | Output | String | Formatted date string |
Pure. Use Format Date to produce display-friendly timestamps for notifications, reports, or log messages.
Parse Date
Parse a string into a date/time value.
| Pin | Direction | Type | Description |
|---|---|---|---|
| Value | Input | String | The date string to parse |
| Format | Input | String | Expected format pattern (default: auto-detect) |
| Date/Time | Output | DateTime | Parsed date value |
Pure. Use Parse Date to convert date strings from API responses, log entries, or user input into DateTime values for comparison and arithmetic.
Date Add
Add a duration to a date. Supports seconds, minutes, hours, days, weeks, months, and years.
| Pin | Direction | Type | Description |
|---|---|---|---|
| Date | Input | DateTime | The starting date |
| Amount | Input | Float | Duration to add (negative to subtract) |
| Unit | Input | String | Time unit: seconds, minutes, hours, days, weeks, months, years |
| Result | Output | DateTime | Resulting date |
Pure. Use Date Add to calculate deadlines, expiration dates, or lookback windows — "30 days from now", "2 hours ago".
Date Diff
Get the duration between two dates in a specified unit.
| Pin | Direction | Type | Description |
|---|---|---|---|
| A | Input | DateTime | First date |
| B | Input | DateTime | Second date |
| Unit | Input | String | Result unit: seconds, minutes, hours, days, weeks, months, years |
| Result | Output | Float | Duration between A and B |
Pure. Use Date Diff to measure time elapsed — age of an alert, duration of a process, or time since last activity.
Date Component
Extract a single component from a date (year, month, day, hour, minute, second, or day of week).
| Pin | Direction | Type | Description |
|---|---|---|---|
| Date | Input | DateTime | The date to inspect |
| Component | Input | String | Component to extract: year, month, day, hour, minute, second, dayOfWeek |
| Value | Output | Integer | The extracted component value |
Pure. Use Date Component to build schedule logic — check if it is a weekend, extract the hour for business-hours detection.
To Epoch
Convert a date/time value to a Unix timestamp (seconds since 1970-01-01T00:00:00Z).
| Pin | Direction | Type | Description |
|---|---|---|---|
| Date | Input | DateTime | The date to convert |
| Timestamp | Output | Integer | Unix timestamp |
Pure. Use To Epoch for APIs that expect timestamps as integers, or for numeric date comparisons.
From Epoch
Convert a Unix timestamp to a date/time value.
| Pin | Direction | Type | Description |
|---|---|---|---|
| Timestamp | Input | Integer | Unix timestamp |
| Date/Time | Output | DateTime | Converted date/time |
Pure. Use From Epoch to convert integer timestamps from APIs or databases into DateTime values.
Date Compare
Compare two dates. Returns -1 (A before B), 0 (equal), or 1 (A after B).
| Pin | Direction | Type | Description |
|---|---|---|---|
| A | Input | DateTime | First date |
| B | Input | DateTime | Second date |
| Result | Output | Integer | -1, 0, or 1 |
Pure. Use Date Compare for sorting dates or checking chronological order without computing a full diff.
Start Of
Get the start of a time period — the beginning of a day, week, month, or year.
| Pin | Direction | Type | Description |
|---|---|---|---|
| Date | Input | DateTime | The reference date |
| Unit | Input | String | Period: day, week, month, year |
| Result | Output | DateTime | Start of the specified period |
Pure. Use Start Of to align timestamps to period boundaries — query logs from the start of today, calculate monthly totals.
Related categories
- Comparison — compare date-derived values with Greater Than, Less Than
- Type Conversion — convert dates to strings or parse strings to dates
- Math — perform arithmetic on epoch timestamps or durations