Mapping addition to parse unix timestamp millisecond input GH-371

Merge pull request #372 from kendraio/parseUnixTimestamp-millisecond-input-GH-371

docs/workflow/blocks/mapping.rst

@@ -702,9 +702,13 @@ Parses a Unix timestamp and returns an ISO 8601 date string.
 
 .. code-block:: javascript
 
-    parseUnixTimestamp(`0`)
+    parseUnixTimestamp(`0`)  // Seconds
 
 Output: "1970-01-01T01:00:00.000+01:00"
 
+.. code-block:: javascript
+
+    parseUnixTimestamp(`1589756000000`, `ms`) // Milliseconds 
 
+Output: "2020-05-19T03:00:00.000+01:00"
 

src/app/blocks/mapping-block/mapping-util.spec.ts

@@ -38,5 +38,21 @@ describe('MappingUtil', () => {
         expect(mappingUtility(data, expr1)).toBe(expected1);
         expect(mappingUtility(data, expr2)).toBe(expected2);
     });
+
+    it('should parse Unix millisecond timestamp and return date string', () => {
+        const data = { data: { timestamp: 1589756000000, nothing: 0 } };
+        const expr1 = "parseUnixTimestamp(data.timestamp, 'ms')";
+        const expected1 = DateTime.fromMillis(data.data.timestamp).toISO();
+
+        expect(mappingUtility(data, expr1)).toBe(expected1);
+      });
+
+      it('should parse Unix millisecond timestamp and return date string with format argument', () => {
+        const data = { data: { timestamp: 1589756000000, nothing: 0 } };
+        const expr1 = "parseUnixTimestamp(data.timestamp, 'milliseconds')";
+        const expected1 = DateTime.fromMillis(data.data.timestamp).toISO();
+
+        expect(mappingUtility(data, expr1)).toBe(expected1); 
+      });
 });
 

src/app/blocks/mapping-block/mapping-util.ts

@@ -244,16 +244,16 @@ const search = decorate({
     _signature: [{types: [TYPE_NUMBER, TYPE_STRING, TYPE_NULL]}]
   },
   parseUnixTimestamp: {
-    _func: ([n]) => {
-      if (isNull(n)) {
-        return null;
+    _func: ([n, format]) => {
+      if (format === 'ms' || format === 'milliseconds') {
+        n =  n / 1000;
       }
       if (isNumber(n)) {
         return DateTime.fromSeconds(n).toISO();
       }
       return null;
     },
-    _signature: [{ types: [TYPE_NUMBER, TYPE_NULL] }]
+    _signature: [{ types: [TYPE_NUMBER, TYPE_NULL] }, { types: [TYPE_NUMBER, TYPE_STRING], optional: true }]
   },
 });