@opentelemetry/core/dist/common/time.mjs.map

OpenTelemetry Core provides constants and utilities shared by all OpenTelemetry SDK packages.

{"version":3,"file":"time.mjs","names":[],"sources":["../../src/common/time.ts"],"sourcesContent":["/*\n * Copyright The OpenTelemetry Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type * as api from '@opentelemetry/api';\n\nconst NANOSECOND_DIGITS = 9;\nconst NANOSECOND_DIGITS_IN_MILLIS = 6;\nconst MILLISECONDS_TO_NANOSECONDS = Math.pow(10, NANOSECOND_DIGITS_IN_MILLIS);\nconst SECOND_TO_NANOSECONDS = Math.pow(10, NANOSECOND_DIGITS);\n\n/**\n * Converts a number of milliseconds from epoch to HrTime([seconds, remainder in nanoseconds]).\n * @param epochMillis\n */\nexport function millisToHrTime(epochMillis: number): api.HrTime {\n  const epochSeconds = epochMillis / 1000;\n  // Decimals only.\n  const seconds = Math.trunc(epochSeconds);\n  // Round sub-nanosecond accuracy to nanosecond.\n  const nanos = Math.round((epochMillis % 1000) * MILLISECONDS_TO_NANOSECONDS);\n  return [seconds, nanos];\n}\n\n/**\n * Returns an hrtime calculated via performance component.\n * @param performanceNow\n */\nexport function hrTime(performanceNow?: number): api.HrTime {\n  const timeOrigin = millisToHrTime(performance.timeOrigin);\n  const now = millisToHrTime(\n    typeof performanceNow === 'number' ? performanceNow : performance.now()\n  );\n\n  return addHrTimes(timeOrigin, now);\n}\n\n/**\n *\n * Converts a TimeInput to an HrTime, defaults to _hrtime().\n * @param time\n */\nexport function timeInputToHrTime(time: api.TimeInput): api.HrTime {\n  // process.hrtime\n  if (isTimeInputHrTime(time)) {\n    return time as api.HrTime;\n  } else if (typeof time === 'number') {\n    // Distinguish between a relative performance.now() value and an absolute\n    // epoch-millisecond timestamp.\n    //\n    // performance.timeOrigin uses a monotonic clock that may be slightly ahead\n    // of Date.now() due to clock adjustments (see MDN docs). This means a\n    // real epoch-ms value (e.g. Date.now()) can land just below\n    // performance.timeOrigin, causing it to be misclassified as a relative\n    // performance.now() reading and doubled when timeOrigin is added.\n    //\n    // A genuine performance.now() value represents elapsed time since the\n    // document/process started, so it is bounded by system uptime. No real\n    // system has been running long enough for performance.now() to reach half\n    // the current epoch time (~1994 in ms terms). We therefore treat any value\n    // below half of performance.timeOrigin as a relative performance.now()\n    // reading, and everything else as an absolute epoch-millisecond timestamp.\n    if (time < performance.timeOrigin / 2) {\n      return hrTime(time);\n    } else {\n      // epoch milliseconds or performance.timeOrigin\n      return millisToHrTime(time);\n    }\n  } else if (time instanceof Date) {\n    return millisToHrTime(time.getTime());\n  } else {\n    throw TypeError('Invalid input type');\n  }\n}\n\n/**\n * Returns a duration of two hrTime.\n * @param startTime\n * @param endTime\n */\nexport function hrTimeDuration(\n  startTime: api.HrTime,\n  endTime: api.HrTime\n): api.HrTime {\n  let seconds = endTime[0] - startTime[0];\n  let nanos = endTime[1] - startTime[1];\n\n  // overflow\n  if (nanos < 0) {\n    seconds -= 1;\n    // negate\n    nanos += SECOND_TO_NANOSECONDS;\n  }\n\n  return [seconds, nanos];\n}\n\n/**\n * Convert hrTime to timestamp, for example \"2019-05-14T17:00:00.000123456Z\"\n * @param time\n */\nexport function hrTimeToTimeStamp(time: api.HrTime): string {\n  const precision = NANOSECOND_DIGITS;\n  const tmp = `${'0'.repeat(precision)}${time[1]}Z`;\n  const nanoString = tmp.substring(tmp.length - precision - 1);\n  const date = new Date(time[0] * 1000).toISOString();\n  return date.replace('000Z', nanoString);\n}\n\n/**\n * Convert hrTime to nanoseconds.\n * @param time\n */\nexport function hrTimeToNanoseconds(time: api.HrTime): number {\n  return time[0] * SECOND_TO_NANOSECONDS + time[1];\n}\n\n/**\n * Convert hrTime to microseconds.\n * @param time\n */\nexport function hrTimeToMicroseconds(time: api.HrTime): number {\n  return time[0] * 1e6 + time[1] / 1e3;\n}\n\n/**\n * Convert hrTime to milliseconds.\n * @param time\n */\nexport function hrTimeToMilliseconds(time: api.HrTime): number {\n  return time[0] * 1e3 + time[1] / 1e6;\n}\n\n/**\n * Convert hrTime to seconds.\n * @param time\n */\nexport function hrTimeToSeconds(time: api.HrTime): number {\n  return time[0] + time[1] / SECOND_TO_NANOSECONDS;\n}\n/**\n * check if time is HrTime\n * @param value\n */\nexport function isTimeInputHrTime(value: unknown): value is api.HrTime {\n  return (\n    Array.isArray(value) &&\n    value.length === 2 &&\n    typeof value[0] === 'number' &&\n    typeof value[1] === 'number'\n  );\n}\n\n/**\n * check if input value is a correct types.TimeInput\n * @param value\n */\nexport function isTimeInput(\n  value: unknown\n): value is api.HrTime | number | Date {\n  return (\n    isTimeInputHrTime(value) ||\n    typeof value === 'number' ||\n    value instanceof Date\n  );\n}\n\n/**\n * Given 2 HrTime formatted times, return their sum as an HrTime.\n */\nexport function addHrTimes(time1: api.HrTime, time2: api.HrTime): api.HrTime {\n  const out = [time1[0] + time2[0], time1[1] + time2[1]] as api.HrTime;\n\n  // Nanoseconds\n  if (out[1] >= SECOND_TO_NANOSECONDS) {\n    out[1] -= SECOND_TO_NANOSECONDS;\n    out[0] += 1;\n  }\n\n  return out;\n}\n"],"mappings":";AAOA,MAAM,oBAAoB;AAE1B,MAAM,8BAA8B,KAAK,IAAI,IAAI,CAA2B;AAC5E,MAAM,wBAAwB,KAAK,IAAI,IAAI,iBAAiB;;;;;AAM5D,SAAgB,eAAe,aAAiC;CAC9D,MAAM,eAAe,cAAc;CAKnC,OAAO,CAHS,KAAK,MAAM,YAGb,GADA,KAAK,MAAO,cAAc,MAAQ,2BAC3B,CAAC;AACxB;;;;;AAMA,SAAgB,OAAO,gBAAqC;CAM1D,OAAO,WALY,eAAe,YAAY,UAKnB,GAJf,eACV,OAAO,mBAAmB,WAAW,iBAAiB,YAAY,IAAI,CAGxC,CAAC;AACnC;;;;;;AAOA,SAAgB,kBAAkB,MAAiC;CAEjE,IAAI,kBAAkB,IAAI,GACxB,OAAO;MACF,IAAI,OAAO,SAAS,UAAU;EAgBnC,IAAI,OAAO,YAAY,aAAa,GAClC,OAAO,OAAO,IAAI;OAGlB,OAAO,eAAe,IAAI;CAE9B,OAAO,IAAI,gBAAgB,MACzB,OAAO,eAAe,KAAK,QAAQ,CAAC;MAEpC,MAAM,UAAU,oBAAoB;AAExC;;;;;;AAOA,SAAgB,eACd,WACA,SACY;CACZ,IAAI,UAAU,QAAQ,KAAK,UAAU;CACrC,IAAI,QAAQ,QAAQ,KAAK,UAAU;CAGnC,IAAI,QAAQ,GAAG;EACb,WAAW;EAEX,SAAS;CACX;CAEA,OAAO,CAAC,SAAS,KAAK;AACxB;;;;;AAMA,SAAgB,kBAAkB,MAA0B;CAC1D,MAAM,YAAY;CAClB,MAAM,MAAM,GAAG,IAAI,OAAO,SAAS,IAAI,KAAK,GAAG;CAC/C,MAAM,aAAa,IAAI,UAAU,IAAI,SAAS,YAAY,CAAC;CAE3D,wBADa,IAAI,KAAK,KAAK,KAAK,GAAI,EAAA,CAAE,YAC5B,CAAC,CAAC,QAAQ,QAAQ,UAAU;AACxC;;;;;AAMA,SAAgB,oBAAoB,MAA0B;CAC5D,OAAO,KAAK,KAAK,wBAAwB,KAAK;AAChD;;;;;AAMA,SAAgB,qBAAqB,MAA0B;CAC7D,OAAO,KAAK,KAAK,MAAM,KAAK,KAAK;AACnC;;;;;AAMA,SAAgB,qBAAqB,MAA0B;CAC7D,OAAO,KAAK,KAAK,MAAM,KAAK,KAAK;AACnC;;;;;AAMA,SAAgB,gBAAgB,MAA0B;CACxD,OAAO,KAAK,KAAK,KAAK,KAAK;AAC7B;;;;;AAKA,SAAgB,kBAAkB,OAAqC;CACrE,OACE,MAAM,QAAQ,KAAK,KACnB,MAAM,WAAW,KACjB,OAAO,MAAM,OAAO,YACpB,OAAO,MAAM,OAAO;AAExB;;;;;AAMA,SAAgB,YACd,OACqC;CACrC,OACE,kBAAkB,KAAK,KACvB,OAAO,UAAU,YACjB,iBAAiB;AAErB;;;;AAKA,SAAgB,WAAW,OAAmB,OAA+B;CAC3E,MAAM,MAAM,CAAC,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,MAAM,EAAE;CAGrD,IAAI,IAAI,MAAM,uBAAuB;EACnC,IAAI,MAAM;EACV,IAAI,MAAM;CACZ;CAEA,OAAO;AACT"}