persian-date-parser v2.1.0

Persian date parser

Library for parsing date and time to desired format (Jalali, Gregorian or mixed).

When possible consider using built-in Date.prototype.toLocaleDateString() method.

Usage

> npm i persian-date-parser

const parser = require('persian-date-parser')

From the above line parser accepts two optional arguments: cache capacity and cache type. Each cache entry has a string (format) as its key (i.e. 'gyyyy-gm-gd') and a function as its value. If in your use-case format strings are limited, parser can benefit from caching those functions. On subsequent parsings for the same format, tokenizing and arranging steps are the same and can be bypassed by using cache, which results in better performance.

const parse = parser() // no caching by default

or

const parse = parser(1000) // or parser(1000, 'LRU')

const now = new Date()

Jalali example:

const format = 'pjyyyy/pjmm/pjdd - pjdddd - pjHH:pjMM pjTT'
const result = parse(format, now)
// result: ۱۳۹۹/۰۶/۰۹ - یکشنبه - ۲۱:۳۶ ب.ظ

Gregorian Example:

const format = 'gyyyy/gmm/gdd - gdddd - gHH:gMM gTT'
const result = parse(format, now)
// result: 2020/08/30 - Sunday - 21:36 PM

Masks

Masks are according to following table but there are three general prefixes used with them. Using g or j is mandatory.

• g: Gregorian date.

• j: Jalali date.

• p: Represent results in Persian (numbers, month names, weekdays and their abbreviations).