#gregorian #convert #date #nepali #calendar #bikram

bin+lib nepdate-cli

A library for converting between Gregorian and Bikram Sambat (Nepali) dates

2 releases

0.1.5 Feb 5, 2026
0.1.4 Jul 15, 2025
0.1.3 Oct 19, 2024

#173 in Date and time

GPL-3.0-or-later

26KB
367 lines

nepdate-cli

nepdate-cli is a simple command-line program built using the bikram library to convert dates between Bikram Sambat (Nepali calendar) and Gregorian dates.

Features

  • Convert Gregorian dates to Bikram Sambat.
  • Convert Bikram Sambat dates to Gregorian.

Installation and Setup

Prerequisites

  • Rust programming language
  • Cargo (Rust package manager). install instruction for rust HERE.

Clone the Repository

First, clone the repository:

git clone --branch rust https://github.com/khumnath/nepdate-cli.git
cd nepdate-cli

Build the Program

  1. Make sure to give execution permissions to the build.sh script:

    chmod +x build.sh
    
  2. Run the build.sh script to build the program and set up the build folder:

    ./build.sh
    

This script will:

  • Compile the program in release mode and store the output in the target directory.
  • Display the path to the executable.
  • Test the program by running it.

The executable path should be printed in the terminal, and after 2 seconds, the program will be test run automatically.

Install using cargo

cargo install nepdate-cli Running the above command will globally install the nepdate-cli binary.

using library in other applications

Run the following Cargo command in your project directory:

cargo add nepdate-cli

Or add the following line to your Cargo.toml:

nepdate-cli = "0.1.3" nepdate-test-app folder has example of an application. use bikram::bikram::Bikram; should import bikram library after adding nepdate-cli dependency in application.

Usage

After building the program, you can use it to convert dates between the two calendar systems.

Convert to Nepali Date (Bikram Sambat):

./target/release/nepdate-cli --conv --tobs <year> <month> <day>

Example:

./target/release/nepdate-cli --conv --tobs 2024 10 18

Convert to Gregorian Date:

./target/release/nepdate-cli --conv --toad <year> <month> <day>

Example:

./target/release/nepdate-cli --conv --toad 2081 6 1

License

nepdate-cli is released under the GNU General Public License v3.0. See the LICENSE file for more details.

Contact

For any inquiries, you can reach out to khumnath cg.

Dependencies

~1MB
~18K SLoC