时区

时区插件提供了 dayjs.tz、.tz、.tz.guess 和 .tz.setDefault API，用于在不同时区之间解析或显示时间。

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); // 创建一个 Dayjs 对象，假设输入时间为 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); // 将现有 Dayjs 对象的时间转换为指定时区（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); // 将现有 Dayjs 对象的时间视为本地时间，并转换为指定时区
//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

将 UTC 时间转换为指定时区的时间

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(dateValue) 会使用该时区（但 moment.tz(dateValue, timezone) 仍然需要第二个参数）。

然而 dayjs(dateValue) 始终使用本地时区，即使调用了 dayjs.tz.setDefault；只有 dayjs.tz(dateValue) （不带第二个参数）才会使用默认时区。