A newer version of this documentation is available.

View Latest

Function/Benchmark: fasterToLocalString

      +

      Goal: Explore faster local time zone date formating.

      • This function fasterToLocalString demonstrates a faster alternative to the built-in JavaScript function toLocalString.

      • In Couchbase 6.6.0 the fasterToLocalString implementation is 708X faster than the v8 runner.

      • In Couchbase 7.0.0 the fasterToLocalString implementation is 177X faster than the upgraded v8 runner.

      • The above demonstrates that all date conversions should be benchmarked.

      • Requires Eventing Storage (or metadata collection) and a "source" collection.

      • Will operate on any mutation where doc.type === "basic_bkt_ops".

      • Deploy from now

      • Only mutate one document as this is a benchmark of ICU performance.

      • fasterToLocalString

      • Input Data/Mutation

      • Output Data/Logged

      // To run configure the settings for this Function, docControlledSelfExpiry, as follows:
      //
      // Version 7.0+
      //   "Listen to Location"
      //     bulk.data.source
      //   "Eventing Storage"
      //     rr100.eventing.metadata
      //   Binding(s) - none
      //
      // Version 6.X
      //   "Source Bucket"
      //     source
      //   "MetaData Bucket"
      //     metadata
      //   Binding(s) - none
      
      function fasterToLocalString(d) {
          // adjust the input date by the UTC offset
          var dadj = new Date(d.getTime() - d.getTimezoneOffset() * 60 * 1000);
          var hr = dadj.getUTCHours();
          var min = dadj.getUTCMinutes();
          var sec = dadj.getUTCSeconds();
          var strLocalDate = (dadj.getUTCMonth()+1) + "/" + dadj.getUTCDate() + "/" + dadj.getUTCFullYear() + ", " +
              ((hr < 13) ? hr : (hr - 12)) + ":" +
              ((min<10) ? "0"+min : min) + ":" +
              ((sec<10) ? "0"+sec : sec) +
              ((hr < 12) ? " AM" : " PM");
          // should be the same as d.toLocaleString('en-US')
          return strLocalDate;
      }
      
      function OnUpdate(doc, meta) {
          var cnt = 20000;
          var d = new Date();
          var tbeg, tend;
      
          if (true) {
              // This crash a debug session refer to eventing-debugging-and-diagnosability.html
              // however it always work in no-debug but is very slow.
              tbeg = Date.now();
              for (var i=1; i<=cnt; i++) {
                  var res = d.toLocaleString('en-US');
                  if (i % cnt == 0)
                      log("d.toLocaleString('en-US') ",res);
              }
              tend = Date.now();
              log("d.toLocaleString('en-US') ", tend-tbeg + " ms.");
          }
      
          if (true) {
              tbeg = Date.now();
              for (var i=1; i<=cnt; i++) {
                  var res = fasterToLocalString(d);
                  if (i % cnt == 0)
                      log("fasterToLocalString(d)   ",res);
              }
              tend = Date.now();
              log("fasterToLocalString(d)   ", tend-tbeg + " ms.");
          }
      }
      Create/Mutate any single document in the source collection

      This below messages are from the Application log in the file system (the UI would display the messages in reverse order)

      6.6.0
      2020-09-16T18:40:48.430-07:00 [INFO] "d.toLocaleString('en-US') " "9/16/2020, 6:40:32 PM"
      2020-09-16T18:40:48.430-07:00 [INFO] "d.toLocaleString('en-US') " "16299 ms."
      2020-09-16T18:40:48.453-07:00 [INFO] "fasterToLocalString(d)   " "9/16/2020, 6:40:32 PM"
      2020-09-16T18:40:48.453-07:00 [INFO] "fasterToLocalString(d)   " "23 ms."
      
      7.0.0
      2021-07-19T11:22:35.937-07:00 [INFO] "d.toLocaleString('en-US') " "7/19/2021, 11:22:31 AM"
      2021-07-19T11:22:35.937-07:00 [INFO] "d.toLocaleString('en-US') " "4090 ms."
      2021-07-19T11:22:35.960-07:00 [INFO] "fasterToLocalString(d)   " "7/19/2021, 11:22:31 AM"
      2021-07-19T11:22:35.960-07:00 [INFO] "fasterToLocalString(d)   " "23 ms."

      The above was run on a single Eventing node 12 cores at 2.2 GHz, shows that the v8 runner is not performant for the built-in function toLocaleString. In Couchbase 6.6.0 the fasterToLocalString implementation is 708X faster than the v8 runner. In Couchbase 7.0.0 the fasterToLocalString implementation is 177X faster than the v8 runner.