Tardis JS V1.6.3

Tardis JS an open source JavaScript Date library for parsing, formatting and processing. A simple, light weight and easy to implement module that you can use in your JS appication or website.

Install

Via NPM: npm i lbx-tardis

or

Include tardis.js in your build directory or link to it directly

Download tardis.js or tardis.min.js

Clone it on GitHub

Usage

const getDate = tardis.dateparts() // { year: 119, month: 6, day: 29, hour: 13, min: '04', sec: '12', fullYear: 2019, shortYear: '19', wordYear: 'two thousand and nineteen',  fullMonth: 'June',  shortMonth: 'Jun',....}

const getISO = tardis.ISO() // 2019-06-29

const getTimeStamp = tardis.patterned(1133481000, 'M/DD/YYYY - H:I:s TT tt'); // { pattern: '12/02/2005 - 18:50:{{26}} PM pm', time: 1133481000 }

const getTime = tardis.patterned('2019-06-29T17:26:43', 'M/DD/YYYY - HH:II:SS tt'); //{ pattern: '6/30/2019 - 18:26:43 pm', time: '2019-06-29T17:26:43' }

The Date Object

{
    
year: 125
month: 4
day: 7
hour: 19
min: "45"
sec: "58"
fullYear: 2025
shortYear: "25"
wordYear: "two thousand and twenty five"
fullMonth: "April"
shortMonth: "Apr"
fullDay: "Monday"
shortDay: "Mon"
wordHour: "nineteen"
wordMin: "forty five"
wordSec: "fifty eight"
yearInt: 125
monthInt: 3
dayInt: 1
hourInt: 19
minInt: 45
secInt: 58
YYear: "25"
MMonth: "04"
DDay: "08"
HHour: "19"
MMin: "45"
SSec: "58"
TT: "PM"
tt: "pm"
utc: Mon Apr 07 2025 19:45:58 GMT+0000 (Coordinated Universal Time)
timestamp: "1744055158"

}
                

Filters

By using a simple mask you can create a unique time format to meet all of your needs. Simply by invoking the patterned method, passing in a time stamp and defining a filter pattern. If you do not supply a time stamp the method will assume you want the current time and return date.Now(). The returned object ({pattern: pattern, time: theTime}) with have your patterned string and the time as a unix timestamp should you need to reuse it.

Presets

Tardis JS has several prebuilt filter patterns for the most commonly used time formats. Simply, call the method of the preset format you want and set a timestamp. If you do not supply a timestamp, date.Now() will be returned.

tardis.ISO({date})                // 2025-04-8
tardis.ShortDate({date})          // 04/8/2025
tardis.LongDate({date})           // Apr 8 2025
tardis.DayMonthDate({date})       // Tuesday, April 8, 2025
tardis.MonthDateTime({date})      // April 8, 2025 0:45
tardis.MonthDateTime12({date})    // April 8, 2025 12:45 PM
tardis.MonthDate({date})          // April 8, 2025
tardis.TimeOfDay({date})          // 0:45:59
tardis.TimeOfDay12({date})        // 12:45:59 PM
tardis.Year({date})               // 2025
tardis.Month({date})              // April
tardis.Day({date})                // Tuesday