Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/robbdimitrov/quartzite
Lightweight relative date/time formatter without external dependencies
https://github.com/robbdimitrov/quartzite
date dateformatter javascript lightweight relative-date
Last synced: 2 days ago
JSON representation
Lightweight relative date/time formatter without external dependencies
- Host: GitHub
- URL: https://github.com/robbdimitrov/quartzite
- Owner: robbdimitrov
- License: mit
- Created: 2018-12-26T21:43:28.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-05-30T10:52:58.000Z (over 4 years ago)
- Last Synced: 2024-12-03T16:47:35.995Z (20 days ago)
- Topics: date, dateformatter, javascript, lightweight, relative-date
- Language: JavaScript
- Homepage:
- Size: 51.8 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Quartzite
Lightweight relative date/time formatter without external dependencies.
The formatter offers three styles - `short`, `medium` and `long`.
## Styles
| Short | Medium | Long |
| --- | --- | --- |
| now | Just now | Today, 18:00 |
| 25s | 25 seconds ago | Today, 18:00 |
| 30m | 30 minutes ago | Today, 17:30 |
| 18h | Today | Today 00:00 |
| 2d | Yesterday | Yesterday, 07:00 |
| 5d | November 7 | Thursday, November 7th |
| Oct 8, 2018 | October 8, 2018 | October 8th, 2018 |
| In 25s | In 25 seconds | Today, 10:00 |
| In 30m | In 30 minutes | Today, 10:30 |
| In 18h | Tomorrow | Tomorrow, 04:00 |
| In 2d | Thursday | Thursday, 10:00 |
| In 5d | November 17 | Sunday, November 17th |
| Dec 16, 2020 | December 16, 2020 | December 16th, 2020 |
## Installation
Using npm
```sh
$ npm install quartzite
```
Using cdn
```html
```
## Example
Importing as ES6 module
```javascript
import * as quartzite from 'quartzite';
```
or using CommonJS
```javascript
const quartzite = require('quartzite');
```
Create date in the past
```javascript
const date = new Date();
const yesterday = quartzite.dateByAdding('hours', date, -25);
```
Create date in the future
```javascript
const date = new Date();
const someday = quartzite.dateByAdding('days', date, 5);
```
Format date using `medium` style
```javascript
console.log(quartzite.dateString(yesterday)); // Medium is the default option
console.log(quartzite.dateString(someday, 'medium'));
```
Format date using `short` style
```javascript
console.log(quartzite.dateString(someday, 'short'));
```
Format date using `long` style
```javascript
console.log(quartzite.dateString(someday, 'long'));
```
## License
Licensed under the [MIT](LICENSE) License.