feat: Add parseString method to supply missing date string parsing in…

… date-fns, if the time zone is not given from outside

* Fix the UTC offset addition in parseFromTimeZone.
* Upgrade timezone-support to gain conversion methods between date and time objects.
* Test and debug the ES6 sources directly without a debug compilation to CJS.

.jsdoc.json

@@ -3,6 +3,7 @@
     "include": [
       "src/convertToLocalTime.js",
       "src/convertToTimeZone.js",
+      "src/parseFromString.js",
       "src/parseFromTimeZone.js",
       "src/formatToTimeZone.js"
     ]

.vscode/launch.json

@@ -10,9 +10,7 @@
       "name": "Test",
       "program": "${workspaceFolder}/node_modules/.bin/jest",
       "args": [
-        "-i",
-        "--testPathIgnorePatterns",
-        "browser.test.js"
+        "-i"
       ],
       "internalConsoleOptions": "openOnSessionStart",
       "skipFiles": [

.vscode/tasks.json

@@ -13,12 +13,6 @@
         "isDefault": true
       }
     },
-    {
-      "label": "build:debug",
-      "type": "npm",
-      "script": "build:debug",
-      "problemMatcher": []
-    },
     {
       "label": "test",
       "type": "npm",
@@ -30,4 +24,4 @@
       }
     },
   ]
-}
+}

README.md

@@ -8,7 +8,7 @@ utm_content=prantlf/date-fns-timezone&utm_campaign=Badge_Grade)
 [![devDependency Status](https://david-dm.org/prantlf/date-fns-timezone/dev-status.svg)](https://david-dm.org/prantlf/date-fns-timezone#info=devDependencies)
 [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
 
-Provides parsing and formatting date strings and time zone conversions supporting [IANA time zones]. Date parsing, formatting and other queries and manipulations are provided by [date-fns]. List of canonical time zone names and time zone conversions are provided by [timezone-support].
+Provides parsing and formatting date strings and time zone conversions supporting [IANA time zones], following the design of functions in [date-fns]. List of canonical time zone names is provided by [timezone-support].
 
 - [Synopsis](#synopsis)
 - [Installation and Loading](#installation-and-loading)
@@ -143,6 +143,12 @@ const enteredTime = '2018-09-02 12:04:30.982'
 const timeZone = 'Europe/Berlin'
 const storedDate = parseFromTimeZone(enteredTime, { timeZone })
 // Contains date "2018-09-02T10:04:30.982Z"
+
+const enteredTime = '09/02/2018 12:04:30.982 PM'
+const customFormat = 'MM/DD/YYYY h:mm:ss.SSS A'
+const timeZone = 'America/New_York'
+const storedDate = parseFromTimeZone(enteredTime, { timeZone })
+// Contains date "2018-09-02T18:04:30.982Z"
 ```
 
 See the function [parseFromTimeZone](#parsefromtimezone) for more information.