cynx-lib 1.3.28

package/utils/utils/tz.js

@@ -0,0 +1,625 @@
+/**
+ * cynx/utils — Universal Time Zone & Date Engine (tz.js)
+ *
+ * Lightweight, zero-dependency timezone and date utility powered by native Intl API.
+ * Compatible with Browser, Node.js, Web Workers, and SSR.
+ */
+
+// ─── CACHE & HELPERS ────────────────────────────────────────────────────────────
+
+const formatterCache = new Map();
+
+function getCachedFormatter(locale, options) {
+  const key = `${locale}_${JSON.stringify(options)}`;
+  if (!formatterCache.has(key)) {
+    formatterCache.set(key, new Intl.DateTimeFormat(locale, options));
+  }
+  return formatterCache.get(key);
+}
+
+function parseDate(input) {
+  if (input instanceof Date) return new Date(input.getTime());
+  if (typeof input === 'number') return new Date(input);
+  if (typeof input === 'string') {
+    const d = new Date(input);
+    if (!isNaN(d.getTime())) return d;
+  }
+  return new Date();
+}
+
+/**
+ * Left-pad a number with leading zeros.
+ * 
+ * @param {number|string} n
+ * @param {number} [length=2]
+ * @returns {string}
+ */
+export function pad(n, length = 2) {
+  return String(n).padStart(length, '0');
+}
+
+// ─── 1. TIMEZONE DISCOVERY & VALIDATION ──────────────────────────────────────────
+
+/**
+ * Get the current user/system IANA timezone.
+ * Example: "Asia/Tashkent", "Europe/London", "America/New_York"
+ * 
+ * @returns {string}
+ */
+export function getUserTimezone() {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';
+  } catch {
+    return 'UTC';
+  }
+}
+
+/**
+ * Check if a given string is a valid IANA timezone name.
+ * 
+ * @param {string} timezone
+ * @returns {boolean}
+ */
+export function isValidTimezone(timezone) {
+  if (!timezone || typeof timezone !== 'string') return false;
+  try {
+    Intl.DateTimeFormat(undefined, { timeZone: timezone });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ─── 2. TIMEZONE CONVERSION & OFFSETS ───────────────────────────────────────────
+
+/**
+ * Extract date/time parts for a given date in a specific timezone.
+ * 
+ * @param {Date|number|string} date
+ * @param {string} [timezone] Target IANA timezone (default: user timezone)
+ * @returns {{ year: number, month: number, day: number, hour: number, minute: number, second: number, millisecond: number, weekday: number }}
+ */
+export function getTimezoneParts(date, timezone = getUserTimezone()) {
+  const d = parseDate(date);
+  const formatter = getCachedFormatter('en-US', {
+    timeZone: timezone,
+    year: 'numeric',
+    month: 'numeric',
+    day: 'numeric',
+    hour: 'numeric',
+    minute: 'numeric',
+    second: 'numeric',
+    fractionalSecondDigits: 3,
+    hour12: false,
+    weekday: 'short',
+  });
+
+  const parts = formatter.formatToParts(d);
+  const result = {
+    year: 0,
+    month: 1,
+    day: 1,
+    hour: 0,
+    minute: 0,
+    second: 0,
+    millisecond: d.getMilliseconds(),
+    weekday: d.getDay(),
+  };
+
+  for (const { type, value } of parts) {
+    if (type === 'year') result.year = parseInt(value, 10);
+    else if (type === 'month') result.month = parseInt(value, 10);
+    else if (type === 'day') result.day = parseInt(value, 10);
+    else if (type === 'hour') result.hour = parseInt(value, 10) === 24 ? 0 : parseInt(value, 10);
+    else if (type === 'minute') result.minute = parseInt(value, 10);
+    else if (type === 'second') result.second = parseInt(value, 10);
+    else if (type === 'fractionalSecond') result.millisecond = parseInt(value, 10);
+  }
+
+  return result;
+}
+
+/**
+ * Get the UTC offset for a specific timezone and date.
+ * 
+ * @param {string} [timezone] Target IANA timezone
+ * @param {Date|number|string} [date] Reference date
+ * @returns {{ offsetMinutes: number, offsetString: string, formatted: string }}
+ * Example: { offsetMinutes: 300, offsetString: "+05:00", formatted: "UTC+05:00" }
+ */
+export function getTimezoneOffset(timezone = getUserTimezone(), date = new Date()) {
+  const d = parseDate(date);
+  try {
+    const parts = getTimezoneParts(d, timezone);
+    const utcParts = getTimezoneParts(d, 'UTC');
+
+    const tzDate = Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second);
+    const utcDate = Date.UTC(utcParts.year, utcParts.month - 1, utcParts.day, utcParts.hour, utcParts.minute, utcParts.second);
+
+    const diffMinutes = Math.round((tzDate - utcDate) / (1000 * 60));
+    const sign = diffMinutes >= 0 ? '+' : '-';
+    const absMin = Math.abs(diffMinutes);
+    const hours = String(Math.floor(absMin / 60)).padStart(2, '0');
+    const mins = String(absMin % 60).padStart(2, '0');
+    const offsetString = `${sign}${hours}:${mins}`;
+
+    return {
+      offsetMinutes: diffMinutes,
+      offsetString,
+      formatted: `UTC${offsetString}`,
+    };
+  } catch {
+    return { offsetMinutes: 0, offsetString: '+00:00', formatted: 'UTC+00:00' };
+  }
+}
+
+// ─── 3. DATE & TIME FORMATTING (WITH TOKENS) ────────────────────────────────────
+
+const MONTH_NAMES = {
+  en: ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'],
+  ru: ['Январь', 'Февраль', 'Март', 'Апрель', 'Май', 'Июнь', 'Июль', 'Август', 'Сентябрь', 'Октябрь', 'Ноябрь', 'Декабрь'],
+};
+
+const MONTH_SHORT = {
+  en: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
+  ru: ['янв', 'фев', 'мар', 'апр', 'май', 'июн', 'июл', 'авг', 'сен', 'окт', 'ноя', 'дек'],
+};
+
+/**
+ * Format date in a specified timezone using custom format pattern tokens.
+ * 
+ * Supported tokens:
+ * - YYYY / YY : Full / 2-digit year
+ * - MMMM / MMM / MM / M : Full / short / padded / unpadded month
+ * - DD / D : 2-digit / unpadded day
+ * - HH / H : 24-hour padded / unpadded
+ * - hh / h : 12-hour padded / unpadded
+ * - mm / m : Minutes padded / unpadded
+ * - ss / s : Seconds padded / unpadded
+ * - SSS : Milliseconds
+ * - A / a : AM/PM / am/pm
+ * - ZZ / Z : +05:00 / +0500
+ * - z : Timezone offset (e.g. UTC+05:00)
+ * 
+ * @param {Date|number|string} date
+ * @param {string} [pattern='YYYY-MM-DD HH:mm:ss']
+ * @param {object} [options]
+ * @param {string} [options.timezone] Target timezone (default: user timezone)
+ * @param {string} [options.locale='en'] Locale for month/day names ('en' | 'ru')
+ * @returns {string}
+ */
+export function formatTZ(date, pattern = 'YYYY-MM-DD HH:mm:ss', { timezone = getUserTimezone(), locale = 'en' } = {}) {
+  const d = parseDate(date);
+  const p = getTimezoneParts(d, timezone);
+  const offset = getTimezoneOffset(timezone, d);
+
+  const lang = MONTH_NAMES[locale] ? locale : 'en';
+  const monthIdx = p.month - 1;
+  const hour12 = p.hour % 12 || 12;
+  const isPM = p.hour >= 12;
+
+  const tokens = {
+    YYYY: String(p.year),
+    YY: String(p.year).slice(-2),
+    MMMM: MONTH_NAMES[lang][monthIdx],
+    MMM: MONTH_SHORT[lang][monthIdx],
+    MM: String(p.month).padStart(2, '0'),
+    M: String(p.month),
+    DD: String(p.day).padStart(2, '0'),
+    D: String(p.day),
+    HH: String(p.hour).padStart(2, '0'),
+    H: String(p.hour),
+    hh: String(hour12).padStart(2, '0'),
+    h: String(hour12),
+    mm: String(p.minute).padStart(2, '0'),
+    m: String(p.minute),
+    ss: String(p.second).padStart(2, '0'),
+    s: String(p.second),
+    SSS: String(p.millisecond).padStart(3, '0'),
+    A: isPM ? 'PM' : 'AM',
+    a: isPM ? 'pm' : 'am',
+    ZZ: offset.offsetString,
+    Z: offset.offsetString.replace(':', ''),
+    z: offset.formatted,
+  };
+
+  return pattern.replace(/YYYY|YY|MMMM|MMM|MM|M|DD|D|HH|H|hh|h|mm|m|ss|s|SSS|A|a|ZZ|Z|z/g, (match) => tokens[match] || match);
+}
+
+// ─── 4. RELATIVE TIME («TIME AGO») ──────────────────────────────────────────────
+
+/**
+ * Format relative time (e.g. "5 minutes ago", "just now", "in 2 days").
+ * 
+ * @param {Date|number|string} date Target date
+ * @param {object} [options]
+ * @param {Date|number|string} [options.baseDate=Date.now()] Base comparison date
+ * @param {string} [options.locale='en'] Locale (e.g. 'en', 'ru')
+ * @returns {string}
+ */
+export function timeAgo(date, { baseDate = Date.now(), locale = 'en' } = {}) {
+  const d = parseDate(date).getTime();
+  const base = parseDate(baseDate).getTime();
+  const diffSec = Math.round((d - base) / 1000);
+
+  const rtf = typeof Intl !== 'undefined' && Intl.RelativeTimeFormat
+    ? new Intl.RelativeTimeFormat(locale, { numeric: 'auto' })
+    : null;
+
+  const absSec = Math.abs(diffSec);
+
+  if (absSec < 10) {
+    return locale.startsWith('ru') ? 'только что' : 'just now';
+  }
+
+  const units = [
+    { name: 'year', seconds: 31536000 },
+    { name: 'month', seconds: 2592000 },
+    { name: 'day', seconds: 86400 },
+    { name: 'hour', seconds: 3600 },
+    { name: 'minute', seconds: 60 },
+    { name: 'second', seconds: 1 },
+  ];
+
+  for (const { name, seconds } of units) {
+    if (absSec >= seconds || name === 'second') {
+      const val = Math.round(diffSec / seconds);
+      if (rtf) {
+        return rtf.format(val, name);
+      }
+      return `${Math.abs(val)} ${name}${Math.abs(val) > 1 ? 's' : ''} ${diffSec < 0 ? 'ago' : 'from now'}`;
+    }
+  }
+
+  return '';
+}
+
+// ─── 5. TIMEZONE-AWARE CURRENT TIME & STRING DATES ──────────────────────────────
+
+/**
+ * Returns a Date object shifted to the wall-clock time of the target timezone.
+ * 
+ * @param {string} [timezone] Target IANA timezone (default: user timezone)
+ * @returns {Date}
+ */
+export function getNow(timezone = getUserTimezone()) {
+  const d = new Date();
+  const offset = getTimezoneOffset(timezone, d);
+  return new Date(d.getTime() + offset.offsetMinutes * 60 * 1000);
+}
+
+/**
+ * Get current date string in 'YYYY-MM-DD' format for a given timezone.
+ * 
+ * @param {string} [timezone] Target IANA timezone (default: user timezone)
+ * @returns {string} E.g. "2026-09-08"
+ */
+export function getToday(timezone = getUserTimezone()) {
+  const p = getTimezoneParts(new Date(), timezone);
+  return `${p.year}-${pad(p.month)}-${pad(p.day)}`;
+}
+
+/**
+ * Get current month string in 'YYYY-MM' format for a given timezone.
+ * 
+ * @param {string} [timezone] Target IANA timezone (default: user timezone)
+ * @returns {string} E.g. "2026-09"
+ */
+export function getCurrentMonth(timezone = getUserTimezone()) {
+  const p = getTimezoneParts(new Date(), timezone);
+  return `${p.year}-${pad(p.month)}`;
+}
+
+// ─── 6. STRING-BASED DATE ARITHMETIC & RANGES ───────────────────────────────────
+
+/**
+ * Shift a date string ('YYYY-MM-DD' or ISO) by an amount of days, months, or years.
+ * Leap-year safe and timezone-independent.
+ * 
+ * @param {string|Date} dateInput
+ * @param {number} [amount=0] Amount to shift (negative for past, positive for future)
+ * @param {'days'|'months'|'years'} [unit='days']
+ * @returns {string} Date string in 'YYYY-MM-DD' format
+ */
+export function shiftDateStr(dateInput, amount = 0, unit = 'days') {
+  let y, m, d;
+  if (typeof dateInput === 'string' && /^\d{4}-\d{2}-\d{2}/.test(dateInput)) {
+    const parts = dateInput.slice(0, 10).split('-').map(Number);
+    y = parts[0];
+    m = parts[1];
+    d = parts[2];
+  } else {
+    const parsed = parseDate(dateInput);
+    y = parsed.getUTCFullYear();
+    m = parsed.getUTCMonth() + 1;
+    d = parsed.getUTCDate();
+  }
+
+  const dt = new Date(Date.UTC(y, m - 1, d));
+  switch (unit) {
+    case 'years':
+      dt.setUTCFullYear(dt.getUTCFullYear() + amount);
+      break;
+    case 'months':
+      dt.setUTCMonth(dt.getUTCMonth() + amount);
+      break;
+    case 'days':
+    default:
+      dt.setUTCDate(dt.getUTCDate() + amount);
+      break;
+  }
+
+  return `${dt.getUTCFullYear()}-${pad(dt.getUTCMonth() + 1)}-${pad(dt.getUTCDate())}`;
+}
+
+/**
+ * Shift a date string by N days into the past.
+ * 
+ * @param {string|Date} dateStr
+ * @param {number} [count=1] Number of days to go back
+ * @returns {string} Date string in 'YYYY-MM-DD' format
+ */
+export function prevDayStr(dateStr, count = 1) {
+  return shiftDateStr(dateStr, -count, 'days');
+}
+
+/**
+ * Shift a date string by N days into the future.
+ * 
+ * @param {string|Date} dateStr
+ * @param {number} [count=1] Number of days to advance
+ * @returns {string} Date string in 'YYYY-MM-DD' format
+ */
+export function nextDayStr(dateStr, count = 1) {
+  return shiftDateStr(dateStr, count, 'days');
+}
+
+/**
+ * Calculate the number of calendar days between two dates (date2 - date1).
+ * 
+ * @param {string|Date} date1
+ * @param {string|Date} date2
+ * @returns {number} Difference in days (positive if date2 is after date1)
+ */
+export function daysBetween(date1, date2) {
+  const parseToUtcMidnight = (val) => {
+    if (typeof val === 'string' && /^\d{4}-\d{2}-\d{2}/.test(val)) {
+      const [y, m, d] = val.slice(0, 10).split('-').map(Number);
+      return Date.UTC(y, m - 1, d);
+    }
+    const dt = parseDate(val);
+    return Date.UTC(dt.getUTCFullYear(), dt.getUTCMonth(), dt.getUTCDate());
+  };
+
+  const ms1 = parseToUtcMidnight(date1);
+  const ms2 = parseToUtcMidnight(date2);
+  return Math.round((ms2 - ms1) / (1000 * 60 * 60 * 24));
+}
+
+/**
+ * Generate an array of date strings ('YYYY-MM-DD') for every day in the range [startDate, endDate].
+ * 
+ * @param {string|Date} startDate
+ * @param {string|Date} endDate
+ * @returns {string[]} Array of date strings
+ */
+export function getDateRange(startDate, endDate) {
+  const startStr = typeof startDate === 'string' && /^\d{4}-\d{2}-\d{2}/.test(startDate)
+    ? startDate.slice(0, 10)
+    : formatTZ(startDate, 'YYYY-MM-DD');
+  const endStr = typeof endDate === 'string' && /^\d{4}-\d{2}-\d{2}/.test(endDate)
+    ? endDate.slice(0, 10)
+    : formatTZ(endDate, 'YYYY-MM-DD');
+
+  if (startStr > endStr) return [];
+
+  const range = [];
+  let curr = startStr;
+  while (curr <= endStr) {
+    range.push(curr);
+    curr = nextDayStr(curr);
+  }
+  return range;
+}
+
+/**
+ * Get start of month date string ('YYYY-MM-01').
+ * 
+ * @param {string|Date} [date=new Date()]
+ * @param {string} [timezone]
+ * @returns {string} E.g. "2026-09-01"
+ */
+export function getStartOfMonth(date = new Date(), timezone = getUserTimezone()) {
+  const p = getTimezoneParts(date, timezone);
+  return `${p.year}-${pad(p.month)}-01`;
+}
+
+/**
+ * Get end of month date string (e.g. '2026-02-28', '2026-09-30').
+ * 
+ * @param {string|Date} [date=new Date()]
+ * @param {string} [timezone]
+ * @returns {string}
+ */
+export function getEndOfMonth(date = new Date(), timezone = getUserTimezone()) {
+  const p = getTimezoneParts(date, timezone);
+  const dt = new Date(Date.UTC(p.year, p.month, 0));
+  return `${p.year}-${pad(p.month)}-${pad(dt.getUTCDate())}`;
+}
+
+/**
+ * Get exact Start of Day (00:00:00.000) as a Date object for a given date and timezone.
+ * 
+ * @param {string|Date} [date=new Date()]
+ * @param {string} [timezone]
+ * @returns {Date}
+ */
+export function getStartOfDay(date = new Date(), timezone = getUserTimezone()) {
+  const p = getTimezoneParts(date, timezone);
+  const offset = getTimezoneOffset(timezone, new Date(Date.UTC(p.year, p.month - 1, p.day, 12, 0, 0)));
+  return new Date(Date.UTC(p.year, p.month - 1, p.day, 0, 0, 0, 0) - offset.offsetMinutes * 60 * 1000);
+}
+
+/**
+ * Get exact End of Day (23:59:59.999) as a Date object for a given date and timezone.
+ * 
+ * @param {string|Date} [date=new Date()]
+ * @param {string} [timezone]
+ * @returns {Date}
+ */
+export function getEndOfDay(date = new Date(), timezone = getUserTimezone()) {
+  const p = getTimezoneParts(date, timezone);
+  const offset = getTimezoneOffset(timezone, new Date(Date.UTC(p.year, p.month - 1, p.day, 12, 0, 0)));
+  return new Date(Date.UTC(p.year, p.month - 1, p.day, 23, 59, 59, 999) - offset.offsetMinutes * 60 * 1000);
+}
+
+// ─── 7. DATE ARITHMETIC & COMPARISONS ───────────────────────────────────────────
+
+/**
+ * Add or subtract time from a Date object.
+ * 
+ * @param {Date|number|string} date
+ * @param {number} amount Amount to add (negative to subtract)
+ * @param {'years'|'months'|'days'|'hours'|'minutes'|'seconds'} unit
+ * @returns {Date}
+ */
+export function addTime(date, amount, unit = 'days') {
+  const d = parseDate(date);
+  switch (unit) {
+    case 'years':
+      d.setFullYear(d.getFullYear() + amount);
+      break;
+    case 'months':
+      d.setMonth(d.getMonth() + amount);
+      break;
+    case 'days':
+      d.setDate(d.getDate() + amount);
+      break;
+    case 'hours':
+      d.setHours(d.getHours() + amount);
+      break;
+    case 'minutes':
+      d.setMinutes(d.getMinutes() + amount);
+      break;
+    case 'seconds':
+      d.setSeconds(d.getSeconds() + amount);
+      break;
+  }
+  return d;
+}
+
+/**
+ * Check if two dates fall on the same day in a given timezone.
+ */
+export function isSameDay(date1, date2, timezone = getUserTimezone()) {
+  const p1 = getTimezoneParts(date1, timezone);
+  const p2 = getTimezoneParts(date2, timezone);
+  return p1.year === p2.year && p1.month === p2.month && p1.day === p2.day;
+}
+
+/**
+ * Check if a date is today in a given timezone.
+ */
+export function isToday(date, timezone = getUserTimezone()) {
+  return isSameDay(date, new Date(), timezone);
+}
+
+// ─── 8. TIMEZONE LIST GENERATOR (FOR SELECT/DROPDOWNS) ──────────────────────────
+
+export const COMMON_TIMEZONES = [
+  { value: 'Pacific/Midway', label: '(UTC-11:00) Midway Island, Samoa' },
+  { value: 'Pacific/Honolulu', label: '(UTC-10:00) Hawaii' },
+  { value: 'America/Anchorage', label: '(UTC-09:00) Alaska' },
+  { value: 'America/Los_Angeles', label: '(UTC-08:00) Pacific Time (US & Canada)' },
+  { value: 'America/Denver', label: '(UTC-07:00) Mountain Time (US & Canada)' },
+  { value: 'America/Chicago', label: '(UTC-06:00) Central Time (US & Canada)' },
+  { value: 'America/New_York', label: '(UTC-05:00) Eastern Time (US & Canada)' },
+  { value: 'America/Sao_Paulo', label: '(UTC-03:00) Brasilia, Sao Paulo' },
+  { value: 'UTC', label: '(UTC+00:00) Universal Coordinated Time, London' },
+  { value: 'Europe/London', label: '(UTC+00:00) London, Dublin, Edinburgh' },
+  { value: 'Europe/Paris', label: '(UTC+01:00) Paris, Berlin, Rome, Madrid' },
+  { value: 'Europe/Kyiv', label: '(UTC+02:00) Kyiv, Helsinki, Athens' },
+  { value: 'Europe/Moscow', label: '(UTC+03:00) Moscow, St. Petersburg, Istanbul' },
+  { value: 'Asia/Dubai', label: '(UTC+04:00) Dubai, Abu Dhabi, Baku' },
+  { value: 'Asia/Tashkent', label: '(UTC+05:00) Tashkent, Samarkand, Islamabad' },
+  { value: 'Asia/Almaty', label: '(UTC+05:00) Almaty, Astana' },
+  { value: 'Asia/Dhaka', label: '(UTC+06:00) Dhaka, Novosibirsk' },
+  { value: 'Asia/Bangkok', label: '(UTC+07:00) Bangkok, Hanoi, Jakarta' },
+  { value: 'Asia/Singapore', label: '(UTC+08:00) Singapore, Beijing, Hong Kong' },
+  { value: 'Asia/Tokyo', label: '(UTC+09:00) Tokyo, Seoul' },
+  { value: 'Australia/Sydney', label: '(UTC+10:00) Sydney, Melbourne' },
+  { value: 'Pacific/Auckland', label: '(UTC+12:00) Auckland, Wellington' },
+];
+
+/**
+ * Return a list of major timezones with their current real-time UTC offsets.
+ * Ideal for populating Select/Dropdown components.
+ * 
+ * @returns {Array<{ value: string, label: string, offset: string, offsetMinutes: number }>}
+ */
+export function getTimezoneList() {
+  return COMMON_TIMEZONES.map((tz) => {
+    const off = getTimezoneOffset(tz.value);
+    return {
+      value: tz.value,
+      label: tz.label,
+      offset: off.offsetString,
+      offsetMinutes: off.offsetMinutes,
+    };
+  });
+}
+
+// ─── 9. BACKWARD COMPATIBILITY (TASHKENT SHORTCUTS) ─────────────────────────────
+
+/**
+ * @deprecated Use getNow('Asia/Tashkent')
+ */
+export function tashkentNow() {
+  return getNow('Asia/Tashkent');
+}
+
+/**
+ * @deprecated Use getToday('Asia/Tashkent')
+ */
+export function tashkentToday() {
+  return getToday('Asia/Tashkent');
+}
+
+/**
+ * @deprecated Use getCurrentMonth('Asia/Tashkent')
+ */
+export function tashkentMonth() {
+  return getCurrentMonth('Asia/Tashkent');
+}
+
+// ─── MAIN EXPORT ────────────────────────────────────────────────────────────────
+
+export default {
+  pad,
+  getUserTimezone,
+  isValidTimezone,
+  getTimezoneParts,
+  getTimezoneOffset,
+  formatTZ,
+  timeAgo,
+  getNow,
+  getToday,
+  getCurrentMonth,
+  shiftDateStr,
+  prevDayStr,
+  nextDayStr,
+  daysBetween,
+  getDateRange,
+  getStartOfMonth,
+  getEndOfMonth,
+  getStartOfDay,
+  getEndOfDay,
+  addTime,
+  isSameDay,
+  isToday,
+  getTimezoneList,
+  COMMON_TIMEZONES,
+  tashkentNow,
+  tashkentToday,
+  tashkentMonth,
+};