ndate: Bikram Sambat Date Converter

ndate is a command-line tool for displaying and converting dates between the Bikram Sambat (Vikram Samvat) and Gregorian calendars. It's a simple utility designed for easy interaction with these two calendar systems.

Features

• Display the current Bikram Sambat date.
• Convert dates between Bikram Sambat and Gregorian calendars.
• Supports very long date range.

Installation

There are two installation methods available: using a Debian package or compiling from source.

From Debian Package

1. Download the latest .deb file from the releases page.
2. Install the package using dpkg:

Bash

sudo dpkg -i ndate_1.0.0_amd64.deb

Replace ndate_1.0.0_amd64.deb with the filename of the downloaded package.

From Source

1. Clone the repository:

Bash

git clone https://github.com/khumnath/ndate.git
cd ndate

2. Install dependencies:

Bash

sudo apt-get update
sudo apt-get install -y cmake build-essential debhelper devscripts

• packages debhelper and devscripts are for building debian installer package.

3. Build and install:

Bash

mkdir build
cd build
cmake ..
make
sudo make install

• if need to build deb package, run dpkg-buildpackage -b after make

Usage

Once installed, you can use ndate from the command line. Here are some basic commands:

• Display the current Bikram Sambat date:

Bash

ndate

output:

• Convert to Bikram Sambat

 ndate --conv --tobs 2024 8 10

output:

• Convert a Bikram Sambat date to Gregorian:

ndate --conv --toad 2081 4 26  

output:

** Replace the date strings with the date you want to convert.

Contributing

Contributions are welcome! If you have any bug reports or feature requests, please open an issue on the GitHub repository.

Here's a quick guide to contributing code:

1. Fork the repository.
2. Create a new branch for your changes.
3. Commit your changes and push them to your fork.
4. Open a pull request against the main branch of the original repository.

License

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