Timezone

Timezone добавляет API dayjs.tz, .tz, .tz.guess, .tz.setDefault для работы с временными зонами, включая разбор и отображение времени.

var utc = require('dayjs/plugin/utc');
// import utc from 'dayjs/plugin/utc' // ES 2015

var timezone = require('dayjs/plugin/timezone'); // Зависит от плагина utc
// import timezone from 'dayjs/plugin/timezone' // ES 2015

dayjs.extend(utc);
dayjs.extend(timezone);

const timestamp = '2014-06-01 12:00';
const tz = 'America/New_York';

const dayjsLocal = dayjs(timestamp); // Предполагается UTC
//dayjsLocal.toISOString() -> 2014-06-01T12:00:00.000Z
//dayjsLocal.format('YYYY-MM-DDTHH:mm:ss') -> 2014-06-01T12:00:00

const dayjsAmerica = dayjsLocal.tz(tz); // Существующее время рассматривается как UTC
//dayjsAmerica.toISOString() -> 2014-06-01T12:00:00.000Z
//dayjsAmerica.format('YYYY-MM-DDTHH:mm:ss') -> 2014-06-01T08:00:00

const dayjsAmericaKeep = dayjsLocal.tz(tz, true); // Существующее время рассматривается как местное время
//dayjsAmericaKeep.toISOString() -> 2014-06-01T16:00:00.000Z
//dayjsAmericaKeep.format('YYYY-MM-DDTHH:mm:ss') -> 2014-06-01T12:00:00

Определение часового пояса пользователя

dayjs.tz.guess();

Разбор времени с указанием часового пояса

const d1 = dayjs.tz('2013-11-18 11:55', 'Asia/Taipei');
d1.format(); // => 2013-11-18T11:55:00+08:00
d1.toISOString(); // => 2013-11-18T03:55:00.000Z

Преобразование в другой часовой пояс

const d2 = dayjs.utc('2013-11-18 11:55').tz('Asia/Taipei');
d2.format(); // => 2013-11-18T19:55:00+08:00
d2.toISOString(); // => 2013-11-18T11:55:00.000Z

Установка/сброс часового пояса по умолчанию (используется в .tz())

// Установка часового пояса по умолчанию
dayjs.tz.setDefault('America/New_York');

// Сброс часового пояса по умолчанию на системный
dayjs.tz.setDefault();

Отличия от Moment.js

В Moment.js использование часового пояса по умолчанию приводит к тому, что moment(dateValue) использует этот часовой пояс, но moment.tz(dateValue, timezone) по-прежнему требует второй параметр.

В Day.js dayjs(dateValue) всегда использует локальный часовой пояс, даже если была вызвана dayjs.tz.setDefault. Только dayjs.tz(dateValue) (без второго параметра) использует часовой пояс по умолчанию.