From dbcce2e0afdc0df988012ab92045a3b689ec258e Mon Sep 17 00:00:00 2001
From: tomgond <tomgond@users.noreply.github.com>
Date: Wed, 3 Apr 2024 22:43:15 +0300
Subject: [PATCH] Add TimeDifference Operation

Allow to calculate the time between two input DateTimes (with delimiter between them).
trailing newlines are ignored.
Error is raised when needed.
Output can be positive or negative depending on the order of the input.
---
 src/core/operations/TimeDifference.mjs | 76 ++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 src/core/operations/TimeDifference.mjs

diff --git a/src/core/operations/TimeDifference.mjs b/src/core/operations/TimeDifference.mjs
new file mode 100644
index 00000000..f8efd8ad
--- /dev/null
+++ b/src/core/operations/TimeDifference.mjs
@@ -0,0 +1,76 @@
+/**
+ * @author tomgond [tom.gonda@gmail.com]
+ * @copyright Crown Copyright 2024
+ * @license Apache-2.0
+ */
+
+import Operation from "../Operation.mjs";
+import moment from "moment-timezone";
+import Utils from "../Utils.mjs";
+import {DATETIME_FORMATS} from "../lib/DateTime.mjs";
+import {DATE_DELIM_OPTIONS} from "../lib/Delim.mjs";
+import OperationError from "../errors/OperationError.mjs";
+
+/**
+ * Calculate Time Difference operation
+ */
+class TimeDifference extends Operation {
+
+    /**
+     * TimeDifference Constructor
+     */
+    constructor() {
+        super();
+
+        this.name = "Time Difference";
+        this.module = "DateTime";
+        this.description = "Calculates the difference between two datetime values based on the provided format.";
+        this.inputType = "string";
+        this.outputType = "string";
+        this.args = [
+            {
+                "name": "Built in formats",
+                "type": "populateOption",
+                "value": DATETIME_FORMATS,
+                "target": 1
+            },
+            {
+                "name": "Input format string",
+                "type": "binaryString",
+                "value": "DD/MM/YYYY HH:mm:ss"
+            },
+            {
+                "name": "Delimiter",
+                "type": "option",
+                "value": DATE_DELIM_OPTIONS,
+            }
+        ];
+    }
+
+    /**
+     * @param {string} input
+     * @param {Object[]} args
+     * @returns {string}
+     */
+    run(input, args) {
+        const dateFormat = args[1];
+        const delimiter = Utils.charRep(args[2]);
+        input = input.replace(/[\r\n]+$/, "");
+        const dates = input.split(delimiter);
+        if (dates.length !== 2) {
+            throw new OperationError("Error: Input should contain exactly two datetime values separated by a delimiter.");
+        }
+
+        const date1 = moment(dates[0], dateFormat);
+        const date2 = moment(dates[1], dateFormat);
+
+        if (!date1.isValid() || !date2.isValid()) {
+            throw new OperationError("Error: One of the provided dates is invalid.");
+        }
+
+        const diff = moment.duration(date2.diff(date1));
+        return `Years:${diff.years()} Months:${diff.months()} Days:${diff.days()} Hours:${diff.hours()} Minutes:${diff.minutes()} Seconds:${diff.seconds()}`;
+    }
+}
+
+export default TimeDifference;