tzdt v1.2.0

tzdt

Simple Date wrapper with timezone

Install

npm install tzdt

Usage

import { TzDate } from 'tzdt'
import 'tzdt/lib/timezones/Asia/Tokyo'

const utc = new TzDate('2020-12-31T15:30:20Z')
console.log(utc.getFullYear()) //2020
console.log(utc.toISOString()) //'2020-12-31T15:30:20.000Z'

const jst = new TzDate(utc, 'Asia/Tokyo')
console.log(jst.getFullYear()) //2021
console.log(jst.toISOString()) //'2021-01-01T00:30:20.000+09:00'

Constructor patterns

import { TzDate } from 'tzdt'
import 'tzdt/lib/timezones/UTC'
import 'tzdt/lib/timezones/Asia/Tokyo'

const date = new Date()

const utc1 = new TzDate()
const utc2 = new TzDate('UTC')
const utc3 = new TzDate(date)
const utc4 = new TzDate(date, 'UTC')
const utc5 = new TzDate(date, 0)
const utc6 = new TzDate(utc1)
const utc7 = new TzDate(utc1, 'UTC')
const utc8 = new TzDate(utc1, 0)
const utc9 = new TzDate('2021-01-01T00:00:00Z')
const utc10 = new TzDate('2021-01-01T00:00:00Z', 'UTC')
const utc11 = new TzDate('2021-01-01T00:00:00Z', 0)
const utc12 = new TzDate(1600000000000, 'UTC')

const jst1 = new TzDate('Asia/Tokyo')
const jst2 = new TzDate(date, 'Asia/Tokyo')
const jst3 = new TzDate(date, 540)
const jst4 = new TzDate(utc1, 'Asia/Tokyo')
const jst5 = new TzDate(utc1, 540)
const jst6 = new TzDate('2021-01-01T00:00:00Z', 'Asia/Tokyo')
const jst7 = new TzDate('2021-01-01T00:00:00Z', 540)
const jst8 = new TzDate(1600000000000, 540)

Available timezones