semvec/pypi-packages huggingface dataset:
bikram 2.1.4
Utilities to work with Bikram/Vikram Samwat dates.
License: MIT license
Keywords: bikram bikram samwat vikram samwat nepali date

bikram
------

.. image:: https://img.shields.io/pypi/v/bikram.svg
        :target: https://pypi.python.org/pypi/bikram

.. image:: https://img.shields.io/travis/poudel/bikram.svg
        :target: https://travis-ci.org/poudel/bikram

.. image:: https://readthedocs.org/projects/bikram/badge/?version=latest
        :target: https://bikram.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status


Utilities to work with Bikram/Vikram Samwat dates. Documentation: https://bikram.readthedocs.io.


Getting started
---------------

* Install the :code:`bikram` package: https://bikram.readthedocs.io/installation.html.
* Read the usage guide: https://bikram.readthedocs.io/usage.html.
* Read the module reference guide: https://bikram.readthedocs.io/bikram.html.


Features
--------

* Convert Bikram Samwat dates to AD and vice versa in a few line of codes.
  Intended to be useful for Nepali software developers.
* Well tested and readable source code.
* Date operations, i.e. addition/subtraction,
  supported with :code:`datetime.date` and :code:`datetime.timedelta` within range.
* Supports comparison with :code:`datetime.date` and :code:`datetime.timedelta` objects.
* Supports string formatting of `samwat` dates.


Caveats
-------

* Is not very helpful if the date falls outside the map of BS years to days in month.


Credits
---------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage



=======
History
=======

2.1.3 to 2.1.4 (2025-10-17)
---------------------------
* Few changes have been made to make the date map accurate as reported by several contributors.
* 2082 and 2083 BS Date changes and confirmed as per the Nepal RajPatra
* 2.1.4 - Bump to push the change log

2.1.0 to 2.1.3 (2024-06-20)
---------------------------
* Few changes have been made to make the date map accurate as reported by several contributors.
* 2062 BS Date changes and confirmed as per the Nepal RajPatra
* 2081 BS Date changes and confirmed as per the calendar published in 2081
* out of bound checks as suggested by Dipendra Nath (dipee), FIRST_AD_YEAR, LAST_AD_YEAR constanst introduced.
* 2.1.3 - Bump to push the change log

1.0.0 (2018-03-15)
------------------

* Added usage guide and module docs.
* Added :code:`pipenv` support.
* Removed :code:`tox`.
* Removed support for python versions older than 3.6.


0.1.2 (2016-11-13)
------------------

* Minor test fixes.


0.1.0 (2016-11-13)
------------------

* First release on PyPI.