https://github.com/missthee/datetool
JavaScript Date tool for formatting and processing
https://github.com/missthee/datetool
dateformat javascript js
Last synced: 3 months ago
JSON representation
JavaScript Date tool for formatting and processing
- Host: GitHub
- URL: https://github.com/missthee/datetool
- Owner: MissThee
- Created: 2020-11-10T10:13:05.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2022-12-27T07:20:16.000Z (over 2 years ago)
- Last Synced: 2025-02-07T17:02:47.935Z (4 months ago)
- Topics: dateformat, javascript, js
- Language: JavaScript
- Homepage:
- Size: 1.16 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# date-tool
## Overview
An open source simple JavaScript Date library for formatting and processing.
## Getting Started
install
```
npm i @missthee/datetool
```
use
```js
import { dateToString, addDay, DateHepler } from "@missthee/datetool";
let date = new Date('2000/01/01');
//formatting
console.log(dateToString(date, 'yyyy-MM-dd')); // 2000-01-01
//processing
//NOTICE: All calculation operations will change the incoming Date object
let result = addDay(date, 1);
console.log(result); // 2000-01-02
console.log(date); // 2000-01-02
```
## Example
```js
import {DateHelper, dateToStringFactory, dateToString, getFullDayInMonth, isLeapYear, addMillisecond, addSecond, addMinute, addHour, addDay, addMonth, addYear,} from "@missthee/datetool";
let date = new Date('2000-01-01');
//formatting
dateToString(date, 'yyyyMMdd'); //20000101
let dts = dateToStringFactory('yyyyMMdd');
dts(date); //20000101
dts(new Date('2020/11/11')); //20201111
//processing
//NOTICE: All calculation operations will change the incoming Date object
new DateHelper(date).addDay(1).addMonth(1).addYear(-1).getDate();
addYear(date, 1);
addMonth(date, 1);
addDay(date, 1);
addHour(date, 1);
addMinute(date, 1);
addSecond(date, 1);
addMillisecond(date, 1);
//misc
isLeapYear(2000); //true
getFullDayInMonth(2000, 1); //29
```
## Converting to String
| Key | Description | Value |
| :---- | :---- | :---- |
| yyyy | The year | `1999` `2001` |
| yy | The year's last two-digit number | `99` `01` |
| MM | The month of the year with leading zero | `01` - `12` |
| M | The month of the year between 1-12 | `1` - `12` |
| dd | The day of the month with leading zero | `01` - `31` |
| d | The day of the month between 1 and 31 | `1` - `31` |
| HH | The hour of the day with leading zero | `00` - `23` |
| H | The hour of the day between 0-23 | `0` - `23` |
| hh | The hour of the day with leading zero | `01` - `12` |
| h | The hour of the day between 1-12 | `1` - `12` |
| mm | The minute of the hour with leading zero | `00` - `59` |
| m | The minute of the hour between 0-59 | `0` - `59` |
| ss | The seconds of the minute with leading zero | `00` - `59` |
| s | The seconds of the minute between 0-59 | `0` - `59` |
| SSS | The milliseconds of the second between .000-.999 | `000` - `999` |
| SS | The milliseconds of the second between .00-.99 | `00` - `99` |
| S | The milliseconds of the second between .0-.9 | `0` - `9` |