@pinemach/truncate-date
v1.0.0
Published
Truncate date values, reducing their precision.
Downloads
275
Readme
@pinemach/truncate-date
@pinemach/truncate-date is a small JavaScript package with a single concern: truncating datetime inputs to remove all precision past a given time unit.
You can read the full API documentation at pineapplemachine.github.io/truncate-date-js/.
Installation
You can install this package with the package manager of your choice. For example,
npm install @pinemach/truncate-date
You can then import and use the module like so:
const truncateDate = require("@pinemach/truncate-date").truncateDate; // CommonJS
import {truncateDate} from "@pinemach/truncate-date"; // ES6 modules
Usage
This package exports the truncateDate function, which accepts a Date object or other time value input and a time unit to truncate that value to.
Truncation occurs in the UTC timezone.
import {truncateDate} from "@pinemach/truncate-date";
const myDate = new Date("2020-04-15T12:30:15.123Z");
// Logs "2020-04-15T12:30:15.000Z"
console.log(truncateDate("second", myDate));
// Logs "2020-04-15T12:00:00.000Z"
console.log(truncateDate("hour", myDate));
// Logs "2020-04-15T00:00:00.000Z"
console.log(truncateDate("day", myDate));
// Logs "2020-01-01T00:00:00.000Z"
console.log(truncateDate("year", myDate));