ESM: Ported DateTime operations

src/core/operations/FromUNIXTimestamp.mjs

@@ -0,0 +1,66 @@
+/**
+ * @author n1474335 [n1474335@gmail.com]
+ * @copyright Crown Copyright 2016
+ * @license Apache-2.0
+ */
+
+import Operation from "../Operation";
+import moment from "moment-timezone";
+import {UNITS} from "../lib/DateTime";
+
+/**
+ * From UNIX Timestamp operation
+ */
+class FromUNIXTimestamp extends Operation {
+
+    /**
+     * FromUNIXTimestamp constructor
+     */
+    constructor() {
+        super();
+
+        this.name = "From UNIX Timestamp";
+        this.module = "Default";
+        this.description = "Converts a UNIX timestamp to a datetime string.<br><br>e.g. <code>978346800</code> becomes <code>Mon 1 January 2001 11:00:00 UTC</code><br><br>A UNIX timestamp is a 32-bit value representing the number of seconds since January 1, 1970 UTC (the UNIX epoch).";
+        this.inputType = "number";
+        this.outputType = "string";
+        this.args = [
+            {
+                "name": "Units",
+                "type": "option",
+                "value": UNITS
+            }
+        ];
+    }
+
+    /**
+     * @param {number} input
+     * @param {Object[]} args
+     * @returns {string}
+     */
+    run(input, args) {
+        const units = args[0];
+        let d;
+
+        input = parseFloat(input);
+
+        if (units === "Seconds (s)") {
+            d = moment.unix(input);
+            return d.tz("UTC").format("ddd D MMMM YYYY HH:mm:ss") + " UTC";
+        } else if (units === "Milliseconds (ms)") {
+            d = moment(input);
+            return d.tz("UTC").format("ddd D MMMM YYYY HH:mm:ss.SSS") + " UTC";
+        } else if (units === "Microseconds (μs)") {
+            d = moment(input / 1000);
+            return d.tz("UTC").format("ddd D MMMM YYYY HH:mm:ss.SSS") + " UTC";
+        } else if (units === "Nanoseconds (ns)") {
+            d = moment(input / 1000000);
+            return d.tz("UTC").format("ddd D MMMM YYYY HH:mm:ss.SSS") + " UTC";
+        } else {
+            throw "Unrecognised unit";
+        }
+    }
+
+}
+
+export default FromUNIXTimestamp;

src/core/operations/ParseDateTime.mjs

@@ -0,0 +1,82 @@
+/**
+ * @author n1474335 [n1474335@gmail.com]
+ * @copyright Crown Copyright 2016
+ * @license Apache-2.0
+ */
+
+import Operation from "../Operation";
+import moment from "moment-timezone";
+import {DATETIME_FORMATS, FORMAT_EXAMPLES} from "../lib/DateTime";
+
+/**
+ * Parse DateTime operation
+ */
+class ParseDateTime extends Operation {
+
+    /**
+     * ParseDateTime constructor
+     */
+    constructor() {
+        super();
+
+        this.name = "Parse DateTime";
+        this.module = "Default";
+        this.description = "Parses a DateTime string in your specified format and displays it in whichever timezone you choose with the following information:<ul><li>Date</li><li>Time</li><li>Period (AM/PM)</li><li>Timezone</li><li>UTC offset</li><li>Daylight Saving Time</li><li>Leap year</li><li>Days in this month</li><li>Day of year</li><li>Week number</li><li>Quarter</li></ul>Run with no input to see format string examples if required.";
+        this.inputType = "string";
+        this.outputType = "html";
+        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": "Input timezone",
+                "type": "option",
+                "value": ["UTC"].concat(moment.tz.names())
+            }
+        ];
+    }
+
+    /**
+     * @param {string} input
+     * @param {Object[]} args
+     * @returns {html}
+     */
+    run(input, args) {
+        const inputFormat = args[1],
+            inputTimezone = args[2];
+        let date,
+            output = "";
+
+        try {
+            date = moment.tz(input, inputFormat, inputTimezone);
+            if (!date || date.format() === "Invalid date") throw Error;
+        } catch (err) {
+            return "Invalid format.\n\n" + FORMAT_EXAMPLES;
+        }
+
+        output += "Date: " + date.format("dddd Do MMMM YYYY") +
+            "\nTime: " + date.format("HH:mm:ss") +
+            "\nPeriod: " + date.format("A") +
+            "\nTimezone: " + date.format("z") +
+            "\nUTC offset: " + date.format("ZZ") +
+            "\n\nDaylight Saving Time: " + date.isDST() +
+            "\nLeap year: " + date.isLeapYear() +
+            "\nDays in this month: " + date.daysInMonth() +
+            "\n\nDay of year: " + date.dayOfYear() +
+            "\nWeek number: " + date.weekYear() +
+            "\nQuarter: " + date.quarter();
+
+        return output;
+    }
+
+}
+
+export default ParseDateTime;

src/core/operations/Sleep.mjs

@@ -0,0 +1,47 @@
+/**
+ * @author n1474335 [n1474335@gmail.com]
+ * @copyright Crown Copyright 2018
+ * @license Apache-2.0
+ */
+
+import Operation from "../Operation";
+
+/**
+ * Sleep operation
+ */
+class Sleep extends Operation {
+
+    /**
+     * Sleep constructor
+     */
+    constructor() {
+        super();
+
+        this.name = "Sleep";
+        this.module = "Default";
+        this.description = "Sleep causes the recipe to wait for a specified number of milliseconds before continuing execution.";
+        this.inputType = "ArrayBuffer";
+        this.outputType = "ArrayBuffer";
+        this.args = [
+            {
+                "name": "Time (ms)",
+                "type": "number",
+                "value": 1000
+            }
+        ];
+    }
+
+    /**
+     * @param {ArrayBuffer} input
+     * @param {Object[]} args
+     * @returns {ArrayBuffer}
+     */
+    async run(input, args) {
+        const ms = args[0];
+        await new Promise(r => setTimeout(r, ms));
+        return input;
+    }
+
+}
+
+export default Sleep;

src/core/operations/ToUNIXTimestamp.mjs

@@ -0,0 +1,74 @@
+/**
+ * @author n1474335 [n1474335@gmail.com]
+ * @copyright Crown Copyright 2016
+ * @license Apache-2.0
+ */
+
+import Operation from "../Operation";
+import moment from "moment-timezone";
+import {UNITS} from "../lib/DateTime";
+
+/**
+ * To UNIX Timestamp operation
+ */
+class ToUNIXTimestamp extends Operation {
+
+    /**
+     * ToUNIXTimestamp constructor
+     */
+    constructor() {
+        super();
+
+        this.name = "To UNIX Timestamp";
+        this.module = "Default";
+        this.description = "Parses a datetime string in UTC and returns the corresponding UNIX timestamp.<br><br>e.g. <code>Mon 1 January 2001 11:00:00</code> becomes <code>978346800</code><br><br>A UNIX timestamp is a 32-bit value representing the number of seconds since January 1, 1970 UTC (the UNIX epoch).";
+        this.inputType = "string";
+        this.outputType = "string";
+        this.args = [
+            {
+                "name": "Units",
+                "type": "option",
+                "value": UNITS
+            },
+            {
+                "name": "Treat as UTC",
+                "type": "boolean",
+                "value": true
+            },
+            {
+                "name": "Show parsed datetime",
+                "type": "boolean",
+                "value": true
+            }
+        ];
+    }
+
+    /**
+     * @param {string} input
+     * @param {Object[]} args
+     * @returns {string}
+     */
+    run(input, args) {
+        const [units, treatAsUTC, showDateTime] = args,
+            d = treatAsUTC ? moment.utc(input) : moment(input);
+
+        let result = "";
+
+        if (units === "Seconds (s)") {
+            result = d.unix();
+        } else if (units === "Milliseconds (ms)") {
+            result = d.valueOf();
+        } else if (units === "Microseconds (μs)") {
+            result = d.valueOf() * 1000;
+        } else if (units === "Nanoseconds (ns)") {
+            result = d.valueOf() * 1000000;
+        } else {
+            throw "Unrecognised unit";
+        }
+
+        return showDateTime ? `${result} (${d.tz("UTC").format("ddd D MMMM YYYY HH:mm:ss")} UTC)` : result.toString();
+    }
+
+}
+
+export default ToUNIXTimestamp;

src/core/operations/TranslateDateTimeFormat.mjs

@@ -0,0 +1,78 @@
+/**
+ * @author n1474335 [n1474335@gmail.com]
+ * @copyright Crown Copyright 2016
+ * @license Apache-2.0
+ */
+
+import Operation from "../Operation";
+import moment from "moment-timezone";
+import {DATETIME_FORMATS, FORMAT_EXAMPLES} from "../lib/DateTime";
+
+/**
+ * Translate DateTime Format operation
+ */
+class TranslateDateTimeFormat extends Operation {
+
+    /**
+     * TranslateDateTimeFormat constructor
+     */
+    constructor() {
+        super();
+
+        this.name = "Translate DateTime Format";
+        this.module = "Default";
+        this.description = "Parses a datetime string in one format and re-writes it in another.<br><br>Run with no input to see the relevant format string examples.";
+        this.inputType = "string";
+        this.outputType = "html";
+        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": "Input timezone",
+                "type": "option",
+                "value": ["UTC"].concat(moment.tz.names())
+            },
+            {
+                "name": "Output format string",
+                "type": "binaryString",
+                "value": "dddd Do MMMM YYYY HH:mm:ss Z z"
+            },
+            {
+                "name": "Output timezone",
+                "type": "option",
+                "value": ["UTC"].concat(moment.tz.names())
+            }
+        ];
+    }
+
+    /**
+     * @param {string} input
+     * @param {Object[]} args
+     * @returns {html}
+     */
+    run(input, args) {
+        const [inputFormat, inputTimezone, outputFormat, outputTimezone] = args;
+        let date;
+
+        try {
+            date = moment.tz(input, inputFormat, inputTimezone);
+            if (!date || date.format() === "Invalid date") throw Error;
+        } catch (err) {
+            return "Invalid format.\n\n" + FORMAT_EXAMPLES;
+        }
+
+        return date.tz(outputTimezone).format(outputFormat);
+    }
+
+}
+
+export default TranslateDateTimeFormat;