UTC
UTC adiciona as APIs .utc
, .local
e .isUTC
para processar e exibir datas em UTC.
javascript
var utc = require('dayjs/plugin/utc');
// import utc from 'dayjs/plugin/utc' // ES 2015
dayjs.extend(utc);
// Horário local padrão
dayjs().format(); //2019-03-06T17:11:55+08:00
// Modo UTC
dayjs.utc().format(); // 2019-03-06T09:11:55Z
// Converter horário local para horário UTC
dayjs().utc().format(); // 2019-03-06T09:11:55Z
// No modo UTC, todos os métodos de exibição mostrarão o horário em UTC em vez do horário local.
// E todos os getters e setters usarão internamente os métodos Date#getUTC* e Date#setUTC* em vez dos métodos Date#get* e 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'); // com o plugin CustomParseFormat
Por padrão, Day.js processa e exibe datas no horário local.
Se você deseja processar ou exibir datas em UTC, pode usar dayjs.utc()
em vez de dayjs()
.
dayjs.utc dayjs.utc(dateType?: string | number | Date | Dayjs, format?: string)
Retorna um objeto Dayjs
configurado para o modo UTC.
Usar horário UTC .utc()
Retorna um novo objeto Dayjs
clonado e configurado para usar o horário UTC.
Usar horário local .local()
Retorna um novo objeto Dayjs
clonado e configurado para usar o horário local.
Definir o deslocamento UTC .utcOffset()
Retorna um novo objeto Dayjs
clonado com um novo deslocamento UTC.
Verificar o modo UTC .isUTC()
Retorna um valor boolean
indicando se o objeto Dayjs
atual está no modo UTC ou não.