Időzóna

Az időzóna bővítmény a dayjs.tz, .tz, .tz.guess és .tz.setDefault API-kat biztosítja az időzónák közötti elemzéshez és megjelenítéshez.

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

var timezone = require('dayjs/plugin/timezone'); // függ az utc bővítménytől
// 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-ként értelmezi
//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); // a meglévő időpontot UTC-ként értelmezve konvertálja
//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); // a meglévő időpontot helyi időként értelmezve konvertálja
//dayjsAmericaKeep.toISOString() -> 2014-06-01T16:00:00.000Z
//dayjsAmericaKeep.format('YYYY-MM-DDTHH:mm:ss') -> 2014-06-01T12:00:00

A felhasználó időzónájának meghatározása

dayjs.tz.guess();

Feldolgozás egy adott időzónában

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

Átalakítás egy másik időzónába

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

Az alapértelmezett időzóna beállítása és visszaállítása (a .tz metódus használja)

// Az alapértelmezett időzóna beállítása
dayjs.tz.setDefault('America/New_York');

// Az alapértelmezett időzóna visszaállítása a rendszer időzónájára
dayjs.tz.setDefault();

Különbségek a Moment.js-hez képest

Ha az alapértelmezett időzóna be van állítva, a moment(dateValue) ezt az időzónát fogja használni (azonban a moment.tz(dateValue, timezone) továbbra is megköveteli a második paramétert).

A dayjs(dateValue) viszont mindig a helyi időzónát használja, még akkor is, ha a dayjs.tz.setDefault be van állítva; csak a dayjs.tz(dateValue) (második paraméter nélkül) fogja használni az alapértelmezett időzónát.