@wordpress/date 5.31.1-next.f56bd8138.0 → 5.32.1-next.47f435fc9.0

package/build/index.js

@@ -1,145 +1,137 @@
 "use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-var _exportNames = {
-  setSettings: true,
-  getSettings: true,
-  __experimentalGetSettings: true,
-  format: true,
-  date: true,
-  gmdate: true,
-  dateI18n: true,
-  gmdateI18n: true,
-  isInTheFuture: true,
-  getDate: true,
-  humanTimeDiff: true
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
 };
-exports.__experimentalGetSettings = __experimentalGetSettings;
-exports.date = date;
-exports.dateI18n = dateI18n;
-exports.format = format;
-exports.getDate = getDate;
-exports.getSettings = getSettings;
-exports.gmdate = gmdate;
-exports.gmdateI18n = gmdateI18n;
-exports.humanTimeDiff = humanTimeDiff;
-exports.isInTheFuture = isInTheFuture;
-exports.setSettings = setSettings;
-var _moment = _interopRequireDefault(require("moment"));
-require("moment-timezone/moment-timezone");
-require("moment-timezone/moment-timezone-utils");
-var _deprecated = _interopRequireDefault(require("@wordpress/deprecated"));
-var _types = require("./types");
-Object.keys(_types).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
-  if (key in exports && exports[key] === _types[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function () {
-      return _types[key];
-    }
-  });
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+__export(index_exports, {
+  __experimentalGetSettings: () => __experimentalGetSettings,
+  date: () => date,
+  dateI18n: () => dateI18n,
+  format: () => format,
+  getDate: () => getDate,
+  getSettings: () => getSettings,
+  gmdate: () => gmdate,
+  gmdateI18n: () => gmdateI18n,
+  humanTimeDiff: () => humanTimeDiff,
+  isInTheFuture: () => isInTheFuture,
+  setSettings: () => setSettings
 });
-/**
- * External dependencies
- */
-
-/**
- * WordPress dependencies
- */
-
-/**
- * Internal dependencies
- */
-
-const WP_ZONE = 'WP';
-
-// This regular expression tests positive for UTC offsets as described in ISO 8601.
-// See: https://en.wikipedia.org/wiki/ISO_8601#Time_offsets_from_UTC
+module.exports = __toCommonJS(index_exports);
+var import_moment = __toESM(require("moment"));
+var import_moment_timezone = require("moment-timezone/moment-timezone");
+var import_moment_timezone_utils = require("moment-timezone/moment-timezone-utils");
+var import_deprecated = __toESM(require("@wordpress/deprecated"));
+__reExport(index_exports, require("./types"), module.exports);
+const WP_ZONE = "WP";
 const VALID_UTC_OFFSET = /^[+-][0-1][0-9](:?[0-9][0-9])?$/;
-
-// Changes made here will likely need to be synced with Core in the file
-// src/wp-includes/script-loader.php in `wp_default_packages_inline_scripts()`.
 let settings = {
   l10n: {
-    locale: 'en',
-    months: ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'],
-    monthsShort: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
-    weekdays: ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'],
-    weekdaysShort: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'],
-    meridiem: {
-      am: 'am',
-      pm: 'pm',
-      AM: 'AM',
-      PM: 'PM'
-    },
+    locale: "en",
+    months: [
+      "January",
+      "February",
+      "March",
+      "April",
+      "May",
+      "June",
+      "July",
+      "August",
+      "September",
+      "October",
+      "November",
+      "December"
+    ],
+    monthsShort: [
+      "Jan",
+      "Feb",
+      "Mar",
+      "Apr",
+      "May",
+      "Jun",
+      "Jul",
+      "Aug",
+      "Sep",
+      "Oct",
+      "Nov",
+      "Dec"
+    ],
+    weekdays: [
+      "Sunday",
+      "Monday",
+      "Tuesday",
+      "Wednesday",
+      "Thursday",
+      "Friday",
+      "Saturday"
+    ],
+    weekdaysShort: ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"],
+    meridiem: { am: "am", pm: "pm", AM: "AM", PM: "PM" },
     relative: {
-      future: '%s from now',
-      past: '%s ago',
-      s: 'a few seconds',
-      ss: '%d seconds',
-      m: 'a minute',
-      mm: '%d minutes',
-      h: 'an hour',
-      hh: '%d hours',
-      d: 'a day',
-      dd: '%d days',
-      M: 'a month',
-      MM: '%d months',
-      y: 'a year',
-      yy: '%d years'
+      future: "%s from now",
+      past: "%s ago",
+      s: "a few seconds",
+      ss: "%d seconds",
+      m: "a minute",
+      mm: "%d minutes",
+      h: "an hour",
+      hh: "%d hours",
+      d: "a day",
+      dd: "%d days",
+      M: "a month",
+      MM: "%d months",
+      y: "a year",
+      yy: "%d years"
     },
     startOfWeek: 0
   },
   formats: {
-    time: 'g: i a',
-    date: 'F j, Y',
-    datetime: 'F j, Y g: i a',
-    datetimeAbbreviated: 'M j, Y g: i a'
+    time: "g: i a",
+    date: "F j, Y",
+    datetime: "F j, Y g: i a",
+    datetimeAbbreviated: "M j, Y g: i a"
   },
-  timezone: {
-    offset: '0',
-    offsetFormatted: '0',
-    string: '',
-    abbr: ''
-  }
+  timezone: { offset: "0", offsetFormatted: "0", string: "", abbr: "" }
 };
-
-/**
- * Adds a locale to moment, using the format supplied by `wp_localize_script()`.
- *
- * @param dateSettings Settings, including locale data.
- */
 function setSettings(dateSettings) {
   settings = dateSettings;
   setupWPTimezone();
-
-  // Does moment already have a locale with the right name?
-  if (_moment.default.locales().includes(dateSettings.l10n.locale)) {
-    // Is that locale misconfigured, e.g. because we are on a site running
-    // WordPress < 6.0?
-    if (_moment.default.localeData(dateSettings.l10n.locale).longDateFormat('LTS') === null) {
-      // Delete the misconfigured locale.
-      // @ts-ignore Type definitions are incorrect - null is permitted.
-      _moment.default.defineLocale(dateSettings.l10n.locale, null);
+  if (import_moment.default.locales().includes(dateSettings.l10n.locale)) {
+    if (import_moment.default.localeData(dateSettings.l10n.locale).longDateFormat("LTS") === null) {
+      import_moment.default.defineLocale(dateSettings.l10n.locale, null);
     } else {
-      // We have a properly configured locale, so no need to create one.
       return;
     }
   }
-
-  // defineLocale() will modify the current locale, so back it up.
-  const currentLocale = _moment.default.locale();
-
-  // Create locale.
-  _moment.default.defineLocale(dateSettings.l10n.locale, {
+  const currentLocale = import_moment.default.locale();
+  import_moment.default.defineLocale(dateSettings.l10n.locale, {
     // Inherit anything missing from English. We don't load
     // moment-with-locales.js so English is all there is.
-    parentLocale: 'en',
+    parentLocale: "en",
     months: dateSettings.l10n.months,
     monthsShort: dateSettings.l10n.monthsShort,
     weekdays: dateSettings.l10n.weekdays,
@@ -152,100 +144,60 @@ function setSettings(dateSettings) {
     },
     longDateFormat: {
       LT: dateSettings.formats.time,
-      LTS: _moment.default.localeData('en').longDateFormat('LTS'),
-      L: _moment.default.localeData('en').longDateFormat('L'),
+      LTS: import_moment.default.localeData("en").longDateFormat("LTS"),
+      L: import_moment.default.localeData("en").longDateFormat("L"),
       LL: dateSettings.formats.date,
       LLL: dateSettings.formats.datetime,
-      LLLL: _moment.default.localeData('en').longDateFormat('LLLL')
+      LLLL: import_moment.default.localeData("en").longDateFormat("LLLL")
     },
     // From human_time_diff?
     // Set to `(number, withoutSuffix, key, isFuture) => {}` instead.
     relativeTime: dateSettings.l10n.relative
   });
-
-  // Restore the locale to what it was.
-  _moment.default.locale(currentLocale);
+  import_moment.default.locale(currentLocale);
 }
-
-/**
- * Returns the currently defined date settings.
- *
- * @return {DateSettings} Settings, including locale data.
- */
 function getSettings() {
   return settings;
 }
-
-/**
- * Returns the currently defined date settings.
- *
- * @deprecated
- * @return {DateSettings} Settings, including locale data.
- */
 function __experimentalGetSettings() {
-  (0, _deprecated.default)('wp.date.__experimentalGetSettings', {
-    since: '6.1',
-    alternative: 'wp.date.getSettings'
+  (0, import_deprecated.default)("wp.date.__experimentalGetSettings", {
+    since: "6.1",
+    alternative: "wp.date.getSettings"
   });
   return getSettings();
 }
 function setupWPTimezone() {
-  // Get the current timezone settings from the WP timezone string.
-  const currentTimezone = _moment.default.tz.zone(settings.timezone.string);
-
-  // Check to see if we have a valid TZ data, if so, use it for the custom WP_ZONE timezone, otherwise just use the offset.
+  const currentTimezone = import_moment.default.tz.zone(settings.timezone.string);
   if (currentTimezone) {
-    // Create WP timezone based off settings.timezone.string.  We need to include the additional data so that we
-    // don't lose information about daylight savings time and other items.
-    // See https://github.com/WordPress/gutenberg/pull/48083
-    _moment.default.tz.add(_moment.default.tz.pack({
-      name: WP_ZONE,
-      abbrs: currentTimezone.abbrs,
-      untils: currentTimezone.untils,
-      offsets: currentTimezone.offsets
-    }));
+    import_moment.default.tz.add(
+      import_moment.default.tz.pack({
+        name: WP_ZONE,
+        abbrs: currentTimezone.abbrs,
+        untils: currentTimezone.untils,
+        offsets: currentTimezone.offsets
+      })
+    );
   } else {
-    // Create WP timezone based off dateSettings.
-    _moment.default.tz.add(_moment.default.tz.pack({
-      name: WP_ZONE,
-      abbrs: [WP_ZONE],
-      untils: [null],
-      offsets: [-settings.timezone.offset * 60 || 0]
-    }));
+    import_moment.default.tz.add(
+      import_moment.default.tz.pack({
+        name: WP_ZONE,
+        abbrs: [WP_ZONE],
+        untils: [null],
+        offsets: [-settings.timezone.offset * 60 || 0]
+      })
+    );
   }
 }
-
-// Date constants.
-/**
- * Number of seconds in one minute.
- */
 const MINUTE_IN_SECONDS = 60;
-/**
- * Number of minutes in one hour.
- */
 const HOUR_IN_MINUTES = 60;
-/**
- * Number of seconds in one hour.
- */
 const HOUR_IN_SECONDS = 60 * MINUTE_IN_SECONDS;
-
-/**
- * Map of PHP formats to Moment.js formats.
- *
- * These are used internally by {@link format}, and are either
- * a string representing the corresponding Moment.js format code, or a
- * function which returns the formatted string.
- *
- * This should only be used through {@link format}, not
- * directly.
- */
 const formatMap = {
   // Day.
-  d: 'DD',
-  D: 'ddd',
-  j: 'D',
-  l: 'dddd',
-  N: 'E',
+  d: "DD",
+  D: "ddd",
+  j: "D",
+  l: "dddd",
+  N: "E",
   /**
    * Gets the ordinal suffix.
    *
@@ -254,12 +206,11 @@ const formatMap = {
    * @return Formatted date.
    */
   S(momentDate) {
-    // Do - D.
-    const num = momentDate.format('D');
-    const withOrdinal = momentDate.format('Do');
-    return withOrdinal.replace(num, '');
+    const num = momentDate.format("D");
+    const withOrdinal = momentDate.format("Do");
+    return withOrdinal.replace(num, "");
   },
-  w: 'd',
+  w: "d",
   /**
    * Gets the day of the year (zero-indexed).
    *
@@ -268,16 +219,15 @@ const formatMap = {
    * @return Formatted date.
    */
   z(momentDate) {
-    // DDD - 1.
-    return (parseInt(momentDate.format('DDD'), 10) - 1).toString();
+    return (parseInt(momentDate.format("DDD"), 10) - 1).toString();
   },
   // Week.
-  W: 'W',
+  W: "W",
   // Month.
-  F: 'MMMM',
-  m: 'MM',
-  M: 'MMM',
-  n: 'M',
+  F: "MMMM",
+  m: "MM",
+  M: "MMM",
+  n: "M",
   /**
    * Gets the days in the month.
    *
@@ -297,14 +247,14 @@ const formatMap = {
    * @return Formatted date.
    */
   L(momentDate) {
-    return momentDate.isLeapYear() ? '1' : '0';
+    return momentDate.isLeapYear() ? "1" : "0";
   },
-  o: 'GGGG',
-  Y: 'YYYY',
-  y: 'YY',
+  o: "GGGG",
+  Y: "YYYY",
+  y: "YY",
   // Time.
-  a: 'a',
-  A: 'A',
+  a: "a",
+  A: "A",
   /**
    * Gets the current time in Swatch Internet Time (.beats).
    *
@@ -313,22 +263,23 @@ const formatMap = {
    * @return Formatted date.
    */
   B(momentDate) {
-    const timezoned = (0, _moment.default)(momentDate).utcOffset(60);
-    const seconds = parseInt(timezoned.format('s'), 10),
-      minutes = parseInt(timezoned.format('m'), 10),
-      hours = parseInt(timezoned.format('H'), 10);
-    return parseInt(((seconds + minutes * MINUTE_IN_SECONDS + hours * HOUR_IN_SECONDS) / 86.4).toString(), 10);
+    const timezoned = (0, import_moment.default)(momentDate).utcOffset(60);
+    const seconds = parseInt(timezoned.format("s"), 10), minutes = parseInt(timezoned.format("m"), 10), hours = parseInt(timezoned.format("H"), 10);
+    return parseInt(
+      ((seconds + minutes * MINUTE_IN_SECONDS + hours * HOUR_IN_SECONDS) / 86.4).toString(),
+      10
+    );
   },
-  g: 'h',
-  G: 'H',
-  h: 'hh',
-  H: 'HH',
-  i: 'mm',
-  s: 'ss',
-  u: 'SSSSSS',
-  v: 'SSS',
+  g: "h",
+  G: "H",
+  h: "hh",
+  H: "HH",
+  i: "mm",
+  s: "ss",
+  u: "SSSSSS",
+  v: "SSS",
   // Timezone.
-  e: 'zz',
+  e: "zz",
   /**
    * Gets whether the timezone is in DST currently.
    *
@@ -337,11 +288,11 @@ const formatMap = {
    * @return Formatted date.
    */
   I(momentDate) {
-    return momentDate.isDST() ? '1' : '0';
+    return momentDate.isDST() ? "1" : "0";
   },
-  O: 'ZZ',
-  P: 'Z',
-  T: 'z',
+  O: "ZZ",
+  P: "Z",
+  T: "z",
   /**
    * Gets the timezone offset in seconds.
    *
@@ -350,14 +301,13 @@ const formatMap = {
    * @return Formatted date.
    */
   Z(momentDate) {
-    // Timezone offset in seconds.
-    const offset = momentDate.format('Z');
-    const sign = offset[0] === '-' ? -1 : 1;
-    const parts = offset.substring(1).split(':').map(n => parseInt(n, 10));
+    const offset = momentDate.format("Z");
+    const sign = offset[0] === "-" ? -1 : 1;
+    const parts = offset.substring(1).split(":").map((n) => parseInt(n, 10));
     return sign * (parts[0] * HOUR_IN_MINUTES + parts[1]) * MINUTE_IN_SECONDS;
   },
   // Full date/time.
-  c: 'YYYY-MM-DDTHH:mm:ssZ',
+  c: "YYYY-MM-DDTHH:mm:ssZ",
   // .toISOString.
   /**
    * Formats the date as RFC2822.
@@ -367,197 +317,77 @@ const formatMap = {
    * @return Formatted date.
    */
   r(momentDate) {
-    return momentDate.locale('en').format('ddd, DD MMM YYYY HH:mm:ss ZZ');
+    return momentDate.locale("en").format("ddd, DD MMM YYYY HH:mm:ss ZZ");
   },
-  U: 'X'
+  U: "X"
 };
-
-/**
- * Formats a date. Does not alter the date's timezone.
- *
- * @param dateFormat PHP-style formatting string.
- *                   See [php.net/date](https://www.php.net/manual/en/function.date.php).
- * @param dateValue  Date object or string,
- *                   parsable by moment.js.
- *
- * @return Formatted date.
- */
-function format(dateFormat, dateValue = new Date()) {
+function format(dateFormat, dateValue = /* @__PURE__ */ new Date()) {
   let i, char;
   const newFormat = [];
-  const momentDate = (0, _moment.default)(dateValue);
+  const momentDate = (0, import_moment.default)(dateValue);
   for (i = 0; i < dateFormat.length; i++) {
     char = dateFormat[i];
-    // Is this an escape?
-    if ('\\' === char) {
-      // Add next character, then move on.
+    if ("\\" === char) {
       i++;
-      newFormat.push('[' + dateFormat[i] + ']');
+      newFormat.push("[" + dateFormat[i] + "]");
       continue;
     }
     if (char in formatMap) {
       const formatter = formatMap[char];
-      if (typeof formatter !== 'string') {
-        // If the format is a function, call it.
-        newFormat.push('[' + formatter(momentDate) + ']');
+      if (typeof formatter !== "string") {
+        newFormat.push("[" + formatter(momentDate) + "]");
       } else {
-        // Otherwise, add as a formatting string.
         newFormat.push(formatter);
       }
     } else {
-      newFormat.push('[' + char + ']');
+      newFormat.push("[" + char + "]");
     }
   }
-  // Join with [] between to separate characters, and replace
-  // unneeded separators with static text.
-  return momentDate.format(newFormat.join('[]'));
+  return momentDate.format(newFormat.join("[]"));
 }
-
-/**
- * Formats a date (like `date()` in PHP).
- *
- * @param  dateFormat PHP-style formatting string.
- *                    See [php.net/date](https://www.php.net/manual/en/function.date.php).
- * @param  dateValue  Date object or string, parsable
- *                    by moment.js.
- * @param  timezone   Timezone to output result in or a
- *                    UTC offset. Defaults to timezone from
- *                    site.
- *
- * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
- * @see https://en.wikipedia.org/wiki/ISO_8601#Time_offsets_from_UTC
- *
- * @return {string} Formatted date in English.
- */
-function date(dateFormat, dateValue = new Date(), timezone) {
+function date(dateFormat, dateValue = /* @__PURE__ */ new Date(), timezone) {
   const dateMoment = buildMoment(dateValue, timezone);
   return format(dateFormat, dateMoment);
 }
-
-/**
- * Formats a date (like `date()` in PHP), in the UTC timezone.
- *
- * @param dateFormat PHP-style formatting string.
- *                   See [php.net/date](https://www.php.net/manual/en/function.date.php).
- * @param dateValue  Date object or string,
- *                   parsable by moment.js.
- *
- * @return Formatted date in English.
- */
-function gmdate(dateFormat, dateValue = new Date()) {
-  const dateMoment = (0, _moment.default)(dateValue).utc();
+function gmdate(dateFormat, dateValue = /* @__PURE__ */ new Date()) {
+  const dateMoment = (0, import_moment.default)(dateValue).utc();
   return format(dateFormat, dateMoment);
 }
-
-/**
- * Formats a date (like `wp_date()` in PHP), translating it into site's locale.
- *
- * Backward Compatibility Notice: if `timezone` is set to `true`, the function
- * behaves like `gmdateI18n`.
- *
- * @param dateFormat PHP-style formatting string.
- *                   See [php.net/date](https://www.php.net/manual/en/function.date.php).
- * @param dateValue  Date object or string, parsable by
- *                   moment.js.
- * @param timezone   Timezone to output result in or a
- *                   UTC offset. Defaults to timezone from
- *                   site. Notice: `boolean` is effectively
- *                   deprecated, but still supported for
- *                   backward compatibility reasons.
- *
- * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
- * @see https://en.wikipedia.org/wiki/ISO_8601#Time_offsets_from_UTC
- *
- * @return  Formatted date.
- */
-function dateI18n(dateFormat, dateValue = new Date(), timezone) {
+function dateI18n(dateFormat, dateValue = /* @__PURE__ */ new Date(), timezone) {
   if (true === timezone) {
     return gmdateI18n(dateFormat, dateValue);
   }
   if (false === timezone) {
-    timezone = undefined;
+    timezone = void 0;
   }
   const dateMoment = buildMoment(dateValue, timezone);
   dateMoment.locale(settings.l10n.locale);
   return format(dateFormat, dateMoment);
 }
-
-/**
- * Formats a date (like `wp_date()` in PHP), translating it into site's locale
- * and using the UTC timezone.
- *
- * @param dateFormat PHP-style formatting string.
- *                   See [php.net/date](https://www.php.net/manual/en/function.date.php).
- * @param dateValue  Date object or string,
- *                   parsable by moment.js.
- *
- * @return Formatted date.
- */
-function gmdateI18n(dateFormat, dateValue = new Date()) {
-  const dateMoment = (0, _moment.default)(dateValue).utc();
+function gmdateI18n(dateFormat, dateValue = /* @__PURE__ */ new Date()) {
+  const dateMoment = (0, import_moment.default)(dateValue).utc();
   dateMoment.locale(settings.l10n.locale);
   return format(dateFormat, dateMoment);
 }
-
-/**
- * Check whether a date is considered in the future according to the WordPress settings.
- *
- * @param dateValue Date String or Date object in the Defined WP Timezone.
- *
- * @return Is in the future.
- */
 function isInTheFuture(dateValue) {
-  const now = _moment.default.tz(WP_ZONE);
-  const momentObject = _moment.default.tz(dateValue, WP_ZONE);
+  const now = import_moment.default.tz(WP_ZONE);
+  const momentObject = import_moment.default.tz(dateValue, WP_ZONE);
   return momentObject.isAfter(now);
 }
-
-/**
- * Create and return a JavaScript Date Object from a date string in the WP timezone.
- *
- * @param dateString Date formatted in the WP timezone.
- *
- * @return  Date
- */
 function getDate(dateString) {
   if (!dateString) {
-    return _moment.default.tz(WP_ZONE).toDate();
+    return import_moment.default.tz(WP_ZONE).toDate();
   }
-  return _moment.default.tz(dateString, WP_ZONE).toDate();
+  return import_moment.default.tz(dateString, WP_ZONE).toDate();
 }
-
-/**
- * Returns a human-readable time difference between two dates, like human_time_diff() in PHP.
- *
- * @param from From date, in the WP timezone.
- * @param to   To date, formatted in the WP timezone.
- *
- * @return Human-readable time difference.
- */
 function humanTimeDiff(from, to) {
-  const fromMoment = _moment.default.tz(from, WP_ZONE);
-  const toMoment = to ? _moment.default.tz(to, WP_ZONE) : _moment.default.tz(WP_ZONE);
+  const fromMoment = import_moment.default.tz(from, WP_ZONE);
+  const toMoment = to ? import_moment.default.tz(to, WP_ZONE) : import_moment.default.tz(WP_ZONE);
   return fromMoment.from(toMoment);
 }
-
-/**
- * Creates a moment instance using the given timezone or, if none is provided, using global settings.
- *
- * @param dateValue Date object or string, parsable
- *                  by moment.js.
- * @param timezone  Timezone to output result in or a
- *                  UTC offset. Defaults to timezone from
- *                  site.
- *
- * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
- * @see https://en.wikipedia.org/wiki/ISO_8601#Time_offsets_from_UTC
- *
- * @return A moment instance.
- */
-function buildMoment(dateValue, timezone = '') {
-  const dateMoment = (0, _moment.default)(dateValue);
+function buildMoment(dateValue, timezone = "") {
+  const dateMoment = (0, import_moment.default)(dateValue);
   if (timezone && !isUTCOffset(timezone)) {
-    // The ! isUTCOffset() check guarantees that timezone is a string.
     return dateMoment.tz(timezone);
   }
   if (timezone && isUTCOffset(timezone)) {
@@ -568,19 +398,26 @@ function buildMoment(dateValue, timezone = '') {
   }
   return dateMoment.utcOffset(+settings.timezone.offset);
 }
-
-/**
- * Returns whether a certain UTC offset is valid or not.
- *
- * @param offset a UTC offset.
- *
- * @return  whether a certain UTC offset is valid or not.
- */
 function isUTCOffset(offset) {
-  if ('number' === typeof offset) {
+  if ("number" === typeof offset) {
     return true;
   }
   return VALID_UTC_OFFSET.test(offset);
 }
 setupWPTimezone();
-//# sourceMappingURL=index.js.map
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  __experimentalGetSettings,
+  date,
+  dateI18n,
+  format,
+  getDate,
+  getSettings,
+  gmdate,
+  gmdateI18n,
+  humanTimeDiff,
+  isInTheFuture,
+  setSettings,
+  ...require("./types")
+});
+//# sourceMappingURL=index.js.map