README
Time Pocket - time utilities
Some simple time utilities which you can have with you while developing in JS.
🌟 Types Included 🌟
How to use
Install
npm install time-pocket --save-dev
namedDay()
Returns day name if it is today, tomorrow or yesterday, otherwise returns the day of the week.
Arguments
| Number | Type | Description |
|---|---|---|
| 0 | Date | Date to get day from |
Examples
import { datePrettify } from 'time-pocket'
const today = new Date(Date.now())
const yesterday = new Date(today)
yesterday.setDate(yesterday.getDate() - 1)
const tomorrow = new Date(today)
tomorrow.setDate(tomorrow.getDate() + 1)
const randomDate = new Date(today)
randomDate.setDate(randomDate.getDate() + 12)
console.log(namedDay(today))
console.log(namedDay(tomorrow))
console.log(namedDay(yesterday))
console.log(namedDay(randomDate))
/*
Today
Tomorrow
Yesterday
Thursday
*/
datePrettify()
Returns date in pretty format
Arguments
| Number | Type | Description |
|---|---|---|
| 0 | Date | Date to prettify |
| 1 | Options | Additional options |
Options
| Name | Type | Default | Description |
|---|---|---|---|
| pretty | boolean | true | If you also want the prettified string |
| format | string | DD-YY-MM DY | Format of the output of the pretty fromat |
Formats
| Name | Description | Example | Description |
|---|---|---|---|
| DD | Date | 19 | Date |
| MM | Month | January | Month in Letters |
| mM | Month (N) | Jan | Month short |
| mm | Month (N) | 01 | Month in Numbers |
| YY | Year | 2021 | Year |
| DY | Day | Monday | Day full |
| dy | Day | Mon | Day short |
Examples
import { datePrettify } from 'time-pocket'
const today = new Date(Date.now())
console.log(datePrettify(today))
/*
{
date: 29,
month: 'May',
year: 2021,
day: 'Saturday',
pretty: '29-May-2021, Saturday'
}
*/
console.log(datePrettify(today, { pretty: true, format: 'DD mM MM mm YY DY dy' }))
/*
{
date: 29,
month: 'January',
year: 2021,
day: 'Friday',
pretty: '29 01 January Jan 2021 Friday Fri'
}
*/
timePrettify()
Returns date in pretty format
Arguments
| Number | Type | Description |
|---|---|---|
| 0 | Date | Date to prettify time from |
| 1 | Options | Additional options |
Options
| Name | Type | Default | Description |
|---|---|---|---|
| pretty | boolean | true | If you also want the prettified string |
| twelveHour | boolean | false | If you want the time in 12 hour format |
Examples
import { timePrettify } from 'time-pocket'
const today = new Date(Date.now())
console.log(timePrettify(today))
/*
{ hour: 19, min: 57, sec: 59, pretty: '19:57:59' }
*/
hoursToMinSec()
Convert decimal hours to min and seconds
Arguments
| Number | Type | Description |
|---|---|---|
| 0 | number | Decimal time in hours |
| 1 | Options | Additional options |
Options
| Name | Type | Default | Description |
|---|---|---|---|
| milliseconds | boolean | false | Also return the milliseconds |
| txt | boolean | false | Also return the value in text format |
Examples
import { hoursToMinSec } from 'time-pocket'
console.log(hoursToMinSec(1.25))
// { hours: 1, minutes: 15, seconds: 0 }
console.log(hoursToMinSec(21.2534))
// { hours: 21, minutes: 15, seconds: 12 }
console.log(hoursToMinSec(0.756))
// { hours: 0, minutes: 45, seconds: 21 }
console.log(hoursToMinSec(1.25, { milliseconds: true, txt: true }))
/*
{
hours: 1,
minutes: 15,
seconds: 0,
milliseconds: 0,
txt: '1 hour 15 min 0 sec'
}
*/
console.log(hoursToMinSec(0.756, { milliseconds: true, txt: true }))
/*
{
hours: 0,
minutes: 45,
seconds: 21,
txt: '45 min 21 sec 599 millisecond',
milliseconds: 599,
}
*/
timeDifference()
Convert decimal hours to min and seconds
Arguments
| Number | Type | Description |
|---|---|---|
| 0 | string | Date |
Start date |
| 1 | string | Date |
End date |
| 2 | Boolean | If you want to seconds in the text output |
Examples
import { timeDifference } from 'time-pocket'
const today = new Date(Date.now())
const endDate = new Date(today)
endDate.setMinutes(endDate.getMinutes() + 5)
console.log(timeDifference(endDate, String(today)))
// { hours: 0, minutes: 5, seconds: 0, txt: '5 min 0 sec' }
