modules/timezone

Модуль для работы с часовыми поясами.

Description:

  • Модуль для работы с часовыми поясами.

Source:

Methods

(static) getTimezoneOffset(time) → {number}

Description:

  • Возвращает смещение часового пояса экземпляра относительно UTC в минутах.

Source:
Example
import { getTimezoneOffset, fromISO } from '@alexstukovnikov/oz-time';

const time = fromISO('2024-05-25T12:00:00Z', 'Europe/Moscow', 'ru-RU');
console.log(getTimezoneOffset(time)); // ожидаемый результат: 180
Parameters:
Name Type Description
time OzTime

Экземпляр времени.
Throws:

Выбрасывается, если аргумент не является экземпляром OzTime.

Type
TypeError
Returns:

Смещение в минутах относительно UTC.

Type
number

(static) setTimezone(time, timezone) → {OzTime}

Description:

  • Возвращает новый экземпляр OzTime с тем же timestamp и locale, но с другим часовым поясом.

    Абсолютный момент времени при этом не изменяется.

Source:
Example
import { setTimezone, fromISO } from '@alexstukovnikov/oz-time';

const time = fromISO('2024-05-25T12:00:00Z', 'UTC', 'ru-RU');
const moscow = setTimezone(time, 'Europe/Moscow');
console.log(moscow.getTimezone()); // ожидаемый результат: Europe/Moscow
Parameters:
Name Type Description
time OzTime

Исходный экземпляр OzTime.
timezone string

Новый часовой пояс в формате IANA.
Throws:

  • Выбрасывается, если первый аргумент не является экземпляром OzTime или timezone некорректен.

    Type
    TypeError

  • Выбрасывается, если timezone не поддерживается.

    Type
    Error
Returns:

Новый экземпляр OzTime с другим часовым поясом.

Type
OzTime