handlebars-i18n 1.7.0 → 1.8.0

package/.github/workflows/coveralls.yml

@@ -0,0 +1,44 @@
+name: Test and Coverage
+
+on:
+  push:
+    branches: [ "master" ]
+  pull_request:
+    branches: [ "master" ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+
+      - uses: actions/checkout@v3
+
+      - name: Use Node.js 16.x
+        uses: actions/setup-node@v3
+        with:
+          node-version: 16.x
+
+      - name: npm install, make test-coverage
+        run: |
+          npm install
+          npm run test:coverage
+          sleep 2
+
+      - name: Report Coveralls (Linux)
+        if: startsWith(runner.os, 'Linux')
+        run: curl -sL https://coveralls.io/coveralls-linux.tar.gz | tar -xz && ./coveralls
+        env:
+          COVERALLS_REPO_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Report Coveralls (Windows)
+        if: startsWith(runner.os, 'Windows')
+        run: curl -sL https://github.com/coverallsapp/coverage-reporter/releases/latest/download/coveralls-windows.zip | zcat > ./coveralls.exe && ./coveralls.exe
+        env:
+          COVERALLS_REPO_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Report Coveralls (macOS)
+        if: startsWith(runner.os, 'macOS')
+        run: |
+          brew tap coverallsapp/coveralls --quiet
+          brew install coveralls --quiet
+          coveralls

package/dist/handlebars-i18n.d.ts

@@ -18,7 +18,7 @@ type unitDisplay = "short" | "narrow" | "long";
 type roundingPriority = "auto" | "morePrecision" | "lessPrecision";
 
 type roundingMode =
-    | "ceil"
+      "ceil"
     | "floor"
     | "expand"
     | "trunc"
@@ -197,13 +197,13 @@ export type DateTimeFormatConfiguration = [
     CustomFormatName?
 ];
 
-
 type DateRelFormatOptions = {
   localeMatcher?: localeMatcher,
   numberingSystem?: numberingSystem,
   numeric?: "always" | "auto",
   style?: "long" | "short" | "narrow",
-  unit?: "second" | "minute" | "hour" | "day" | "week" | "month" | "year"
+  timeZone?: TimeZone,
+  unit?: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year"
 }
 
 export type RelativeTimeFormatConfiguration = [

package/dist/handlebars-i18n.js

@@ -2,7 +2,7 @@
  * handlebars-i18n.js
  *
  * @author: Florian Walzel
- * @date: 2024-05
+ * @date: 2024-08
  *
  * handlebars-i18n adds features for localization/
  * internationalization to handlebars.js
@@ -17,15 +17,14 @@
     const Handlebars = require('handlebars'),
       i18next = require('i18next'),
       Intl = require('intl'),
-      RelativeTimeFormat= require('relative-time-format');
+      RelativeTimeFormat = require('relative-time-format');
     module.exports = factory(
       Handlebars,
       i18next,
       Intl,
       RelativeTimeFormat,
       process?.env?.NODE_ENV === 'TEST');
-  }
-  else if (typeof define === 'function' && define.amd)
+  } else if (typeof define === 'function' && define.amd)
     define(['Handlebars', 'i18next', 'Intl'], factory);
   else if (typeof root.Handlebars === 'object'
     && typeof root.i18next === 'object'
@@ -151,7 +150,7 @@
       return false;
     }
 
-    if (! ['DateTimeFormat', 'RelativeTimeFormat', 'NumberFormat', 'PriceFormat'].includes(typeOfFormat)) {
+    if (!['DateTimeFormat', 'RelativeTimeFormat', 'NumberFormat', 'PriceFormat'].includes(typeOfFormat)) {
       console.error('@ handlebars-i18n.configure(): Invalid argument <' + typeOfFormat + '>. ' +
         'Second argument must be a string with the options key. ' +
         'Use either "DateTimeFormat", "RelativeTimeFormat", "NumberFormat", or "PriceFormat".');
@@ -191,8 +190,7 @@
         optionsConf[formatType].custom[customFormat] = {};
 
       optionsConf[formatType].custom[customFormat][lang] = options;
-    }
-    else
+    } else
       optionsConf[formatType].standard[lang] = options;
 
     return true;
@@ -221,8 +219,7 @@
     if (typeof dateInput === 'number') {
       // input as milliseconds since unix epoch, like: 1583922952743
       date = new Date(dateInput);
-    }
-    else if (typeof dateInput === 'string') {
+    } else if (typeof dateInput === 'string') {
 
       if (dateInput.charAt(0) === '[' && dateInput.slice(-1) === ']') {
         // input as array represented as string such as "[2020, 11]"
@@ -230,17 +227,14 @@
         let dateArr = dateInput.split(',');
         let dateFactory = __applyToConstructor.bind(null, Date);
         date = dateFactory(dateArr);
-      }
-      else if (dateInput.toLowerCase() === 'now' || dateInput.toLowerCase() === 'today') {
+      } else if (dateInput.toLowerCase() === 'now' || dateInput.toLowerCase() === 'today') {
         // input as word "now" or "today"
         date = new Date();
-      }
-      else {
+      } else {
         // input as date string such as "1995-12-17T03:24:00"
         date = new Date(dateInput);
       }
-    }
-    else {
+    } else {
       // fallback: today’s date
       date = new Date();
     }
@@ -337,8 +331,7 @@
           else
             return false;
         });
-      }
-      else {
+      } else {
         if (__validateArgs(langOrArr, typeOfFormat, options, customFormatName))
           __setArgs(langOrArr, typeOfFormat, options, customFormatName);
         else
@@ -393,7 +386,7 @@
          * @returns {*}
          */
         function (str, attributes) {
-          return new handlebars.SafeString((typeof(i18next) !== 'undefined' ? i18next.t(str, attributes.hash) : str));
+          return new handlebars.SafeString((typeof (i18next) !== 'undefined' ? i18next.t(str, attributes.hash) : str));
         }
       );
       handlebars.registerHelper('_locale',
@@ -445,12 +438,77 @@
          * @param options
          */
         function (dateInput, options) {
-          const date= __createDateObj(dateInput);
+          const date = __createDateObj(dateInput);
           const opts = __configLookup(options, i18next.language, optionsConf.DateTimeFormat);
           const dateFormat = new Intl.DateTimeFormat(i18next.language, opts);
           return dateFormat.format(date);
         }
       );
+      handlebars.registerHelper('_dateAdd',
+        /**
+         * adds a time offset in a given unit to a date
+         * -> returns the modified date
+         *
+         * @param dateInput
+         * @param offset
+         * @param options
+         * @returns {string}
+         */
+        function (dateInput, offset, options) {
+
+          if (typeof dateInput !== 'number' && typeof dateInput !== 'string')
+            throw new Error('@ handlebars-i18n: invalid first argument "dateInput" was given for _dateAdd.');
+
+          if (typeof offset !== 'number')
+            throw new Error('@ handlebars-i18n: invalid second argument "offset" was given for _dateAdd.');
+
+          const date = __createDateObj(dateInput);
+
+          const opts = __configLookup(options, i18next.language, optionsConf.DateTimeFormat);
+          opts.unit = opts.unit || 'hour';
+
+          switch (opts.unit) {
+            case 'second':
+            case 'seconds':
+              date.setSeconds(date.getSeconds() + offset);
+              break;
+            case 'minute':
+            case 'minutes':
+              date.setMinutes(date.getMinutes() + offset);
+              break;
+            case 'hour':
+            case 'hours':
+              date.setHours(date.getHours() + offset);
+              break;
+            case 'day':
+            case 'days':
+              date.setDate(date.getDate() + offset);
+              break;
+            case 'week':
+            case 'weeks':
+              date.setDate(date.getDate() + offset * 7);
+              break;
+            case 'month':
+            case 'months':
+              date.setMonth(date.getMonth() + offset);
+              break;
+            case 'quarter':
+            case 'quarters':
+              date.setMonth(date.getMonth() + offset * 3);
+              break;
+            case 'year':
+            case 'years':
+              date.setFullYear(date.getFullYear() + offset);
+              break;
+            default:
+              throw new Error('@ handlebars-i18n: invalid argument "unit" was given for _dateAdd.' +
+                'Unit must be either "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year".');
+          }
+
+          const dateFormat = new Intl.DateTimeFormat(i18next.language, opts);
+          return dateFormat.format(date);
+        }
+      );
       handlebars.registerHelper('_dateRel',
         /**
          * returns a relative date formatted according the options
@@ -468,7 +526,7 @@
          * @returns {string}
          */
         function (dateValue, options) {
-          const relDate= parseInt(dateValue);
+          const relDate = parseInt(dateValue);
           const opts = __configLookup(options, i18next.language, optionsConf.RelativeTimeFormat);
           const relDateFormat = __getRelDateFormatPolyfill(i18next.language, opts);
           return relDateFormat.format(relDate, opts.unit);
@@ -485,20 +543,20 @@
         function (dateInputA, dateInputB, options) {
 
           let dateDiff;
+          let opts = __configLookup(options, i18next.language, optionsConf.RelativeTimeFormat);
 
-          if (! __isNumOrString(dateInputA) && ! __isNumOrString(dateInputB))
+          if (!__isNumOrString(dateInputA)) {
+            console.error('@ handlebars-i18n: invalid first argument dateInputA was given for _dateDiff.');
             return null;
-          else if (! __isNumOrString(dateInputB))
-            dateDiff = __createDateObj(dateInputA);
-          else if (! __isNumOrString(dateInputA))
-            dateDiff = __createDateObj(dateInputB);
-          else {
-            const dateA= __createDateObj(dateInputA);
-            const dateB= __createDateObj(dateInputB);
-            dateDiff = dateA - dateB;
           }
 
-          const opts = __configLookup(options, i18next.language, optionsConf.RelativeTimeFormat);
+          dateInputB = dateInputB || 'now';
+
+          let dateA = __createDateObj(dateInputA);
+          let dateB = __createDateObj(dateInputB);
+
+          dateDiff = dateA - dateB;
+
           const relDate = __getDateDiff(dateDiff, opts.unit);
           const relDateFormat = __getRelDateFormatPolyfill(i18next.language, opts);
           return relDateFormat.format(relDate, opts.unit);

package/dist/handlebars-i18n.min.js

@@ -1 +1 @@
-!function(e,r){if("object"==typeof exports&&"object"==typeof module){const e=require("handlebars"),t=require("i18next"),n=require("intl"),a=require("relative-time-format");module.exports=r(e,t,n,a,"TEST"===process?.env?.NODE_ENV)}else if("function"==typeof define&&define.amd)define(["Handlebars","i18next","Intl"],r);else{if("object"!=typeof e.Handlebars||"object"!=typeof e.i18next||"object"!=typeof e.Intl)return console.error("@ handlebars-i18n: One or more dependencies are missing. Check for Handlebars, i18next and Intl."),!1;e.HandlebarsI18n=r(e.Handlebars,e.i18next,e.Intl)}}(this,(function(e,r,t,n,a){"use strict";const o={DateTimeFormat:{standard:{},custom:{}},RelativeTimeFormat:{standard:{all:{unit:"hours"}},custom:{}},NumberFormat:{standard:{},custom:{}},PriceFormat:{standard:{all:{style:"currency",currency:"EUR"}},custom:{}}};let i=JSON.parse(JSON.stringify(o));const u={};function s(e,r){let t=[null].concat(r);return new(e.bind.apply(e,t))}function l(e,r,t){if("object"==typeof e&&"object"==typeof e.hash&&Object.keys(e.hash).length>0){let n=e.hash;if(void 0===n.format)return n;if(void 0!==t.custom[n.format]&&void 0!==t.custom[n.format][r])return t.custom[n.format][r]}return void 0!==t.standard[r]?t.standard[r]:void 0!==t.standard.all?t.standard.all:{}}function c(e,r,t,n){return"string"!=typeof e?(console.error("@ handlebars-i18n.configure(): Invalid argument <"+e+'> First argument must be a string with language code such as "en".'),!1):["DateTimeFormat","RelativeTimeFormat","NumberFormat","PriceFormat"].includes(r)?"object"!=typeof t?(console.error("@ handlebars-i18n.configure(): Invalid argument <"+t+"> Third argument must be an object containing the configuration parameters."),!1):(null==n||"string"==typeof n)&&""!==n&&" "!==n||(console.error("@ handlebars-i18n.configure(): Invalid argument <"+n+"> Fourth argument (optional) must be a string naming your custom format configuration."),!1):(console.error("@ handlebars-i18n.configure(): Invalid argument <"+r+'>. Second argument must be a string with the options key. Use either "DateTimeFormat", "RelativeTimeFormat", "NumberFormat", or "PriceFormat".'),!1)}function m(e,r,t,n){return null!=n?(void 0===i[r].custom[n]&&(i[r].custom[n]={}),i[r].custom[n][e]=t):i[r].standard[e]=t,!0}function f(e){return"number"==typeof e||"string"==typeof e&&""!==e}function g(e){let r;if("number"==typeof e)r=new Date(e);else if("string"==typeof e)if("["===e.charAt(0)&&"]"===e.slice(-1)){let t=(e=e.substring(1,e.length-1).replace(/ /g,"")).split(",");r=s.bind(null,Date)(t)}else r="now"===e.toLowerCase()||"today"===e.toLowerCase()?new Date:new Date(e);else r=new Date;return r}function d(e,r){if("function"==typeof t.RelativeTimeFormat)return new t.RelativeTimeFormat(e,r);if(void 0===u[e])try{u[e]=require(`relative-time-format/locale/${e}`)}catch(e){console.error(e)}return n.addLocale(u[e]),new n(e,r)}function b(e,r){return r=r||"hour",Math.trunc(e/{second:1e3,seconds:1e3,minute:6e4,minutes:6e4,hour:36e5,hours:36e5,day:864e5,days:864e5,week:6048e5,weeks:6048e5,month:2629746e3,months:2629746e3,quarter:78894e5,quarters:78894e5,year:315576e5,years:315576e5}[r])}return{configure:function(e,r,t,n){if("string"!=typeof e&&!Array.isArray(e))return console.error("@ handlebars-i18n.configure(): Invalid argument <"+e+'> First argument must be a string with language code such as "en" or an array with language parameters.'),!1;if(Array.isArray(e)){if(e.length<1)return console.log("@ handlebars-i18n.configure(): You passed an empty array, no parameters taken."),!1;e.forEach((e=>{if(!c(e[0],e[1],e[2],e[3]))return!1;m(e[0],e[1],e[2],e[3])}))}else{if(!c(e,r,t,n))return!1;m(e,r,t,n)}return!0},reset:function(){return i=JSON.parse(JSON.stringify(o)),!0},init:function(n,a){return"object"==typeof n&&null!==n?e=n:null!=n&&console.error("@ handlebars-i18n.init(): Invalid Argument [1] given for overrideHndlbrs. Argument must be the Handlebars object. Using generic Handlebars object instead."),"object"==typeof a&&null!==a?r=a:null!=a&&console.error("@ handlebars-i18n.init(): Invalid Argument [2] given for overrideI18n. Argument must be the i18next object. Using generic i18next object on module level instead."),e.registerHelper("__",(function(t,n){return new e.SafeString(void 0!==r?r.t(t,n.hash):t)})),e.registerHelper("_locale",(function(){return r.language})),e.registerHelper("localeIs",(function(e){return r.language===e})),e.registerHelper("_date",(function(e,n){const a=g(e),o=l(n,r.language,i.DateTimeFormat);return new t.DateTimeFormat(r.language,o).format(a)})),e.registerHelper("_dateRel",(function(e,t){const n=parseInt(e),a=l(t,r.language,i.RelativeTimeFormat);return d(r.language,a).format(n,a.unit)})),e.registerHelper("_dateDiff",(function(e,t,n){let a;if(!f(e)&&!f(t))return null;if(f(t))if(f(e)){a=g(e)-g(t)}else a=g(t);else a=g(e);const o=l(n,r.language,i.RelativeTimeFormat),u=b(a,o.unit);return d(r.language,o).format(u,o.unit)})),e.registerHelper("_num",(function(e,n){let a=l(n,r.language,i.NumberFormat);return new t.NumberFormat(r.language,a).format(e)})),e.registerHelper("_price",(function(e,n){let a=l(n,r.language,i.PriceFormat);"string"!=typeof a.style&&"string"==typeof a.currency&&(a.style="currency");return new t.NumberFormat(r.language,a).format(e)})),e},...a&&{private:{applyToConstructor:s,configLookup:l,validateArgs:c,setArgs:m,isNumOrString:f,createDateObj:g,getRelDateFormatPolyfill:d,getDateDiff:b}}}}));
+!function(e,t){if("object"==typeof exports&&"object"==typeof module){const e=require("handlebars"),r=require("i18next"),n=require("intl"),a=require("relative-time-format");module.exports=t(e,r,n,a,"TEST"===process?.env?.NODE_ENV)}else if("function"==typeof define&&define.amd)define(["Handlebars","i18next","Intl"],t);else{if("object"!=typeof e.Handlebars||"object"!=typeof e.i18next||"object"!=typeof e.Intl)return console.error("@ handlebars-i18n: One or more dependencies are missing. Check for Handlebars, i18next and Intl."),!1;e.HandlebarsI18n=t(e.Handlebars,e.i18next,e.Intl)}}(this,(function(e,t,r,n,a){"use strict";const o={DateTimeFormat:{standard:{},custom:{}},RelativeTimeFormat:{standard:{all:{unit:"hours"}},custom:{}},NumberFormat:{standard:{},custom:{}},PriceFormat:{standard:{all:{style:"currency",currency:"EUR"}},custom:{}}};let i=JSON.parse(JSON.stringify(o));const s={};function u(e,t){let r=[null].concat(t);return new(e.bind.apply(e,r))}function l(e,t,r){if("object"==typeof e&&"object"==typeof e.hash&&Object.keys(e.hash).length>0){let n=e.hash;if(void 0===n.format)return n;if(void 0!==r.custom[n.format]&&void 0!==r.custom[n.format][t])return r.custom[n.format][t]}return void 0!==r.standard[t]?r.standard[t]:void 0!==r.standard.all?r.standard.all:{}}function c(e,t,r,n){return"string"!=typeof e?(console.error("@ handlebars-i18n.configure(): Invalid argument <"+e+'> First argument must be a string with language code such as "en".'),!1):["DateTimeFormat","RelativeTimeFormat","NumberFormat","PriceFormat"].includes(t)?"object"!=typeof r?(console.error("@ handlebars-i18n.configure(): Invalid argument <"+r+"> Third argument must be an object containing the configuration parameters."),!1):(null==n||"string"==typeof n)&&""!==n&&" "!==n||(console.error("@ handlebars-i18n.configure(): Invalid argument <"+n+"> Fourth argument (optional) must be a string naming your custom format configuration."),!1):(console.error("@ handlebars-i18n.configure(): Invalid argument <"+t+'>. Second argument must be a string with the options key. Use either "DateTimeFormat", "RelativeTimeFormat", "NumberFormat", or "PriceFormat".'),!1)}function m(e,t,r,n){return null!=n?(void 0===i[t].custom[n]&&(i[t].custom[n]={}),i[t].custom[n][e]=r):i[t].standard[e]=r,!0}function g(e){return"number"==typeof e||"string"==typeof e&&""!==e}function d(e){let t;if("number"==typeof e)t=new Date(e);else if("string"==typeof e)if("["===e.charAt(0)&&"]"===e.slice(-1)){let r=(e=e.substring(1,e.length-1).replace(/ /g,"")).split(",");t=u.bind(null,Date)(r)}else t="now"===e.toLowerCase()||"today"===e.toLowerCase()?new Date:new Date(e);else t=new Date;return t}function f(e,t){if("function"==typeof r.RelativeTimeFormat)return new r.RelativeTimeFormat(e,t);if(void 0===s[e])try{s[e]=require(`relative-time-format/locale/${e}`)}catch(e){console.error(e)}return n.addLocale(s[e]),new n(e,t)}function b(e,t){return t=t||"hour",Math.trunc(e/{second:1e3,seconds:1e3,minute:6e4,minutes:6e4,hour:36e5,hours:36e5,day:864e5,days:864e5,week:6048e5,weeks:6048e5,month:2629746e3,months:2629746e3,quarter:78894e5,quarters:78894e5,year:315576e5,years:315576e5}[t])}return{configure:function(e,t,r,n){if("string"!=typeof e&&!Array.isArray(e))return console.error("@ handlebars-i18n.configure(): Invalid argument <"+e+'> First argument must be a string with language code such as "en" or an array with language parameters.'),!1;if(Array.isArray(e)){if(e.length<1)return console.log("@ handlebars-i18n.configure(): You passed an empty array, no parameters taken."),!1;e.forEach((e=>{if(!c(e[0],e[1],e[2],e[3]))return!1;m(e[0],e[1],e[2],e[3])}))}else{if(!c(e,t,r,n))return!1;m(e,t,r,n)}return!0},reset:function(){return i=JSON.parse(JSON.stringify(o)),!0},init:function(n,a){return"object"==typeof n&&null!==n?e=n:null!=n&&console.error("@ handlebars-i18n.init(): Invalid Argument [1] given for overrideHndlbrs. Argument must be the Handlebars object. Using generic Handlebars object instead."),"object"==typeof a&&null!==a?t=a:null!=a&&console.error("@ handlebars-i18n.init(): Invalid Argument [2] given for overrideI18n. Argument must be the i18next object. Using generic i18next object on module level instead."),e.registerHelper("__",(function(r,n){return new e.SafeString(void 0!==t?t.t(r,n.hash):r)})),e.registerHelper("_locale",(function(){return t.language})),e.registerHelper("localeIs",(function(e){return t.language===e})),e.registerHelper("_date",(function(e,n){const a=d(e),o=l(n,t.language,i.DateTimeFormat);return new r.DateTimeFormat(t.language,o).format(a)})),e.registerHelper("_dateAdd",(function(e,n,a){if("number"!=typeof e&&"string"!=typeof e)throw new Error('@ handlebars-i18n: invalid first argument "dateInput" was given for _dateAdd.');if("number"!=typeof n)throw new Error('@ handlebars-i18n: invalid second argument "offset" was given for _dateAdd.');const o=d(e),s=l(a,t.language,i.DateTimeFormat);switch(s.unit=s.unit||"hour",s.unit){case"second":case"seconds":o.setSeconds(o.getSeconds()+n);break;case"minute":case"minutes":o.setMinutes(o.getMinutes()+n);break;case"hour":case"hours":o.setHours(o.getHours()+n);break;case"day":case"days":o.setDate(o.getDate()+n);break;case"week":case"weeks":o.setDate(o.getDate()+7*n);break;case"month":case"months":o.setMonth(o.getMonth()+n);break;case"quarter":case"quarters":o.setMonth(o.getMonth()+3*n);break;case"year":case"years":o.setFullYear(o.getFullYear()+n);break;default:throw new Error('@ handlebars-i18n: invalid argument "unit" was given for _dateAdd.Unit must be either "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year".')}return new r.DateTimeFormat(t.language,s).format(o)})),e.registerHelper("_dateRel",(function(e,r){const n=parseInt(e),a=l(r,t.language,i.RelativeTimeFormat);return f(t.language,a).format(n,a.unit)})),e.registerHelper("_dateDiff",(function(e,r,n){let a,o=l(n,t.language,i.RelativeTimeFormat);if(!g(e))return console.error("@ handlebars-i18n: invalid first argument dateInputA was given for _dateDiff."),null;r=r||"now",a=d(e)-d(r);const s=b(a,o.unit);return f(t.language,o).format(s,o.unit)})),e.registerHelper("_num",(function(e,n){let a=l(n,t.language,i.NumberFormat);return new r.NumberFormat(t.language,a).format(e)})),e.registerHelper("_price",(function(e,n){let a=l(n,t.language,i.PriceFormat);"string"!=typeof a.style&&"string"==typeof a.currency&&(a.style="currency");return new r.NumberFormat(t.language,a).format(e)})),e},...a&&{private:{applyToConstructor:u,configLookup:l,validateArgs:c,setArgs:m,isNumOrString:g,createDateObj:d,getRelDateFormatPolyfill:f,getDateDiff:b}}}}));

package/examples/browser-example/index.html

@@ -218,6 +218,22 @@
 
           <button onclick="changeLang()">{{__ "key0"}} {{#if (localeIs "en")}}German {{else}}Englisch {{/if}}</button>
 
+            <h4>Date with positive time offset:</h4>
+            <code>{{{{raw}}}} {{_dateAdd "December 17, 1995" 24 unit="hour"}} {{{{/raw}}}}</code>
+            <p>&#x2192; {{_dateAdd "December 17, 1995 08:00:00" 24 unit="hour"}}</p>
+
+            <h4>Date with negative time offset:</h4>
+            <code>{{{{raw}}}} {{_dateAdd "December 17, 1995" -10 unit="day"}} {{{{/raw}}}}</code>
+            <p>&#x2192; {{_dateAdd "December 17, 1995" -10 unit="day"}}</p>
+
+            <h4>Relative difference between two dates:</h4>
+            <code>{{{{raw}}}} {{_dateDiff "1996-12-07T00:00:00" "1996-12-08T00:00:00" unit="day"}} {{{{/raw}}}}</code>
+            <p>&#x2192; {{_dateDiff "1996-12-07T00:00:00" "1996-12-08T00:00:00" unit="day"}}</p>
+
+            <h4>Relative difference between two dates with custom configuration (subset "date-rel-spec"):</h4>
+            <code>{{{{raw}}}} {{_dateDiff myDate "1995-12-17T00:00:00" format="date-rel-spec"}} {{{{/raw}}}}</code>
+            <p>&#x2192; {{_dateDiff myDate "1995-12-17T00:00:00" format="date-rel-spec"}}</p>
+
             <h4>Relative date event in the future:</h4>
             <code>{{{{raw}}}} {{_dateRel 7 unit="hour"}} {{{{/raw}}}}</code>
             <p>&#x2192; {{_dateRel 7 unit="hour"}}</p>
@@ -226,15 +242,7 @@
             <code>{{{{raw}}}} {{_dateRel 7 unit="hour"}} {{{{/raw}}}}</code>
             <p>&#x2192; {{_dateRel -7 unit="hour"}}</p>
 
-            <h4>Date difference:</h4>
-            <code>{{{{raw}}}} {{_dateDiff "1996-12-07T00:00:00" "1996-12-08T00:00:00" unit="day"}} {{{{/raw}}}}</code>
-            <p>&#x2192; {{_dateDiff "1996-12-07T00:00:00" "1996-12-08T00:00:00" unit="day"}}</p>
-
-            <h4>Date difference by custom configuration (subset "date-rel-spec"):</h4>
-            <code>{{{{raw}}}} {{_dateDiff mydate "1995-12-17T00:00:00" format="date-rel-spec"}} {{{{/raw}}}}</code>
-            <p>&#x2192; {{_dateDiff mydate "1995-12-17T00:00:00" format="date-rel-spec"}}</p>
-
-            <p>&nbsp;</p><button onclick="changeLang()">{{__ "key0"}} {{#if (localeIs "en")}}German {{else}}Englisch {{/if}}</button>`;
+            <button onclick="changeLang()">{{__ "key0"}} {{#if (localeIs "en")}}German {{else}}Englisch {{/if}}</button>`;
 
         // -- Ignore this. It’s just a helper to display un-rendered {{handlebars code}} between the <code> Tags
         Handlebars.registerHelper('raw', function(options) {

package/examples/node-example/simple-example.js

@@ -18,9 +18,9 @@ const htmlEntities = require('html-entities');
 // -- The translation phrases for i18next
 i18next
   .init({
-    resources : {
-      'en' : {
-        translation : {
+    resources: {
+      'en': {
+        translation: {
           'key0': 'Change Language to',
           'key1': 'What is good?',
           'key2': '{{what}} is good.',
@@ -29,7 +29,7 @@ i18next
           'key4': 'Selected Language is:'
         }
       },
-      'de' : {
+      'de': {
         translation: {
           'key0': 'Sprache wechseln zu',
           'key1': 'Was ist gut?',
@@ -40,16 +40,16 @@ i18next
         }
       }
     },
-    lng : 'en',
+    lng: 'en',
     compatibilityJSON: 'v2'
   });
 
 // -- Handlebars' example data object
 let data = {
-  sayWhat : 'handlebars-i18n',
-  holdKey3 : 'key3WithCount',
-  holdKey4 : 'key4',
-  mynumber : 33.333,
+  sayWhat: 'handlebars-i18n',
+  holdKey3: 'key3WithCount',
+  holdKey4: 'key4',
+  mynumber: 33.333,
   myMmaxDigits: 1,
   myPrice: 12.99,
   myDate: '2020-03-11T03:24:00'
@@ -59,23 +59,30 @@ let data = {
 HandlebarsI18n.init();
 HandlebarsI18n.configure([
   // generic configuration for all languages for number representation:
-  ['all', 'NumberFormat', { minimumFractionDigits: 2 }],
+  ['all', 'NumberFormat', {minimumFractionDigits: 2}],
   // generic configurations per language for price representation:
-  ['en', 'PriceFormat', { currency: 'USD'}],
-  ['de', 'PriceFormat', { currency: 'EUR'}],
+  ['en', 'PriceFormat', {currency: 'USD'}],
+  ['de', 'PriceFormat', {currency: 'EUR'}],
   // generic configurations per language for date representation:
-  ['en', 'DateTimeFormat', { year:'numeric', month:'long', day:'numeric', hour:'numeric', minute:'numeric'}],
-  ['de', 'DateTimeFormat', { year:'numeric', month:'numeric', day:'numeric', hour:'numeric', minute:'numeric', hour12:false}],
+  ['en', 'DateTimeFormat', {year: 'numeric', month: 'long', day: 'numeric', hour: 'numeric', minute: 'numeric'}],
+  ['de', 'DateTimeFormat', {
+    year: 'numeric',
+    month: 'numeric',
+    day: 'numeric',
+    hour: 'numeric',
+    minute: 'numeric',
+    hour12: false
+  }],
   // configurations per language with custom formats for date:
-  ['en', 'DateTimeFormat', { year:'numeric' }, 'custom-year-only'],
-  ['de', 'DateTimeFormat', { year:'numeric' }, 'custom-year-only'],
-  ['en', 'DateTimeFormat', { year:'numeric', month:'numeric', day:'numeric' }, 'custom-date-short'],
-  ['de', 'DateTimeFormat', { year:'numeric', month:'numeric', day:'numeric' }, 'custom-date-short'],
-  ['en', 'DateTimeFormat', { hour:'numeric', minute:'numeric', second:'numeric', hour12:false}, 'custom-time'],
-  ['de', 'DateTimeFormat', { hour:'numeric', minute:'numeric', second:'numeric', hour12:false}, 'custom-time'],
+  ['en', 'DateTimeFormat', {year: 'numeric'}, 'custom-year-only'],
+  ['de', 'DateTimeFormat', {year: 'numeric'}, 'custom-year-only'],
+  ['en', 'DateTimeFormat', {year: 'numeric', month: 'numeric', day: 'numeric'}, 'custom-date-short'],
+  ['de', 'DateTimeFormat', {year: 'numeric', month: 'numeric', day: 'numeric'}, 'custom-date-short'],
+  ['en', 'DateTimeFormat', {hour: 'numeric', minute: 'numeric', second: 'numeric', hour12: false}, 'custom-time'],
+  ['de', 'DateTimeFormat', {hour: 'numeric', minute: 'numeric', second: 'numeric', hour12: false}, 'custom-time'],
   // custom formats for relative dates:
-  ['en', 'RelativeTimeFormat', { style: 'short', unit: 'year' }, 'date-rel-spec'],
-  ['de', 'RelativeTimeFormat', { style: 'short', unit: 'year' }, 'date-rel-spec']
+  ['en', 'RelativeTimeFormat', {style: 'short', unit: 'year'}, 'date-rel-spec'],
+  ['de', 'RelativeTimeFormat', {style: 'short', unit: 'year'}, 'date-rel-spec']
 ]);
 
 let template;
@@ -120,107 +127,116 @@ template += '{{__ "key1" lng="de"}}';
 // ----------------------------------------
 
 // Translation key given through handlebars variable and _locale output:
-template += raw('{{__ holdKey4}} {{_locale}}');
-template += '{{__ holdKey4}} {{_locale}}';
+  template += raw('{{__ holdKey4}} {{_locale}}');
+  template += '{{__ holdKey4}} {{_locale}}';
 
 // Check against selected language:
-template += raw('{{#if (localeIs "en")}}English {{else}}Deutsch {{/if}}');
-template += '{{#if (localeIs "en")}}English {{else}}Deutsch {{/if}}';
+  template += raw('{{#if (localeIs "en")}}English {{else}}Deutsch {{/if}}');
+  template += '{{#if (localeIs "en")}}English {{else}}Deutsch {{/if}}';
 
 
 // Number representation
 // ----------------------------------------
 
 // Number representation as configured for all languages:
-template += raw('{{_num 7000}}');
-template += '{{_num 7000}}';
+  template += raw('{{_num 7000}}');
+  template += '{{_num 7000}}';
 
 // Number representation with specific format attribute:
-template += raw('{{_num 3.1415926 maximumFractionDigits=0}}');
-template += '{{_num 3.1415926 maximumFractionDigits=0}}';
+  template += raw('{{_num 3.1415926 maximumFractionDigits=0}}');
+  template += '{{_num 3.1415926 maximumFractionDigits=0}}';
 
 // Number and attribute given through handlebars variables:
-template += raw('{{_num mynumber maximumFractionDigits=myMaxDigits}}');
-template += '{{_num mynumber maximumFractionDigits=myMaxDigits}}';
+  template += raw('{{_num mynumber maximumFractionDigits=myMaxDigits}}');
+  template += '{{_num mynumber maximumFractionDigits=myMaxDigits}}';
 
 
 // Price representation
 // ----------------------------------------
 
 // Price representation as configured per language:
-template += raw('{{_price 9999.99}}');
-template += '{{_price 9999.99}}';
+  template += raw('{{_price 9999.99}}');
+  template += '{{_price 9999.99}}';
 
 // Price representation with specific format attributes:
-template += raw('{{_price 1000.99 currency="JPY" minimumFractionDigits=0}}');
-template += '{{_price 1000.99 currency="JPY" minimumFractionDigits=0}}';
+  template += raw('{{_price 1000.99 currency="JPY" minimumFractionDigits=0}}');
+  template += '{{_price 1000.99 currency="JPY" minimumFractionDigits=0}}';
 
 // Price given through handlebars variable and with specific format attribute:
-template += raw('{{_price myPrice currency="DKK"}}');
-template += '{{_price myPrice currency="DKK"}}';
+  template += raw('{{_price myPrice currency="DKK"}}');
+  template += '{{_price myPrice currency="DKK"}}';
 
 
 // Date representation
 // ----------------------------------------
 
 // Todays’ date as configured per language:
-template += raw('{{_date}}');
-template += '{{_date}}';
+  template += raw('{{_date}}');
+  template += '{{_date}}';
 
 // Date given as date string:
-template += raw('{{_date "2020-03-11T03:24:00"}}');
-template += '{{_date "2020-03-11T03:24:00"}}';
+  template += raw('{{_date "2020-03-11T03:24:00"}}');
+  template += '{{_date "2020-03-11T03:24:00"}}';
 
 // Date given in milliseconds since begin of unix epoch:
-template += raw('{{_date 1583922952743}}');
-template += '{{_date 1583922952743}}';
+  template += raw('{{_date 1583922952743}}');
+  template += '{{_date 1583922952743}}';
 
 // Date given as javascript date parameter array:
-template += raw('{{_date "[2012, 11, 20, 3, 0, 0]"}}');
-template += '{{_date "[2012, 11, 20, 3, 0, 0]"}}';
+  template += raw('{{_date "[2012, 11, 20, 3, 0, 0]"}}');
+  template += '{{_date "[2012, 11, 20, 3, 0, 0]"}}';
 
 // Todays’ date with specific format attributes:
-template += raw('{{_date "today" year="2-digit" month="2-digit" day="2-digit"}}');
-template += '{{_date "today" year="2-digit" month="2-digit" day="2-digit"}}';
+  template += raw('{{_date "today" year="2-digit" month="2-digit" day="2-digit"}}');
+  template += '{{_date "today" year="2-digit" month="2-digit" day="2-digit"}}';
 
 // Date given through handlebars variable:
-template += raw('{{_date myDate}}');
-template += '{{_date myDate}}';
+  template += raw('{{_date myDate}}');
+  template += '{{_date myDate}}';
 
 // Date formatted by custom configuration (subset "custom-year-only"):
-template += raw('{{_date myDate format="custom-year-only"}}');
-template += '{{_date myDate format="custom-year-only"}}';
+  template += raw('{{_date myDate format="custom-year-only"}}');
+  template += '{{_date myDate format="custom-year-only"}}';
 
 // Date formatted by custom configuration (subset "custom-date-short"):
-template += raw('{{_date myDate format="custom-date-short"}}');
-template += '{{_date myDate format="custom-date-short"}}';
+  template += raw('{{_date myDate format="custom-date-short"}}');
+  template += '{{_date myDate format="custom-date-short"}}';
 
 // Date formatted by custom configuration (subset "custom-date-short"):
-template += raw('{{_date myDate format="custom-time"}}');
-template += '{{_date myDate format="custom-time"}}';
+  template += raw('{{_date myDate format="custom-time"}}');
+  template += '{{_date myDate format="custom-time"}}';
 
 // Relative date representation
 // ----------------------------------------
 
+// Date with positive time offset:
+  template += raw('{{_dateAdd "December 17, 1995 08:00:00" 24 unit="hour"}}');
+  template += '{{_dateAdd "December 17, 1995 08:00:00" 24 unit="hour"}}';
+
+// Date with negative time offset:
+  template += raw('{{_dateAdd "December 17, 1995" -10 unit="day"}}');
+  template += '{{_dateAdd "December 17, 1995" -10 unit="day"}}';
+
+// Relative difference between two dates:
+  template += raw('{{_dateDiff "1996-12-07T00:00:00" "1996-12-08T00:00:00" unit="day"}}');
+  template += '{{_dateDiff "1996-12-07T00:00:00" "1996-12-08T00:00:00" unit="day"}}';
+
+// Relative difference between two dates with custom configuration (subset "date-rel-spec"):
+  template += raw('{{_dateDiff myDate "1995-12-17T00:00:00" format="date-rel-spec"}}');
+  template += '{{_dateDiff myDate "1995-12-17T00:00:00" format="date-rel-spec"}}';
+
 // Relative date event in the future:
-template += raw('{{_dateRel 7 unit="hour"}}');
-template += '{{_dateRel 7 unit="hour"}}';
+  template += raw('{{_dateRel 7 unit="hour"}}');
+  template += '{{_dateRel 7 unit="hour"}}';
 
 // Relative date event in the past:
-template += raw('{{_dateRel -7 unit="hour"}}');
-template += '{{_dateRel -7 unit="hour"}}';
-
-// Date difference:
-template += raw('{{_dateDiff "1996-12-07T00:00:00" "1996-12-08T00:00:00" unit="day"}}');
-template += '{{_dateDiff "1996-12-07T00:00:00" "1996-12-08T00:00:00" unit="day"}}';
+  template += raw('{{_dateRel -7 unit="hour"}}');
+  template += '{{_dateRel -7 unit="hour"}}';
 
-// Date difference by custom configuration (subset "date-rel-spec"):
-template += raw('{{_dateDiff mydate "1995-12-17T00:00:00" format="date-rel-spec"}}');
-template += '{{_dateDiff mydate "1995-12-17T00:00:00" format="date-rel-spec"}}';
+  const compiled = Handlebars.compile(template);
 
+  i18next.changeLanguage('de'); // --> Test the changes by replacing 'de' with 'en'
 
-const compiled = Handlebars.compile(template);
-i18next.changeLanguage('de'); // --> Test the changes by replacing 'de' with 'en'
-const decoded = htmlEntities.decode(compiled(data));
+  const decoded = htmlEntities.decode(compiled(data));
 
-console.log('\x1b[36m%s\x1b[0m', decoded);
+  console.log('\x1b[36m%s\x1b[0m', decoded);

package/examples/typescript/test.hbs

@@ -86,14 +86,20 @@ HandlebarsI18n example output from TS:
 // Relative date representation
 // ----------------------------------------
 
-// Relative date event in the future:
-{{_dateRel 7 unit="hour"}}
+// Date with positive time offset:
+{{_dateAdd "December 17, 1995 08:00:00" 24 unit="hour"}}
 
-// Relative date event in the past:
-{{_dateRel -7 unit="hour"}}
+// Date with negative time offset:
+{{_dateAdd "December 17, 1995" -10 unit="day"}}
 
-// Date difference:
+// Relative difference between two dates:
 {{_dateDiff "1996-12-07T00:00:00" "1996-12-08T00:00:00" unit="day"}}
 
-// Date difference by custom configuration (subset "date-rel-spec"):
-{{_dateDiff mydate "1995-12-17T00:00:00" format="date-rel-spec"}}
+// Relative difference between two dates with custom configuration (subset "date-rel-spec"):
+{{_dateDiff myDate "1995-12-17T00:00:00" format="date-rel-spec"}}
+
+// Relative date event in the future:
+{{_dateRel 7 unit="hour"}}
+
+// Relative date event in the past:
+{{_dateRel -7 unit="hour"}}