PersCal - Persian-Gregorian Date Converter for CLI
This is a command-line interface (CLI) tool for converting between Gregorian and Persian calendars. The tool is built with Node.js and utilizes the jalaali-js package for the calendar conversion.
Installation
To install the tool, first, you need to have Node.js installed on your machine. Then you can install the package via npm:
npm install -g perscal
Or without installation:
npx perscal <options>
Usage
You can use the --help option to see the available options:
perscal --help
Converting Gregorian to Persian
You can convert a Gregorian date to Persian using the following options:
-
-t, --timestamp <seconds>: Unix timestamp (seconds since 1970-01-01 00:00:00 UTC) -
-dt, --date <date-string>: "Gregorian date (YYYY-MM-DD) or other standard formats e.g. ISO 8601") -
-y, --year <year>: Gregorian year -
-m, --month <month>: Gregorian month -
-d, --day <day>: Gregorian day
Example:
perscal // output: 1401-12-27
perscal --date 2023-03-18 // 1401-12-27
perscal --year 2023 --month 3 --day 18 // output: 1401-12-27
Converting Persian to Gregorian
You can convert a Persian date to Gregorian using the following options:
-
-pd, --persian-date <persian-date>: Persian date (YYYY-MM-DD) -
-py, --persian-year <persian-year>: Persian year -
-pm, --persian-month <persian-month>: Persian month -
-pdy, --persian-day <persian-day>: Persian day
Example:
perscal --persian-date 1401-12-27 // output: 2023-3-18
perscal --persian-year 1401 --persian-month 12 --persian-day 27 // output: 2023-3-18
Output Separator for Persian Date
To specify the separator character, use -s, --separator <char> option for the output. The default separator is -.
Example:
perscal --year 2022 --month 3 --day 18 --separator /
License
This tool is licensed under the MIT license. See the LICENSE file for details.