UTC
UTC 插件添加了 .utc
、.local
和 .isUTC
API,用于以 UTC 时间处理日期和时间。
javascript
var utc = require('dayjs/plugin/utc');
// import utc from 'dayjs/plugin/utc' // ES 2015
dayjs.extend(utc);
// 默认本地时间
dayjs().format(); // 2019-03-06T17:11:55+08:00
// UTC 模式
dayjs.utc().format(); // 2019-03-06T09:11:55Z
// 将本地时间转换为 UTC 时间
dayjs().utc().format(); // 2019-03-06T09:11:55Z
// 在 UTC 模式下,所有显示方法都将以 UTC 时间显示,而不是本地时间。
// 并且所有的 getter 和 setter 方法都将在内部使用 Date#getUTC* 和 Date#setUTC* 方法,而不是 Date#get* 和 Date#set* 方法。
dayjs.utc().isUTC(); // true
dayjs.utc().local().format(); // 2019-03-06T17:11:55+08:00
dayjs.utc('2018-01-01', 'YYYY-MM-DD'); // 使用 CustomParseFormat 插件
默认情况下,Day.js 使用本地时间进行解析和显示。
如果需要在 UTC 时间进行解析或显示,可以使用 dayjs.utc()
代替 dayjs()
。
dayjs.utc dayjs.utc(dateType?: string | number | Date | Dayjs, format?: string)
返回一个 UTC 模式的 Dayjs
对象。
设置为 UTC 时间 .utc()
返回一个克隆的 Dayjs
对象,并将其设置为使用 UTC 时间。
设置为本地时间 .local()
返回一个克隆的 Dayjs
对象,并将其设置为使用本地时间。
设置 UTC 偏移量 .utcOffset()
返回一个具有新的 UTC 偏移量的克隆 Dayjs
对象。
检查是否为 UTC 模式 .isUTC()
返回一个布尔值,指示当前 Dayjs
对象是否处于 UTC 模式。