feat(Date & Time Node): Overhaul of the node (#5904)

* Setup versionized node

* Fix node naming

* Set all possible actions

* Add Current Date operation

* Add timezone to current date

* feat add to date operator

* Change output field name to camel case

* Fix info box for luxons tip

* Feat subtract to date operation

* Feat format date operation

* Fix to node field for format date

* Feat rounding operation

* Feat get in between date operation

* Feat add extract date operation

* Add generic function for parsing date

* Remove moment methods from operations

* Change moment to luxon for the rest of the operations

* Fix Format date operation

* Fix format value

* Add timezone option for current date

* Add tests, improve workflow settings for testing, toString the results

* Change icon for V2

* Revert "Change icon for V2"

This reverts commit 46b59bea2ec6dd02a22f8d07a9736b42d751d10f.

* Change workflow  test name

* Fix ui bug for custom format

* Fix default value for format operation

* Fix info box for rounding operation

* Change default for units for between time operation

* Inprove fields and resort time units

* Fix extract week number

* Resolve issue with formating and timezones

* Fix field name and unit order

* ⚡ restored removed test case, sync v1 with curent master

* ⚡ parseDate update to support timestamps, tests

* Keep same field for substract and add time

* Update unit test

* Improve visibility, add iso to string option

* Update option naming

---------

Co-authored-by: Michael Kret <michael.k@radency.com>

packages/nodes-base/nodes/DateTime/V2/AddToDateDescription.ts

@@ -0,0 +1,105 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const AddToDateDescription: INodeProperties[] = [
+	{
+		displayName:
+			"You can also do this using an expression, e.g. <code>{{your_date.plus(5, 'minutes')}}</code>. <a target='_blank' href='https://docs.n8n.io/code-examples/expressions/luxon/'>More info</a>",
+		name: 'notice',
+		type: 'notice',
+		default: '',
+		displayOptions: {
+			show: {
+				operation: ['addToDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Date to Add To',
+		name: 'magnitude',
+		type: 'string',
+		description: 'The date that you want to change',
+		default: '',
+		displayOptions: {
+			show: {
+				operation: ['addToDate'],
+			},
+		},
+		required: true,
+	},
+	{
+		displayName: 'Time Unit to Add',
+		name: 'timeUnit',
+		description: 'Time unit for Duration parameter below',
+		displayOptions: {
+			show: {
+				operation: ['addToDate'],
+			},
+		},
+		type: 'options',
+		// eslint-disable-next-line n8n-nodes-base/node-param-options-type-unsorted-items
+		options: [
+			{
+				name: 'Years',
+				value: 'years',
+			},
+			{
+				name: 'Quarters',
+				value: 'quarters',
+			},
+			{
+				name: 'Months',
+				value: 'months',
+			},
+			{
+				name: 'Weeks',
+				value: 'weeks',
+			},
+			{
+				name: 'Days',
+				value: 'days',
+			},
+			{
+				name: 'Hours',
+				value: 'hours',
+			},
+			{
+				name: 'Minutes',
+				value: 'minutes',
+			},
+			{
+				name: 'Seconds',
+				value: 'seconds',
+			},
+			{
+				name: 'Milliseconds',
+				value: 'milliseconds',
+			},
+		],
+		default: 'days',
+		required: true,
+	},
+	{
+		displayName: 'Duration',
+		name: 'duration',
+		type: 'number',
+		description: 'The number of time units to add to the date',
+		default: 0,
+		displayOptions: {
+			show: {
+				operation: ['addToDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Output Field Name',
+		name: 'outputFieldName',
+		type: 'string',
+		default: 'newDate',
+		description: 'Name of the field to put the output in',
+		displayOptions: {
+			show: {
+				operation: ['addToDate'],
+			},
+		},
+	},
+];

packages/nodes-base/nodes/DateTime/V2/CurrentDateDescription.ts

@@ -0,0 +1,63 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const CurrentDateDescription: INodeProperties[] = [
+	{
+		displayName:
+			'You can also refer to the current date in n8n expressions by using <code>{{$now}}</code> or <code>{{$today}}</code>. <a target="_blank" href="https://docs.n8n.io/code-examples/expressions/luxon/">More info</a>',
+		name: 'notice',
+		type: 'notice',
+		default: '',
+		displayOptions: {
+			show: {
+				operation: ['getCurrentDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Include Current Time',
+		name: 'includeTime',
+		type: 'boolean',
+		default: true,
+		description: 'Whether deactivated, the time will be set to midnight',
+		displayOptions: {
+			show: {
+				operation: ['getCurrentDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Output Field Name',
+		name: 'outputFieldName',
+		type: 'string',
+		default: 'currentDate',
+		description: 'Name of the field to put the output in',
+		displayOptions: {
+			show: {
+				operation: ['getCurrentDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Options',
+		name: 'options',
+		type: 'collection',
+		placeholder: 'Add Option',
+		displayOptions: {
+			show: {
+				operation: ['getCurrentDate'],
+			},
+		},
+		default: {},
+		options: [
+			{
+				displayName: 'Timezone',
+				name: 'timezone',
+				type: 'string',
+				placeholder: 'America/New_York',
+				default: '',
+				description:
+					'The timezone to use. If not set, the timezone of the n8n instance will be used. Use ‘GMT’ for +00:00 timezone.',
+			},
+		],
+	},
+];

packages/nodes-base/nodes/DateTime/V2/DateTimeV2.node.ts

@@ -0,0 +1,210 @@
+import type {
+	IDataObject,
+	IExecuteFunctions,
+	INodeExecutionData,
+	INodeType,
+	INodeTypeBaseDescription,
+	INodeTypeDescription,
+} from 'n8n-workflow';
+import { NodeOperationError } from 'n8n-workflow';
+
+import { CurrentDateDescription } from './CurrentDateDescription';
+import { AddToDateDescription } from './AddToDateDescription';
+import { SubtractFromDateDescription } from './SubtractFromDateDescription';
+import { FormatDateDescription } from './FormatDateDescription';
+import { RoundDateDescription } from './RoundDateDescription';
+import { GetTimeBetweenDatesDescription } from './GetTimeBetweenDates';
+import type { DateTimeUnit, DurationUnit } from 'luxon';
+import { DateTime } from 'luxon';
+import { ExtractDateDescription } from './ExtractDateDescription';
+import { parseDate } from './GenericFunctions';
+
+export class DateTimeV2 implements INodeType {
+	description: INodeTypeDescription;
+
+	constructor(baseDescription: INodeTypeBaseDescription) {
+		this.description = {
+			...baseDescription,
+			version: 2,
+			defaults: {
+				name: 'Date & Time',
+				color: '#408000',
+			},
+			inputs: ['main'],
+			outputs: ['main'],
+			properties: [
+				{
+					displayName: 'Operation',
+					name: 'operation',
+					type: 'options',
+					noDataExpression: true,
+					options: [
+						{
+							name: 'Add to a Date',
+							value: 'addToDate',
+						},
+						{
+							name: 'Extract Part of a Date',
+							value: 'extractDate',
+						},
+						{
+							name: 'Format a Date',
+							value: 'formatDate',
+						},
+						{
+							name: 'Get Current Date',
+							value: 'getCurrentDate',
+						},
+						{
+							name: 'Get Time Between Dates',
+							value: 'getTimeBetweenDates',
+						},
+						{
+							name: 'Round a Date',
+							value: 'roundDate',
+						},
+						{
+							name: 'Subtract From a Date',
+							value: 'subtractFromDate',
+						},
+					],
+					default: 'getCurrentDate',
+				},
+				...CurrentDateDescription,
+				...AddToDateDescription,
+				...SubtractFromDateDescription,
+				...FormatDateDescription,
+				...RoundDateDescription,
+				...GetTimeBetweenDatesDescription,
+				...ExtractDateDescription,
+			],
+		};
+	}
+
+	async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
+		const items = this.getInputData();
+		const returnData: INodeExecutionData[] = [];
+		const responseData = [];
+		const operation = this.getNodeParameter('operation', 0);
+		const workflowTimezone = this.getTimezone();
+
+		for (let i = 0; i < items.length; i++) {
+			if (operation === 'getCurrentDate') {
+				const includeTime = this.getNodeParameter('includeTime', i) as boolean;
+				const outputFieldName = this.getNodeParameter('outputFieldName', i) as string;
+				const { timezone } = this.getNodeParameter('options', i) as {
+					timezone: string;
+				};
+
+				const newLocal = timezone ? timezone : workflowTimezone;
+				if (DateTime.now().setZone(newLocal).invalidReason === 'unsupported zone') {
+					throw new NodeOperationError(
+						this.getNode(),
+						`The timezone ${newLocal} is not valid. Please check the timezone.`,
+					);
+				}
+				responseData.push(
+					includeTime
+						? { [outputFieldName]: DateTime.now().setZone(newLocal).toString() }
+						: {
+								[outputFieldName]: DateTime.now().setZone(newLocal).startOf('day').toString(),
+						  },
+				);
+			} else if (operation === 'addToDate') {
+				const addToDate = this.getNodeParameter('magnitude', i) as string;
+				const timeUnit = this.getNodeParameter('timeUnit', i) as string;
+				const duration = this.getNodeParameter('duration', i) as number;
+				const outputFieldName = this.getNodeParameter('outputFieldName', i) as string;
+
+				const dateToAdd = parseDate.call(this, addToDate, workflowTimezone);
+				const returnedDate = dateToAdd.plus({ [timeUnit]: duration });
+				responseData.push({ [outputFieldName]: returnedDate.toString() });
+			} else if (operation === 'subtractFromDate') {
+				const subtractFromDate = this.getNodeParameter('magnitude', i) as string;
+				const timeUnit = this.getNodeParameter('timeUnit', i) as string;
+				const duration = this.getNodeParameter('duration', i) as number;
+				const outputFieldName = this.getNodeParameter('outputFieldName', i) as string;
+
+				const dateToAdd = parseDate.call(this, subtractFromDate, workflowTimezone);
+				const returnedDate = dateToAdd.minus({ [timeUnit]: duration });
+				responseData.push({ [outputFieldName]: returnedDate.toString() });
+			} else if (operation === 'formatDate') {
+				const date = this.getNodeParameter('date', i) as string;
+				const format = this.getNodeParameter('format', i) as string;
+				const outputFieldName = this.getNodeParameter('outputFieldName', i) as string;
+				const { timezone } = this.getNodeParameter('options', i) as { timezone: boolean };
+
+				const dateLuxon = timezone
+					? parseDate.call(this, date, workflowTimezone)
+					: parseDate.call(this, date);
+				if (format === 'custom') {
+					const customFormat = this.getNodeParameter('customFormat', i) as string;
+					responseData.push({
+						[outputFieldName]: dateLuxon.toFormat(customFormat),
+					});
+				} else {
+					responseData.push({
+						[outputFieldName]: dateLuxon.toFormat(format),
+					});
+				}
+			} else if (operation === 'roundDate') {
+				const date = this.getNodeParameter('date', i) as string;
+				const mode = this.getNodeParameter('mode', i) as string;
+				const outputFieldName = this.getNodeParameter('outputFieldName', i) as string;
+
+				const dateLuxon = parseDate.call(this, date, workflowTimezone);
+
+				if (mode === 'roundDown') {
+					const toNearest = this.getNodeParameter('toNearest', i) as string;
+					responseData.push({
+						[outputFieldName]: dateLuxon.startOf(toNearest as DateTimeUnit).toString(),
+					});
+				} else if (mode === 'roundUp') {
+					const to = this.getNodeParameter('to', i) as string;
+					responseData.push({
+						[outputFieldName]: dateLuxon
+							.plus({ [to]: 1 })
+							.startOf(to as DateTimeUnit)
+							.toString(),
+					});
+				}
+			} else if (operation === 'getTimeBetweenDates') {
+				const startDate = this.getNodeParameter('startDate', i) as string;
+				const endDate = this.getNodeParameter('endDate', i) as string;
+				const unit = this.getNodeParameter('units', i) as DurationUnit[];
+				const outputFieldName = this.getNodeParameter('outputFieldName', i) as string;
+				const { isoString } = this.getNodeParameter('options', i) as {
+					isoString: boolean;
+				};
+
+				const luxonStartDate = parseDate.call(this, startDate, workflowTimezone);
+				const luxonEndDate = parseDate.call(this, endDate, workflowTimezone);
+				const duration = luxonEndDate.diff(luxonStartDate, unit);
+				isoString
+					? responseData.push({
+							[outputFieldName]: duration.toString(),
+					  })
+					: responseData.push({
+							[outputFieldName]: duration.toObject(),
+					  });
+			} else if (operation === 'extractDate') {
+				const date = this.getNodeParameter('date', i) as string | DateTime;
+				const outputFieldName = this.getNodeParameter('outputFieldName', i) as string;
+				const part = this.getNodeParameter('part', i) as keyof DateTime | 'week';
+
+				const parsedDate = parseDate.call(this, date, workflowTimezone);
+				const selectedPart = part === 'week' ? parsedDate.weekNumber : parsedDate.get(part);
+				responseData.push({ [outputFieldName]: selectedPart });
+			}
+
+			const executionData = this.helpers.constructExecutionMetaData(
+				this.helpers.returnJsonArray(responseData as IDataObject[]),
+				{
+					itemData: { item: i },
+				},
+			);
+			returnData.push(...executionData);
+		}
+		return this.prepareOutputData(returnData);
+	}
+}

packages/nodes-base/nodes/DateTime/V2/ExtractDateDescription.ts

@@ -0,0 +1,82 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const ExtractDateDescription: INodeProperties[] = [
+	{
+		displayName:
+			'You can also do this using an expression, e.g. <code>{{ your_date.extract("month") }}}</code>. <a target="_blank" href="https://docs.n8n.io/code-examples/expressions/luxon/">More info</a>',
+		name: 'notice',
+		type: 'notice',
+		default: '',
+		displayOptions: {
+			show: {
+				operation: ['extractDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Date',
+		name: 'date',
+		type: 'string',
+		description: 'The date that you want to round',
+		default: '',
+		displayOptions: {
+			show: {
+				operation: ['extractDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Part',
+		name: 'part',
+		type: 'options',
+		// eslint-disable-next-line n8n-nodes-base/node-param-options-type-unsorted-items
+		options: [
+			{
+				name: 'Year',
+				value: 'year',
+			},
+			{
+				name: 'Month',
+				value: 'month',
+			},
+			{
+				name: 'Week',
+				value: 'week',
+			},
+			{
+				name: 'Day',
+				value: 'day',
+			},
+			{
+				name: 'Hour',
+				value: 'hour',
+			},
+			{
+				name: 'Minute',
+				value: 'minute',
+			},
+			{
+				name: 'Second',
+				value: 'second',
+			},
+		],
+		default: 'month',
+		displayOptions: {
+			show: {
+				operation: ['extractDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Output Field Name',
+		name: 'outputFieldName',
+		type: 'string',
+		default: 'datePart',
+		description: 'Name of the field to put the output in',
+		displayOptions: {
+			show: {
+				operation: ['extractDate'],
+			},
+		},
+	},
+];

packages/nodes-base/nodes/DateTime/V2/FormatDateDescription.ts

@@ -0,0 +1,129 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const FormatDateDescription: INodeProperties[] = [
+	{
+		displayName:
+			"You can also do this using an expression, e.g. <code>{{your_date.format('yyyy-MM-dd')}}</code>. <a target='_blank' href='https://docs.n8n.io/code-examples/expressions/luxon/'>More info</a>",
+		name: 'notice',
+		type: 'notice',
+		default: '',
+		displayOptions: {
+			show: {
+				operation: ['formatDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Date',
+		name: 'date',
+		type: 'string',
+		description: 'The date that you want to format',
+		default: '',
+		displayOptions: {
+			show: {
+				operation: ['formatDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Format',
+		name: 'format',
+		type: 'options',
+		displayOptions: {
+			show: {
+				operation: ['formatDate'],
+			},
+		},
+		// eslint-disable-next-line n8n-nodes-base/node-param-options-type-unsorted-items
+		options: [
+			{
+				name: 'Custom Format',
+				value: 'custom',
+			},
+			{
+				name: 'MM/DD/YYYY',
+				value: 'MM/dd/yyyy',
+				description: 'Example: 09/04/1986',
+			},
+			{
+				name: 'YYYY/MM/DD',
+				value: 'yyyy/MM/dd',
+				description: 'Example: 1986/04/09',
+			},
+			{
+				name: 'MMMM DD YYYY',
+				value: 'MMMM dd yyyy',
+				description: 'Example: April 09 1986',
+			},
+			{
+				name: 'MM-DD-YYYY',
+				value: 'MM-dd-yyyy',
+				description: 'Example: 09-04-1986',
+			},
+			{
+				name: 'YYYY-MM-DD',
+				value: 'yyyy-MM-dd',
+				description: 'Example: 1986-04-09',
+			},
+			{
+				name: 'Unix Timestamp',
+				value: 'X',
+				description: 'Example: 1672531200',
+			},
+			{
+				name: 'Unix Ms Timestamp',
+				value: 'x',
+				description: 'Example: 1674691200000',
+			},
+		],
+		default: 'MM/dd/yyyy',
+		description: 'The format to convert the date to',
+	},
+	{
+		displayName: 'Custom Format',
+		name: 'customFormat',
+		type: 'string',
+		displayOptions: {
+			show: {
+				format: ['custom'],
+				operation: ['formatDate'],
+			},
+		},
+		hint: 'List of special tokens <a target="_blank" href="https://moment.github.io/luxon/#/formatting?id=table-of-tokens">More info</a>',
+		default: '',
+		placeholder: 'yyyy-MM-dd',
+	},
+	{
+		displayName: 'Output Field Name',
+		name: 'outputFieldName',
+		type: 'string',
+		default: 'formattedDate',
+		description: 'Name of the field to put the output in',
+		displayOptions: {
+			show: {
+				operation: ['formatDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Options',
+		name: 'options',
+		type: 'collection',
+		placeholder: 'Add Option',
+		displayOptions: {
+			show: {
+				operation: ['formatDate'],
+			},
+		},
+		default: {},
+		options: [
+			{
+				displayName: 'Use Workflow Timezone',
+				name: 'timezone',
+				type: 'boolean',
+				default: false,
+				description: "Whether to use the timezone of the input or the workflow's timezone",
+			},
+		],
+	},
+];

packages/nodes-base/nodes/DateTime/V2/GenericFunctions.ts

@@ -0,0 +1,50 @@
+import { DateTime } from 'luxon';
+import moment from 'moment';
+import type { IExecuteFunctions } from 'n8n-workflow';
+import { NodeOperationError } from 'n8n-workflow';
+
+export function parseDate(
+	this: IExecuteFunctions,
+	date: string | number | DateTime,
+	timezone?: string,
+) {
+	let parsedDate;
+
+	if (date instanceof DateTime) {
+		parsedDate = date;
+	} else {
+		// Check if the input is a number
+		if (!Number.isNaN(Number(date))) {
+			//input is a number, convert to number in case it is a string formatted number
+			date = Number(date);
+			// check if the number is a timestamp in float format and convert to integer
+			if (!Number.isInteger(date)) {
+				date = date * 1000;
+			}
+		}
+
+		if (Number.isInteger(date)) {
+			const timestampLengthInMilliseconds1990 = 12;
+			// check if the number is a timestamp in seconds or milliseconds and create a moment object accordingly
+			if (date.toString().length < timestampLengthInMilliseconds1990) {
+				parsedDate = DateTime.fromSeconds(date as number);
+			} else {
+				parsedDate = DateTime.fromMillis(date as number);
+			}
+		} else {
+			if (!timezone && (date as string).includes('+')) {
+				const offset = (date as string).split('+')[1].slice(0, 2) as unknown as number;
+				timezone = `Etc/GMT-${offset * 1}`;
+			}
+
+			parsedDate = DateTime.fromISO(moment(date).toISOString());
+		}
+
+		parsedDate = parsedDate.setZone(timezone || 'Etc/UTC');
+
+		if (parsedDate.invalidReason === 'unparsable') {
+			throw new NodeOperationError(this.getNode(), 'Invalid date format');
+		}
+	}
+	return parsedDate;
+}

packages/nodes-base/nodes/DateTime/V2/GetTimeBetweenDates.ts

@@ -0,0 +1,105 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const GetTimeBetweenDatesDescription: INodeProperties[] = [
+	{
+		displayName: 'Start Date',
+		name: 'startDate',
+		type: 'string',
+		default: '',
+		displayOptions: {
+			show: {
+				operation: ['getTimeBetweenDates'],
+			},
+		},
+	},
+	{
+		displayName: 'End Date',
+		name: 'endDate',
+		type: 'string',
+		default: '',
+		displayOptions: {
+			show: {
+				operation: ['getTimeBetweenDates'],
+			},
+		},
+	},
+	{
+		displayName: 'Units',
+		name: 'units',
+		type: 'multiOptions',
+		// eslint-disable-next-line n8n-nodes-base/node-param-multi-options-type-unsorted-items
+		options: [
+			{
+				name: 'Year',
+				value: 'year',
+			},
+			{
+				name: 'Month',
+				value: 'month',
+			},
+			{
+				name: 'Week',
+				value: 'week',
+			},
+			{
+				name: 'Day',
+				value: 'day',
+			},
+			{
+				name: 'Hour',
+				value: 'hour',
+			},
+			{
+				name: 'Minute',
+				value: 'minute',
+			},
+			{
+				name: 'Second',
+				value: 'second',
+			},
+			{
+				name: 'Millisecond',
+				value: 'millisecond',
+			},
+		],
+		displayOptions: {
+			show: {
+				operation: ['getTimeBetweenDates'],
+			},
+		},
+		default: ['day'],
+	},
+	{
+		displayName: 'Output Field Name',
+		name: 'outputFieldName',
+		type: 'string',
+		default: 'timeDifference',
+		description: 'Name of the field to put the output in',
+		displayOptions: {
+			show: {
+				operation: ['getTimeBetweenDates'],
+			},
+		},
+	},
+	{
+		displayName: 'Options',
+		name: 'options',
+		type: 'collection',
+		placeholder: 'Add Option',
+		displayOptions: {
+			show: {
+				operation: ['getTimeBetweenDates'],
+			},
+		},
+		default: {},
+		options: [
+			{
+				displayName: 'Output as ISO String',
+				name: 'isoString',
+				type: 'boolean',
+				default: false,
+				description: 'Whether to output the date as ISO string or not',
+			},
+		],
+	},
+];

packages/nodes-base/nodes/DateTime/V2/RoundDateDescription.ts

@@ -0,0 +1,122 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const RoundDateDescription: INodeProperties[] = [
+	{
+		displayName:
+			"You can also do this using an expression, e.g. <code>{{ your_date.beginningOf('month') }}</code> or <code>{{ your_date.endOfMonth() }}</code>. <a target='_blank' href='https://docs.n8n.io/code-examples/expressions/luxon/'>More info</a>",
+		name: 'notice',
+		type: 'notice',
+		default: '',
+		displayOptions: {
+			show: {
+				operation: ['roundDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Date',
+		name: 'date',
+		type: 'string',
+		description: 'The date that you want to round',
+		default: '',
+		displayOptions: {
+			show: {
+				operation: ['roundDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Mode',
+		name: 'mode',
+		type: 'options',
+		options: [
+			{
+				name: 'Round Down',
+				value: 'roundDown',
+			},
+			{
+				name: 'Round Up',
+				value: 'roundUp',
+			},
+		],
+		default: 'roundDown',
+		displayOptions: {
+			show: {
+				operation: ['roundDate'],
+			},
+		},
+	},
+	{
+		displayName: 'To Nearest',
+		name: 'toNearest',
+		type: 'options',
+		// eslint-disable-next-line n8n-nodes-base/node-param-options-type-unsorted-items
+		options: [
+			{
+				name: 'Year',
+				value: 'year',
+			},
+			{
+				name: 'Month',
+				value: 'month',
+			},
+			{
+				name: 'Week',
+				value: 'week',
+			},
+			{
+				name: 'Day',
+				value: 'day',
+			},
+			{
+				name: 'Hour',
+				value: 'hour',
+			},
+			{
+				name: 'Minute',
+				value: 'minute',
+			},
+			{
+				name: 'Second',
+				value: 'second',
+			},
+		],
+		default: 'month',
+		displayOptions: {
+			show: {
+				operation: ['roundDate'],
+				mode: ['roundDown'],
+			},
+		},
+	},
+	{
+		displayName: 'To',
+		name: 'to',
+		type: 'options',
+		options: [
+			{
+				name: 'End of Month',
+				value: 'month',
+			},
+		],
+		default: 'month',
+		displayOptions: {
+			show: {
+				operation: ['roundDate'],
+				mode: ['roundUp'],
+			},
+		},
+	},
+	{
+		displayName: 'Output Field Name',
+		name: 'outputFieldName',
+		type: 'string',
+		default: 'roundedDate',
+		description: 'Name of the field to put the output in',
+		displayOptions: {
+			show: {
+				operation: ['roundDate'],
+			},
+		},
+	},
+];

packages/nodes-base/nodes/DateTime/V2/SubtractFromDateDescription.ts

@@ -0,0 +1,105 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const SubtractFromDateDescription: INodeProperties[] = [
+	{
+		displayName:
+			"You can also do this using an expression, e.g. <code>{{your_date.minus(5, 'minutes')}}</code>. <a target='_blank' href='https://docs.n8n.io/code-examples/expressions/luxon/'>More info</a>",
+		name: 'notice',
+		type: 'notice',
+		default: '',
+		displayOptions: {
+			show: {
+				operation: ['subtractFromDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Date to Subtract From',
+		name: 'magnitude',
+		type: 'string',
+		description: 'The date that you want to change',
+		default: '',
+		displayOptions: {
+			show: {
+				operation: ['subtractFromDate'],
+			},
+		},
+		required: true,
+	},
+	{
+		displayName: 'Time Unit to Subtract',
+		name: 'timeUnit',
+		description: 'Time unit for Duration parameter below',
+		displayOptions: {
+			show: {
+				operation: ['subtractFromDate'],
+			},
+		},
+		type: 'options',
+		// eslint-disable-next-line n8n-nodes-base/node-param-options-type-unsorted-items
+		options: [
+			{
+				name: 'Years',
+				value: 'years',
+			},
+			{
+				name: 'Quarters',
+				value: 'quarters',
+			},
+			{
+				name: 'Months',
+				value: 'months',
+			},
+			{
+				name: 'Weeks',
+				value: 'weeks',
+			},
+			{
+				name: 'Days',
+				value: 'days',
+			},
+			{
+				name: 'Hours',
+				value: 'hours',
+			},
+			{
+				name: 'Minutes',
+				value: 'minutes',
+			},
+			{
+				name: 'Seconds',
+				value: 'seconds',
+			},
+			{
+				name: 'Milliseconds',
+				value: 'milliseconds',
+			},
+		],
+		default: 'days',
+		required: true,
+	},
+	{
+		displayName: 'Duration',
+		name: 'duration',
+		type: 'number',
+		description: 'The number of time units to subtract from the date',
+		default: 0,
+		displayOptions: {
+			show: {
+				operation: ['subtractFromDate'],
+			},
+		},
+	},
+	{
+		displayName: 'Output Field Name',
+		name: 'outputFieldName',
+		type: 'string',
+		default: 'newDate',
+		description: 'Name of the field to put the output in',
+		displayOptions: {
+			show: {
+				operation: ['subtractFromDate'],
+			},
+		},
+	},
+];