@smarttuna/ez-datetime-vanillajs
Easy peasy datetime module (Vanilla JS)
@smarttuna/ez-datetime-vanillajs is a lightweight JavaScript library for working with dates and timezones. It provides an easy-to-use interface for creating, manipulating, and formatting dates. It supports various date formats and allows you to perform calculations and get the difference between dates.
Installation
You can install @smarttuna/ez-datetime-vanillajs using npm or by including the library directly in your HTML file.
npm
npm install @smarttuna/ez-datetime-vanillajsHTML
Add the following script tag to your HTML file:
<script src="https://unpkg.com/@smarttuna/ez-datetime-vanillajs@latest/dist/main.js"></script>Usage
To use @smarttuna/ez-datetime-vanillajs, you need to create an instance of the ezDatetime class. You can optionally provide a target date and timezone when creating the instance. If no target date or timezone is provided, the current date and the local timezone will be used.
Here's an example of creating an ezDatetime object:
// You don't need this import statement if you load the package using an HTML script tag
import ezDatetime from '@smarttuna/ez-datetime-vanillajs';
const targetDate = '2023-07-16 15:30:00';
const timezone = 'America/New_York';
const datetime = new ezDatetime(targetDate, timezone);timezone parameter should be a string of the IANA Timezone Identifier format, and the list of identifiers and UTC offset data is embedded within the ezDatetime class. You can access the object using ezDatetime.timezones.
Object Creation Examples
- Create an ezDatetime object with the current date and local timezone:
const datetime = new ezDatetime();- Create an ezDatetime object with a specific target date and local timezone:
const targetDate = '2023-07-16 15:30:00';
const datetime = new ezDatetime(targetDate);- Create an ezDatetime object with the current date and a specific timezone:
const timezone = 'America/New_York';
const datetime = new ezDatetime(null, timezone);- Create an ezDatetime object with a specific target date and timezone:
const targetDate = '2023-07-16 15:30:00';
const timezone = 'America/New_York';
const datetime = new ezDatetime(targetDate, timezone);Other method
const datetime = new ezDatetime();
// Change the timezone
datetime.setTimezone('America/New_York');
// Get the formatted date
const formattedDate = datetime.format('yyyy-mm-dd HH:mm:ss.SSS');
// Add or subtract dates
datetime.calculate('+2 days');
datetime.calculate('-3 months');
datetime.calculate('+48 hours');
// Get the difference between two dates
const otherDatetime = new ezDatetime();
const differenceInSecond = datetime.getDifference(otherDatetime);
const differenceInHour = datetime.getDifference(otherDatetime, 'hour');
const differenceInWeek = datetime.getDifference(otherDatetime, 'week');
// Get the year
const year = datetime.getYear();
// Get the month (Response is in the range of 1 ~ 12)
const month = datetime.getMonth();
// Get the date
const date = datetime.getDate();
// Get the hours
const hours = datetime.getHours();
// Get the minutes
const minutes = datetime.getMinutes();
// Get the seconds
const seconds = datetime.getSeconds();
// Get the milliseconds
const milliseconds = datetime.getMilliseconds();
// Convert to string
const stringRepresentation = datetime.toString();
// Convert to ISO string
const isoString = datetime.toISOString();
// Convert to UTC string
const utcString = datetime.toUTCString();Support
Release Notes
See CHANGELOG.md
License
See LICENSE.md