Skip to content

Getting Started

Installation

Install via npm:

bash
npm install time-wise

Import

ES Modules

When using ESM:

typescript
import { DateTime, Offset, Interval, Duration } from "time-wise";

CommonJS

When using CJS:

typescript
const { DateTime, Offset, Interval, Duration } = require("time-wise");

Browser

When using browser, include the script tag:

html
<script src="time-wise.iife.js"></script>
<script>
  const { DateTime, Offset, Interval, Duration } = TimeWise;
</script>

Have fun with ...

DateTime

Wanna know what time it is in your favorite city right now?

typescript
DateTime.now().inZone("America/New_York").toString();

// 2025-01-01 15:45:30.250 UTC-05:00

Create a special datetime; Maybe the day you fell in love?

typescript
DateTime.fromObject({
  year: 2024,
  month: 2,
  day: 14,
  hour: 18,
  minute: 0,
  second: 0,
  millisecond: 0,
  offset: { hour: 1 }, // Paris? wow!
});

Offset

Which city is more to the west?

typescript
const losAngeles = Offset.fromZoneName("America/Los_Angeles");
const newYork = Offset.fromZoneName("America/New_York");

losAngeles.isWesterThan(newYork); // true

Interval

How many milliseconds has passed since your were born?

typescript
const birthday = DateTime.fromObject({
  year: 2000,
  month: 12,
  day: 7,
  hour: 0,
  minute: 0,
  second: 0,
  millisecond: 0,
  offset: { hour: 1 },
});
const now = DateTime.now();
Interval.between(birthday, now).duration.inMilliseconds;

// 761093667321

Duration

If each year of a dog's life is 7x of a humans, which is bigger? 1800 dog days? or 9000 human days?

typescript
const dogs = Duration.fromDays(1800).multiplyBy(7);
const humans = Duration.fromDays(9000);

dogs.isLongerThan(humans); // true