amitgaru2/nepali-datetime

Python's core datetime inspired Bikram Sambat (BS date) & Nepal Time (NPT) package🇳🇵

Nepali Datetime (Bikram Sambat Date & Nepal Time)

The package inspired from Python's core datetime package that operates on top of Bikram Sambat (B.S) Date & Nepal Time (NPT) +05:45.

Supports: Python 3.5+

Basic Usage

# importing
>>> import datetime
>>> import nepali_datetime

# today's date
>>> datetime.date.today()
>>> nepali_datetime.date.today()

# now datetime
>>> datetime.datetime.now()
>>> nepali_datetime.datetime.now()

# creating date object
>>> datetime.date(2020, 9, 4)
>>> nepali_datetime.date(2077, 5, 19)

# creating datetime object
>>> datetime.datetime(2020, 9, 4, 8, 26, 10, 123456)
>>> nepali_datetime.datetime(2077, 5, 19, 8, 26, 10, 123456)

# date/datetime formatting
>>> nepali_datetime.datetime(2077, 5, 19, 8, 26, 10, 123456).strftime("%d %B %Y")
# 19 Bhadau 2077

# datetime parsed from string (strptime)
>>> nepali_datetime.datetime.strptime('2077-09-12', '%Y-%m-%d')
# nepali_datetime.datetime(2077, 9, 12, 0, 0)

# date/datetime formatting with Nepali unicode support
>>> nepali_datetime.date(1977, 10, 25).strftime('%K-%n-%D (%k %N %G)')
# १९७७-१०-२५ (७७ माघ आइतबार)

# datetime.timedelta addition/subtraction
>>> nepali_datetime.date(1990, 5, 10) + datetime.timedelta(days=350)
# nepali_datetime.date(1991, 4, 26)
>>> nepali_datetime.datetime(1990, 5, 10, 5, 10, 20) + datetime.timedelta(hours=3, minutes=15)
# nepali_datetime.date(1990, 5, 10, 8, 25, 20)

# convert B.S to A.D date and vice-versa
>>> nepali_datetime.date(1999, 7, 25).to_datetime_date()
# datetime.date(1942, 11, 10)
>>> nepali_datetime.date.from_datetime_date(datetime.date(1942, 11, 10))
# nepali_datetime.date(1999, 7, 25)

# Bikram Sambat monthly calendar
>>> nepali_datetime.date(2078, 1, 1).calendar()

          Baishakh 2078
Sun  Mon  Tue  Wed  Thu  Fri  Sat
                1    2    3    4
5     6    7    8    9   10   11
12   13   14   15   16   17   18
19   20   21   22   23   24   25
26   27   28   29   30   31

Installation

$ pip install nepali-datetime

Documentation

Complete usage documentations can be found here.

Contribution

Any contributions are most welcome. Do check this guidelines CONTRIBUTING.md for code contribution.

nepali-datetime's Issues

Neep Help

Sorry for this question, I know this is not a good platform for asking question. Actually I want to build a calendar using django same as below.
.

I've no idea, how to achieve this one. So can you please share some idea, or guide , that can help me to achieve this. and the last question is how can i use this package in my project. Please give me some idea, I wan't to learn some things in this lock down period.

I'm using django, and python default HTML Calendar modules and here is my progress.

[Feature Request] Get week number of the year

Can we get an implementation of "%U" flag as present in datetime to get the Week number of the year (Sunday as the first day of the week) for Nepali dates?

Isn't it supposed to be 17 exact?

>>> (nepali_datetime.datetime(2079, 8, 17) - nepali_datetime.datetime(2062, 8, 17)).days/365
17.013698630136986

Getting `day of month out of range` error.

Hi. I have been getting this day of month out of range error when trying to convert date to nepali; and format time.

While rendering Jestha 31, 2077

import nepali_datetime
from datetime import timedelta, datetime

somedate = datetime(2020, 6, 13, 19, 15, 20, 231407) 
jeth_31 = nepali_datetime.date.from_datetime_date(somedate.date())
jeth_31.strftime("%d %N %Y")            
# 31 जेष्ठ

Meanwhile Jestha 32, 2077

otherdate = datetime(2020, 6, 14, 19, 15, 20, 231407) 
jeth_32 = nepali_datetime.date.from_datetime_date(otherdate.date())
jeth_32.strftime("%d %N %Y") 
# day of month out of range error

Dunno if this is related with (Nepali) months with 32 date or something in the package itself.
If it helps, I am using Python 3.9, nepali-datetime 1.0.4.

Edit:: Update: Getting same error for Shrawan 32.

Adding Nepali Dates after 2100

I looked into the code of the project and noticed that there the date limited to 2100 bs. I need to implement dates greater than 2100 B.S. for a project. I will be implementing those dates. I will be willing to contribute. Let me know what you think.

calendar and Nepali unicode not rendering properly

Hi. There are some weird characters in the calendar CLI (I am using terminus in sublime3)
and the datetime.date objects to Nepali month conversion throws some error.

cmd output

edit: got this too "The string that could not be encoded/decoded was: %d कार्तिक"

Day is out of range for month

"day is out of range for month"

Addition of unicode time directives

Currently doesn't support nepali unicode Time directives.
i.e. so Time is displayed only in english literals like 01:22PM and not ०१:२२

`%N` directive not working with strptime

So, I checked and found that while using the strptime() method, the %N directive does not work.

Here are some snippets of the error

>>> d = "चैत्र"
>>> e = ndt.datetime.now().strftime("%N")
>>> d
'चैत्र'
>>> e
'चैत्र'
>>> z = ndt.datetime.strptime(d, "%N")
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/home/sthasam/Programming/investo_backend/.venv/lib/python3.8/site-packages/nepali_datetime/__init__.py", line 828, in strptime
    return _custom_strptime._strptime_datetime(cls, date_string, format)
  File "/home/sthasam/Programming/investo_backend/.venv/lib/python3.8/site-packages/nepali_datetime/_custom_strptime.py", line 295, in _strptime_datetime
    tt, fraction = _strptime(data_string, format)
  File "/home/sthasam/Programming/investo_backend/.venv/lib/python3.8/site-packages/nepali_datetime/_custom_strptime.py", line 135, in _strptime
    raise ValueError("'%s' is a bad directive in format '%s'" %
ValueError: 'N' is a bad directive in format '%N'
>>> d == e
True
>>> z = ndt.datetime.strptime(e, "%N")
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/home/sthasam/Programming/.venv/lib/python3.8/site-packages/nepali_datetime/__init__.py", line 828, in strptime
    return _custom_strptime._strptime_datetime(cls, date_string, format)
  File "/home/sthasam/Programming/.venv/lib/python3.8/site-packages/nepali_datetime/_custom_strptime.py", line 295, in _strptime_datetime
    tt, fraction = _strptime(data_string, format)
  File "/home/sthasam/Programming/.venv/lib/python3.8/site-packages/nepali_datetime/_custom_strptime.py", line 135, in _strptime
    raise ValueError("'%s' is a bad directive in format '%s'" %
ValueError: 'N' is a bad directive in format '%N'

As you can see, I tried two strings with the strptime

1. Directly storing the unicode in d
2. Deriving month name from inbuilt strftime method

Both do not work with strptime.

>>> f = "वैशाख"
>>> g = ndt.datetime(2000,1,1).strftime("%N")
>>> f
'वैशाख'
>>> g
'वैशाख'
>>> f==g
True
>>> m = ndt.datetime.strptime(f, "%N")
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/home/sthasam/Programming/.venv/lib/python3.8/site-packages/nepali_datetime/__init__.py", line 828, in strptime
    return _custom_strptime._strptime_datetime(cls, date_string, format)
  File "/home/sthasam/Programming/.venv/lib/python3.8/site-packages/nepali_datetime/_custom_strptime.py", line 295, in _strptime_datetime
    tt, fraction = _strptime(data_string, format)
  File "/home/sthasam/Programming/.venv/lib/python3.8/site-packages/nepali_datetime/_custom_strptime.py", line 135, in _strptime
    raise ValueError("'%s' is a bad directive in format '%s'" %
ValueError: 'N' is a bad directive in format '%N'

Same example as above but with a different month.

Today's date value based on the local time of the machine

ATM the nepali_datetime.date.today() is returning date based on the timezone of the machine. While the correct date to be returned should be always based on Nepal Time zone +05:45.

'%y' behaviour needs alteration

Currently, %y for any year 'xx' > 68 gives 19xx.

While the open group spec does suggest the range [69, 99] to be the year 1900s, it feels a tad bit foolish in the case of Nepali year, no? We're at 2077 currently; so I think that suggestion should be disregarded and updated accordingly.

Error in datetime conversion from english to nepali for a particular instance

When you do nepali_datetime.date.from_datetime_date(datetime.date(2024, 7, 15)), the result is 2081-3-32, which is not a valid date.

Need to fix name of months

Firstly, this is a great package. thanks for development. I just want to give a feedback from this thread.
Nepali months name is incorrectly displayed. I believe this is how they should be named.

Also, what about adding some more mathematical operations on the Nepali date and time?

Need to add datetime converter (AD to BS) and vice versa

hello there. I have also had experience with this package also (Nepali: v 0.4.1) in pip.
however I love this module and seen how this has evolved..!

If its not asking too much, can we have more features -
AD to BS and vice versa converter,,
months' name in Nepali (unicode) also..
strfdate and time nepali (unicode) as well..
render nepali calendar with tabbed/spacing month view (np/en)...

thanks for adding more datetime operations.. I have starred this project for your effort.

strftime to support nepali unicode completely

• support for days name ( like आइतबार सोमबार मंगलबार बुधवार बिहिबार शुक्रबार शनिबार )
• support for days & years digits ( like ०१२३४५६७८९, २०७५, २०७६, २०७७, ... )

[feature request] get AD dates of Nepali fiscal year

a feature to get AD version of current Nepali fiscal year.
(basically AD dates of gone Shrawan 1 and upcoming Asar masantar).

• feature display current year's Baisakh 1 in AD and chaitra masantar in AD.

• feature to display current F/Y's start and end date (fy_start, fy_end in AD).

• feature to display current F/Y's N months (fy start, fy N months):
  example when N = 10, return date (AD) of gone Shrawan 1 and coming Baisakh masantar (i.e the last date of N=10).

• add flag to return (i) dates (fy start, fy end as above), OR (ii) a list of months (e.g. [Shrawan, Bharda, ... , Baisakh])

• similarly, display previous and next fiscal years start and end AD dates.

please feel free to improvise the suggestion/request. Thanks

How can we convert the Nepali Date to AD?

Implementation of timestamp

As I see, the timestamp() has not been implemented as of yet. Putting this issue out there so devs out there can contribute to this issue.