Simple and somewhat-localised timestamp formatting.

Note that in some cases, especially if you want to use standard formats and in other locales, it may be better to use the built-in Date or Intl functions.

Install with npm/pnpm/yarn:

npm i @eartharoid/dtf

const DTF = require('@eartharoid/dtf');
const dtf = new DTF();

// a new `Date` will be created
const timestamp = dtf.fill('DD/MM/YYYY HH:mm:ss');
console.log(timestamp); // => `13/07/2021 14:44:51`

// custom `Date` and use UTC time
const timestamp = dtf.fill('DD/MM/YYYY HH:mm:ss', new Date(), true);
console.log(timestamp); // => `13/07/2021 13:44:51`

See DTF#fill.

Create a new DTF instance.

• locale? - the locale of this DTF instance (default is 'en')

The locale of this DTF instance.

Fill a given or the default timestamp format using the current date or the Date provided.

• format? - the placeholder string (default is 'HH:mm:ss')
• date? - the Date object used to fill the placeholders (defaults to a new Date object)
• utc? - use UTC time? (default is false)

Returns 'AM' or 'PM' based on the time

• date? - the date to use (defaults to a new Date object)
• utc? - use UTC time? (default is false)

Appends st, nd, rd, or th to the given number for an English locale. I don't know what it does for other locales.

• number - the number to append the ordinal suffix to

Converts a 24h number to 12h.

• h - the 24h number

or sponsor me.

MIT license.

© 2021 Isaac Saunders