tinydate

WebJar for tinydate

License	MIT
GroupId	org.webjars.npm
ArtifactId	tinydate
Last Version	1.2.0
Release Date	Oct 19, 2019
Type	jar
Description	tinydate WebJar for tinydate
Project URL	http://webjars.org
Source Code Management	https://github.com/lukeed/tinydate

Download tinydate

Filename	Size
tinydate-1.2.0.pom
tinydate-1.2.0.jar	6 KB
tinydate-1.2.0-sources.jar	22 bytes
tinydate-1.2.0-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/tinydate/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>tinydate</artifactId>
    <version>1.2.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/tinydate/
implementation 'org.webjars.npm:tinydate:1.2.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/tinydate/
implementation ("org.webjars.npm:tinydate:1.2.0")

Apache Buildr

'org.webjars.npm:tinydate:jar:1.2.0'

Apache Ivy

<dependency org="org.webjars.npm" name="tinydate" rev="1.2.0">
  <artifact name="tinydate" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='tinydate', version='1.2.0')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "tinydate" % "1.2.0"

Leiningen

[org.webjars.npm/tinydate "1.2.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

tinydate

A tiny (349B) reusable date formatter. Extremely fast!

Demo

Inspired by tinytime, this module returns a "render" function that efficiently re-render your deconstructed template. This allows for incredibly performant results!

However, please notice that this only provides a limited subset of Date methods.
If you need more, tinytime or date-fns are great alternatives!

Install

$ npm install --save tinydate

Usage

const tinydate = require('tinydate');
const fooDate = new Date('5/1/2017, 4:30:09 PM');

const stamp = tinydate('Current time: [{HH}:{mm}:{ss}]');

stamp(fooDate);
//=> Current time: [16:30:09]

stamp();
//=> Current time: [17:09:34]

API

tinydate(pattern, dict?)(date?)

Returns: Function

Returns a rendering function that will optionally accept a date value as its only argument.

pattern

Type: String
Required: true

The template pattern to be parsed.

dict

Type: Object
Required: false

A custom dictionary of template patterns. You may override existing patterns or declare new ones.

Important: All dictionary items must be a function and must control its own formatting.
For example, when defining your own {ss} template, tinydate will not pad its value to two digits.

const today = new Date('2019-07-04, 5:30:00 PM');

// Example custom dictionary:
//   - Adds {MMMM}
//   - Overrides {DD}
const stamp = tinydate('Today is: {MMMM} {DD}, {YYYY}', {
	MMMM: d => d.toLocaleString('default', { month: 'long' }),
	DD: d => d.getDate()
});

stamp(today);
//=> 'Today is: July 4, 2019'

date

Type: Date
Default: new Date()

The date from which to retrieve values. Defaults to current datetime if no value is provided.

Patterns

• {YYYY}: full year; eg: 2017
• {YY}: short year; eg: 17
• {MM}: month; eg: 04
• {DD}: day; eg: 01
• {HH}: hours; eg: 06 (24h)
• {mm}: minutes; eg: 59
• {ss}: seconds; eg: 09
• {fff}: milliseconds; eg: 555

Benchmarks

# Node v10.13.0

tinydate    x 160,834,214 ops/sec ±0.21% (96 runs sampled)
tinytime    x  44,602,162 ops/sec ±0.34% (97 runs sampled)
time-stamp  x     888,153 ops/sec ±1.27% (86 runs sampled)

License

MIT © Luke Edwards

Versions

Version
1.2.0 Oct 19, 2019