gitwtfhub

wtf is perscal?

mort3za/perscal — explained in plain English

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

JavaScriptAudience · developerComplexity · 1/5DormantSetup · easy

TL;DR

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

What's in the stack?

JavaScriptNode.jsnpm

How it stacks up

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 spin it up?

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

Yoink these 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

wtf 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane