@multisystemsuite/timezone-engine-core

@multisystemsuite/timezone-engine-core

Core timezone engine — detection, conversion, formatting, world clock, and site utilities. Framework-agnostic (works in Node.js, browser, SSR).

What it is used for

• Timezone detection (browser, Node, server)
• UTC timezone conversion and DST checks
• Locale-aware date formatting (ISO, SHORT, LONG, regional)
• World clock and timezone comparison
• Site utilities — normalise UI values like "America/New_York (GMT-5:00)" before IANA APIs
• Enterprise engine with plugins, cache, and config

Install

npm install @multisystemsuite/timezone-engine-core

Usage

import {
  detectTimezone,
  convertTimezone,
  formatDate,
  getWorldClock,
  compareTimezones,
  normalizeTimezone,
  safeTimezone,
  formatDateForSite,
  validateTimezone,
  safeTimezoneFallback,
  ensureUTCStorage,
  timezoneSafeCompare,
  detectClockDrift,
  syncServerTime,
} from "@multisystemsuite/timezone-engine-core";

normalizeTimezone("Asia/Kolkata (GMT+5:30)"); // "Asia/Kolkata"

formatDate(new Date(), { format: "FULL", timezone: "Asia/Kolkata" });

convertTimezone({
  sourceTimezone: "UTC",
  targetTimezone: "America/New_York",
  date: new Date(),
});

Site / microservice drop-in module

For admin-service, qc-service, shopfloor-service:

import {
  normalizeTimezone,
  sanitizeTimezoneForDB,
  formatDateForSite,
} from "@multisystemsuite/timezone-engine-core/site";

Subpath exports

Import path	Contents
/detection	detectTimezone, isValidTimezone
/conversion	toUTC, fromUTC, convertTimezone
/formatting	formatDate, formatRelativeTime
/world-clock	getWorldClock, createLiveClockUpdater
/comparison	compareTimezones, findCommonWorkingHours
/normalization	normalizeTimezone, safeTimezone
/site	Site formatting + token-based formatDate
/validation	Via main: validateTimezone, safeTimezoneFallback
/storage	Via main: ensureUTCStorage, parseUTCStorage

Validation & UTC storage

import {
  validateTimezone,
  aliasTimezoneResolver,
  ensureUTCStorage,
  timezoneSafeCompare,
  syncServerTime,
} from "@multisystemsuite/timezone-engine-core";

validateTimezone("IST"); // false
ensureUTCStorage(new Date(), "Asia/Kolkata");
syncServerTime({ clientTimezone: "Asia/Kolkata" });

Related packages

• @multisystemsuite/timezone-engine-world-data — offline IANA/country metadata
• @multisystemsuite/timezone-engine-utils — cache and plugins
• @multisystemsuite/timezone-engine-shared-types — TypeScript types

Keywords

timezone, utc, conversion, formatting, world-clock, iana, dst, typescript, enterprise, date-fns, ssr

License

MIT