explaingit

mort3za/perscal

Analysis updated 2026-07-18 · repo last pushed 2023-03-18

JavaScriptAudience · developerComplexity · 1/5DormantSetup · easy

TLDR

PersCal is a command-line tool that instantly converts dates between the Gregorian and Persian calendars, useful for developers and businesses working with Persian-speaking audiences.

Mindmap

mindmap
  root((repo))
    What it does
      Converts calendar dates
      Gregorian to Persian
      Persian to Gregorian
    Tech stack
      JavaScript
      Node.js
    Use cases
      Date conversion scripts
      Iranian audience apps
    Audience
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Convert a Gregorian date to its Persian calendar equivalent from the command line without searching for an online converter.

USE CASE 2

Integrate PersCal into a script to convert dates programmatically for an app serving an Iranian audience.

USE CASE 3

Run the tool with npx for a one-off date conversion without installing anything permanently.

What is it built with?

JavaScriptNode.jsnpm

How does it compare?

mort3za/perscal3rd-eden/ircb.ioa15n/a15n
LanguageJavaScriptJavaScriptJavaScript
Last pushed2023-03-182016-11-162019-04-07
MaintenanceDormantDormantDormant
Setup difficultyeasyeasyeasy
Complexity1/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min
No license information was stated in the explanation.

Copy-paste prompts

Prompt 1
Show me the npx command to convert the Gregorian date March 18, 2023 to the Persian calendar using PersCal.
Prompt 2
How do I install PersCal with npm and use it to convert a Persian date back to Gregorian in my terminal?
Prompt 3
Write a Node.js script that uses PersCal's underlying jalaali-js logic to convert a list of Gregorian dates to Persian calendar dates.
Prompt 4
Show me how to customize PersCal's date separator to use a slash instead of a dash in its output.

Frequently asked questions

What is perscal?

PersCal is a command-line tool that instantly converts dates between the Gregorian and Persian calendars, useful for developers and businesses working with Persian-speaking audiences.

What language is perscal written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, npm.

Is perscal actively maintained?

Dormant — no commits in 2+ years (last push 2023-03-18).

What license does perscal use?

No license information was stated in the explanation.

How hard is perscal to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is perscal for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.