Даты и часовые пояса в JavaScript без боли

Как это работает: Intl.DateTimeFormat().resolvedOptions() читает часовой пояс, настроенный в ОС/браузере — работает везде, где есть современный JS, и никогда не вызывает запрос разрешения navigator.geolocation.

function getVisitorTimezone() {
  return Intl.DateTimeFormat().resolvedOptions().timeZone
}

// Example usage
getVisitorTimezone() // "Europe/Berlin", "Asia/Jerusalem", etc.

Как это работает: передача timeZone в Intl.DateTimeFormat заставляет его напрямую вычислить время в этом поясе — без ручной математики со смещениями, и автоматически учитывается переход на летнее/зимнее время.

function formatInTimezone(date, timeZone, options = {}) {
  return new Intl.DateTimeFormat('en-US', {
    year: 'numeric', month: 'short', day: '2-digit',
    hour: '2-digit', minute: '2-digit',
    ...options,
    timeZone
  }).format(date)
}

// Example usage — same instant, two different timezones
const now = new Date()
formatInTimezone(now, 'Asia/Tokyo')       // "Jul 9, 14:32"
formatInTimezone(now, 'America/New_York') // "Jul 9, 01:32"

Как это работает: вместо toISOString() (который сначала переводит в UTC), оба хелпера читают/собирают дату напрямую из локальных getFullYear/getMonth/getDate, поэтому календарный день никогда не сдвигается из-за часового пояса посетителя.

function toIsoDateString(date) {
  const y = date.getFullYear()
  const m = String(date.getMonth() + 1).padStart(2, '0')
  const d = String(date.getDate()).padStart(2, '0')
  return `${y}-${m}-${d}`
}

function parseIsoDate(value) {
  const match = String(value || '').match(/^(\d{4})-(\d{2})-(\d{2})/)
  if (!match) return null
  return new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3]))
}

// Example usage
toIsoDateString(new Date()) // "2026-07-08", using local time, not UTC
parseIsoDate('2026-07-08')  // Date for July 8, 2026 at local midnight

Как это работает: строится точная UTC-метка времени для границы следующего дня/месяца через Date.UTC(...), затем из неё вычитается текущее время — никакой возни с часовыми поясами, поскольку всё остаётся в UTC.

function secondsUntilNextUtcDay(date = new Date()) {
  const nextDay = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate() + 1))
  return Math.floor((nextDay.getTime() - date.getTime()) / 1000)
}

function secondsUntilNextUtcMonth(date = new Date()) {
  const nextMonth = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth() + 1, 1))
  return Math.floor((nextMonth.getTime() - date.getTime()) / 1000)
}

// Example usage — set a Redis quota key to expire exactly at UTC midnight
await redis.set(`quota:daily:${userId}`, count, 'EX', secondsUntilNextUtcDay())

Как это работает: Intl.DateTimeFormat с timeZoneName: 'shortOffset' возвращает часть вида "GMT+3"; затем смещение нормализуется к фиксированному формату +HH:MM, чтобы все метки были выровнены в выпадающем списке.

function formatTzWithGmt(timeZone, date = new Date()) {
  const parts = new Intl.DateTimeFormat('en-US', {
    timeZone,
    timeZoneName: 'shortOffset'
  }).formatToParts(date)

  const raw = parts.find((p) => p.type === 'timeZoneName')?.value || 'GMT'
  let offset = raw.replace('GMT', '') || '+00:00'
  if (!offset.includes(':')) {
    const sign = offset.startsWith('-') ? '-' : '+'
    offset = `${sign}${offset.replace(/[+-]/, '').padStart(2, '0')}:00`
  }

  return `(GMT${offset}) ${timeZone}`
}

// Example usage
formatTzWithGmt('Asia/Jerusalem') // "(GMT+03:00) Asia/Jerusalem"

Как это работает: DateTimeZone::getOffset() возвращает смещение в секундах для конкретного момента времени, поэтому передача сегодняшней даты автоматически учитывает, действует ли сейчас переход на летнее время.

<?php

function formatTzWithGmt(string $timezone, ?DateTimeImmutable $date = null): string
{
    $date ??= new DateTimeImmutable('now');
    $tz = new DateTimeZone($timezone);

    $offsetSeconds = $tz->getOffset($date);
    $sign = $offsetSeconds >= 0 ? '+' : '-';
    $hours = str_pad((string) intdiv(abs($offsetSeconds), 3600), 2, '0', STR_PAD_LEFT);
    $minutes = str_pad((string) (intdiv(abs($offsetSeconds), 60) % 60), 2, '0', STR_PAD_LEFT);

    return "(GMT{$sign}{$hours}:{$minutes}) {$timezone}";
}

// Example usage
formatTzWithGmt('Asia/Jerusalem');   // "(GMT+03:00) Asia/Jerusalem"
formatTzWithGmt('America/New_York'); // "(GMT-04:00) America/New_York" during DST