npdatetime 0.1.1__py3-none-any.whl → 0.2.0.dev2__py3-none-any.whl

npdatetime/__init__.py

@@ -15,6 +15,8 @@ import time as _time
 import math as _math
 import datetime as _actual_datetime
 
+from npdatetime.utils import get_fiscal_year_by_date
+
 from .config import CALENDAR_PATH, MINDATE, MAXDATE, REFERENCE_DATE_AD
 
 MINYEAR = MINDATE['year']
@@ -376,7 +378,13 @@ class date:
         if not isinstance(from_date, _actual_datetime.date):
             raise TypeError("Unsupported type {}.".format(type(from_date)))
         return cls(MINYEAR, 1, 1) + (from_date - _actual_datetime.date(**REFERENCE_DATE_AD))
-
+    
+    @classmethod
+    def current_fiscal_year(cls):
+        """Return the current fiscal year"""
+        current_date = cls.today()
+        return get_fiscal_year_by_date(current_date)
+    
     def to_datetime_date(self):
         """Convert npdatetime.date to datetime.date (B.S date to A.D).
 

npdatetime/utils.py

@@ -0,0 +1,9 @@
+
+def get_fiscal_year_by_date(date_obj):
+   """Return fiscal year by the given Nepali datetime object"""
+   # Fiscal year starts in Shrawan (month 4)
+   if date_obj.month < 4:  # Months 1, 2, 3 are part of the previous fiscal year
+      fiscal_year = (date_obj.year - 1, date_obj.year)
+   else:
+      fiscal_year = (date_obj.year, date_obj.year + 1)
+   return fiscal_year

npdatetime-0.2.0.dev2.dist-info/METADATA

@@ -0,0 +1,273 @@
+Metadata-Version: 2.1
+Name: npdatetime
+Version: 0.2.0.dev2
+Summary: A Python package that provides advanced functionality for handling Nepali dates and times, including support for the Bikram Sambat calendar system and Nepal Time (NPT). Ideal for developers working with Nepali date-related applications, offering seamless conversion, manipulation, and formatting of dates and times in the Nepali calendar.
+Home-page: https://github.com/4mritGiri/npdatetime
+Author: Amrit Giri
+Author-email: Amrit Giri <amritgiri02595@gmail.com>
+License: The MIT License (MIT)
+        Copyright © 2020 AMRIT GIRI
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the “Software”), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in
+        all copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+        THE SOFTWARE.
+Project-URL: Homepage, https://github.com/4mritGiri/npdatetime#readme
+Project-URL: Issues, https://github.com/4mritGiri/npdatetime/issues
+Keywords: Nepali Date,Date Conversion,Datetime,Bikram Sambat,Bikram Samvat,nepali,B.S.,BS,bs,b.s,date,NpDateTime,datetime,time,timezone,nepal,bikram,sambat,samvat,nepali-date,nepali-datetime,nepal-time,npt,nepal-timezone,npdatetime,npdt
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.5
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# **Nepali Datetime (Bikram Sambat Date & Nepal Time)**  
+
+A Python library inspired by Python's core `datetime` module, designed specifically for operations based on the **Bikram Sambat (B.S.)** calendar and **Nepal Time (NPT)** timezone (`UTC+05:45`).  
+
+This library bridges the gap between traditional Nepali dates and modern software development, allowing developers to handle Nepali dates with ease while maintaining compatibility with Python's `datetime`.  
+
+---
+
+## **Key Features**  
+
+- Full support for Bikram Sambat (B.S.) date operations.  
+- Handles Nepal Time (NPT) seamlessly (`UTC+05:45`).  
+- Built-in compatibility with Python's `datetime` module.  
+- Supports date formatting with Nepali Unicode for localized output.  
+- Conversion between Bikram Sambat and Gregorian calendars.  
+- Convenient utilities for date parsing, arithmetic, and calendars.  
+- Compatible with Python 3.5 and above.  
+
+---
+
+## **Installation**  
+
+Install the package via `pip`:  
+```bash  
+pip install npdatetime  
+```  
+
+---
+
+## **Quick Start**  
+
+Here's how you can use `npdatetime` alongside Python's standard `datetime` module:  
+
+### **Importing**  
+```python  
+import datetime  
+import npdatetime  
+```  
+
+### **Getting Today's Date**  
+```python  
+# Gregorian date  
+datetime.date.today()  
+
+# Bikram Sambat date  
+npdatetime.date.today()  
+```  
+
+### **Current Date and Time**  
+```python  
+# Gregorian datetime  
+datetime.datetime.now()  
+
+# Bikram Sambat datetime  
+npdatetime.datetime.now()  
+```  
+
+---
+
+## **Key Functionalities**  
+
+### **Creating Date and Datetime Objects**  
+```python  
+# Gregorian date  
+datetime.date(2020, 9, 4)  
+
+# Bikram Sambat date  
+npdatetime.date(2077, 5, 19)  
+
+# Gregorian datetime  
+datetime.datetime(2020, 9, 4, 8, 26, 10, 123456)  
+
+# Bikram Sambat datetime  
+npdatetime.datetime(2077, 5, 19, 8, 26, 10, 123456)  
+```  
+
+### **Date Formatting with Localization**  
+```python  
+# Formatting a Bikram Sambat date  
+npdatetime.datetime(2077, 5, 19).strftime("%d %B %Y")  
+# Output: 19 Bhadau 2077  
+
+# Formatting with Nepali Unicode  
+npdatetime.date(2077, 10, 25).strftime('%K-%n-%D (%k %N %G)')  
+# Output: २०७७-१०-२५ (२५ माघ आइतबार)  
+```  
+
+### **Parsing Dates from Strings**  
+```python  
+npdatetime.datetime.strptime('2077-09-12', '%Y-%m-%d')  
+# Output: npdatetime.datetime(2077, 9, 12, 0, 0)  
+```  
+
+### **Timedelta Operations**  
+```python  
+# Adding days to a date  
+npdatetime.date(1990, 5, 10) + datetime.timedelta(days=350)  
+# Output: npdatetime.date(1991, 4, 26)  
+
+# Adding hours and minutes to a datetime  
+npdatetime.datetime(1990, 5, 10, 5, 10) + datetime.timedelta(hours=3, minutes=15)  
+# Output: npdatetime.datetime(1990, 5, 10, 8, 25)  
+```  
+
+### **Bikram Sambat <-> Gregorian Conversion**  
+```python  
+# Convert Bikram Sambat to Gregorian  
+npdatetime.date(1999, 7, 25).to_datetime_date()  
+# Output: datetime.date(1942, 11, 10)  
+
+# Convert Gregorian to Bikram Sambat  
+npdatetime.date.from_datetime_date(datetime.date(1942, 11, 10))  
+# Output: npdatetime.date(1999, 7, 25)  
+```  
+
+### **Bikram Sambat Monthly Calendar**  
+```python  
+npdatetime.date(2078, 1, 1).calendar()  
+
+# Output:  
+          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  
+```  
+
+---
+
+## **Fiscal Year Calculations**
+
+The **npdatetime** library provides methods to easily calculate the current fiscal year and convert dates to their corresponding fiscal year. Fiscal years in Nepal start from **Shrawan (month 4)** and end at **Ashadh (month 12)**.
+
+### **Getting the Current Fiscal Year**
+You can get the current fiscal year using the `current_fiscal_year()` method. It returns the fiscal year as a tuple in the format `(start_year, end_year)`.
+
+```python
+import npdatetime
+
+# Get current fiscal year
+npdatetime.datetime.current_fiscal_year()
+# Output: (2081, 2082)
+```
+
+Alternatively, you can use it directly from the `datetime` class:
+
+```python
+from npdatetime import datetime
+
+# Get current fiscal year
+datetime.current_fiscal_year()
+# Output: (2081, 2082)
+```
+
+### **Getting Fiscal Year for a Specific Date**
+You can also calculate the fiscal year for any specific Nepali date using the `get_fiscal_year_by_date()` function. This takes a `datetime` object as input and returns the fiscal year for that date.
+
+```python
+from npdatetime import get_fiscal_year_by_date
+from npdatetime import datetime
+
+# Example date
+date_obj = datetime(2079, 12, 1)
+
+# Get fiscal year for a specific date
+get_fiscal_year_by_date(date_obj)
+# Output: (2079, 2080)
+
+# You can also directly pass a Nepali datetime object to the function
+get_fiscal_year_by_date(datetime(2080, 4, 1))
+# Output: (2080, 2081)
+```
+
+### **Examples**
+
+Here are a few examples of how you can use the `get_fiscal_year_by_date()` method to calculate the fiscal year for various dates:
+
+```python
+# For 2079-12-01
+get_fiscal_year_by_date(datetime(2079, 12, 1))
+# Output: (2079, 2080)
+
+# For 2080-03-01
+get_fiscal_year_by_date(datetime(2080, 3, 1))
+# Output: (2079, 2080)
+
+# For 2080-04-01
+get_fiscal_year_by_date(datetime(2080, 4, 1))
+# Output: (2080, 2081)
+
+# For 2080-06-01
+get_fiscal_year_by_date(datetime(2080, 6, 1))
+# Output: (2080, 2081)
+```
+
+### **Note**
+- The fiscal year is based on the Nepali date system, which is different from the Gregorian calendar. In Nepal, the fiscal year runs from **Shrawan (month 4)** to **Ashadh (month 12)**.
+
+---
+
+## **Documentation**  
+
+Comprehensive usage examples and detailed documentation can be found on the [official website](https://4mritGiri.github.io/npdatetime/).  
+
+---
+
+## **Contributing**  
+
+We welcome contributions! If you'd like to contribute, check out the [CONTRIBUTING.md](https://github.com/4mritGiri/npdatetime/blob/master/CONTRIBUTING.md) guide for details on how to get started.  
+
+---
+
+## **License**  
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.  
+
+---
+
+## **Feedback & Support**  
+
+For feature requests, bug reports, or feedback, please create an issue on the [GitHub repository](https://github.com/4mritGiri/npdatetime/issues).  
+
+---
+
+### 🌟 **Made for Developers, by Developers** 🌟  
+Your feedback and support are invaluable in making **npdatetime** the go-to library for working with Nepali dates. Thank you! 🙌  
+
+---  
+
+### **Improvements in This Version**  
+1. Enhanced structure with logical sections for better readability.  
+2. Highlighted key functionalities for quick reference.  
+3. Added friendly language to engage contributors and users.  
+4. Updated examples to be more illustrative and user-friendly.  

npdatetime-0.2.0.dev2.dist-info/RECORD

@@ -0,0 +1,11 @@
+npdatetime/__init__.py,sha256=jwHLOIQFp4WIL2KDAudEcVB-_5un2wjQJNPNu2nxYA4,38205
+npdatetime/__init__.pyi,sha256=JOPIVFiqz6eoxNpPGO9LETNLLf_YPJL5wnvmLN3eq9U,10106
+npdatetime/_custom_strptime.py,sha256=sO1CkAJV_4Ahgr0cqJjc4HncihVt0S0KzoKIblDYZMw,12014
+npdatetime/config.py,sha256=C-ozgMViZyhbIUtP1phZ-xshktPwdbsVssFUTYVP6Os,396
+npdatetime/utils.py,sha256=ZsoAe8mcsKk5aDLOIaUa-IpFBPhtQVi1M4Q2dV_cvs0,371
+npdatetime/data/calendar_bs.csv,sha256=G9KWbb35Ietcz31K2E4R5J2a5rhQl0QJjw1TA_V4M8s,5250
+npdatetime-0.2.0.dev2.dist-info/LICENSE,sha256=zVhPTICUPJU67BU1DoMb0SofU9Zo2uY1kV-jn2SqvfI,1082
+npdatetime-0.2.0.dev2.dist-info/METADATA,sha256=iOQZUVAcQLp9Lk0-txm1kGpjcRq33R8RZ7TidTYCxUY,9143
+npdatetime-0.2.0.dev2.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+npdatetime-0.2.0.dev2.dist-info/top_level.txt,sha256=2FR7RutVmSD6SL-iOwUcGrHd1XXgzaqUvAU78WGz_9g,11
+npdatetime-0.2.0.dev2.dist-info/RECORD,,

npdatetime-0.1.1.dist-info/METADATA

@@ -1,180 +0,0 @@
-Metadata-Version: 2.1
-Name: npdatetime
-Version: 0.1.1
-Summary: A Python package that provides advanced functionality for handling Nepali dates and times, including support for the Bikram Sambat calendar system and Nepal Time (NPT). Ideal for developers working with Nepali date-related applications, offering seamless conversion, manipulation, and formatting of dates and times in the Nepali calendar.
-Home-page: https://github.com/4mritGiri/npdatetime
-Author: Amrit Giri
-Author-email: Amrit Giri <amritgiri02595@gmail.com>
-License: The MIT License (MIT)
-        Copyright © 2020 AMRIT GIRI
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the “Software”), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in
-        all copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-        THE SOFTWARE.
-Project-URL: Homepage, https://github.com/4mritGiri/npdatetime#readme
-Project-URL: Issues, https://github.com/4mritGiri/npdatetime/issues
-Keywords: Nepali Date,Date Conversion,Datetime,Bikram Sambat,Bikram Samvat,nepali,B.S.,BS,bs,b.s,date,NpDateTime,datetime,time,timezone,nepal,bikram,sambat,samvat,nepali-date,nepali-datetime,nepal-time,npt,nepal-timezone,npdatetime,npdt
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.5
-Description-Content-Type: text/markdown
-License-File: LICENSE
-
-# **Nepali Datetime (Bikram Sambat Date & Nepal Time)**
-
-A Python library inspired by the core `datetime` module, designed for operations based on the **Bikram Sambat (B.S.)** calendar and **Nepal Time (NPT)** timezone (`UTC+05:45`).
-
-### **Key Features**
-- Supports Bikram Sambat (B.S.) date operations.
-- Handles Nepal Time (NPT) timezone.
-- Compatible with Python 3.5+.
-- Seamless integration with Python's native `datetime` functionalities.
-- Support for date formatting with Nepali Unicode.
-
----
-
-## **Installation**
-
-Install the package using `pip`:
-
-```bash
-pip install npdatetime
-```
-
----
-
-## **Basic Usage**
-
-Here's how you can use `npdatetime` alongside Python's `datetime`:
-
-### **Importing**
-```python
-import datetime
-import npdatetime
-```
-
-### **Getting Today's Date**
-```python
-# Gregorian date
-datetime.date.today()
-
-# Bikram Sambat date
-npdatetime.date.today()
-```
-
-### **Current Date and Time**
-```python
-# Gregorian datetime
-datetime.datetime.now()
-
-# Bikram Sambat datetime
-npdatetime.datetime.now()
-```
-
-### **Creating Date and Datetime Objects**
-```python
-# Gregorian date
-datetime.date(2020, 9, 4)
-
-# Bikram Sambat date
-npdatetime.date(2077, 5, 19)
-
-# Gregorian datetime
-datetime.datetime(2020, 9, 4, 8, 26, 10, 123456)
-
-# Bikram Sambat datetime
-npdatetime.datetime(2077, 5, 19, 8, 26, 10, 123456)
-```
-
-### **Date/Datetime Formatting**
-```python
-# Formatting Bikram Sambat date
-npdatetime.datetime(2077, 5, 19, 8, 26, 10, 123456).strftime("%d %B %Y")
-# Output: 19 Bhadau 2077
-
-# Formatting with Nepali Unicode
-npdatetime.date(1977, 10, 25).strftime('%K-%n-%D (%k %N %G)')
-# Output: १९७७-१०-२५ (७७ माघ आइतबार)
-```
-
-### **Parsing from String**
-```python
-npdatetime.datetime.strptime('2077-09-12', '%Y-%m-%d')
-# Output: npdatetime.datetime(2077, 9, 12, 0, 0)
-```
-
-### **Timedelta Operations**
-```python
-# Adding days to a date
-npdatetime.date(1990, 5, 10) + datetime.timedelta(days=350)
-# Output: npdatetime.date(1991, 4, 26)
-
-# Adding hours and minutes to a datetime
-npdatetime.datetime(1990, 5, 10, 5, 10, 20) + datetime.timedelta(hours=3, minutes=15)
-# Output: npdatetime.datetime(1990, 5, 10, 8, 25, 20)
-```
-
-### **Bikram Sambat <-> Gregorian Conversion**
-```python
-# Convert Bikram Sambat to Gregorian
-npdatetime.date(1999, 7, 25).to_datetime_date()
-# Output: datetime.date(1942, 11, 10)
-
-# Convert Gregorian to Bikram Sambat
-npdatetime.date.from_datetime_date(datetime.date(1942, 11, 10))
-# Output: npdatetime.date(1999, 7, 25)
-```
-
-### **Bikram Sambat Monthly Calendar**
-```python
-npdatetime.date(2078, 1, 1).calendar()
-
-# Output:
-          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
-```
-
----
-
-## **Documentation**
-
-Comprehensive usage and examples can be found in the [official documentation](https://4mritGiri.github.io/npdatetime/).
-
----
-
-## **Contribution**
-
-Contributions are highly encouraged!  
-Refer to the [CONTRIBUTING.md](https://github.com/4mritGiri/npdatetime/blob/master/CONTRIBUTING.md) guide for details on how to get started.
-
----
-
-## **License**
-
-This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.
-
----
-
-## **Feedback & Support**
-
-For feature requests, bugs, or feedback, please raise an issue on [GitHub](https://github.com/4mritGiri/npdatetime/issues).

npdatetime-0.1.1.dist-info/RECORD

@@ -1,10 +0,0 @@
-npdatetime/__init__.py,sha256=4-arrqG1kVK_MBCikeD2gDWpTWsLwm7CRRe2rKzBubg,37958
-npdatetime/__init__.pyi,sha256=JOPIVFiqz6eoxNpPGO9LETNLLf_YPJL5wnvmLN3eq9U,10106
-npdatetime/_custom_strptime.py,sha256=sO1CkAJV_4Ahgr0cqJjc4HncihVt0S0KzoKIblDYZMw,12014
-npdatetime/config.py,sha256=C-ozgMViZyhbIUtP1phZ-xshktPwdbsVssFUTYVP6Os,396
-npdatetime/data/calendar_bs.csv,sha256=G9KWbb35Ietcz31K2E4R5J2a5rhQl0QJjw1TA_V4M8s,5250
-npdatetime-0.1.1.dist-info/LICENSE,sha256=zVhPTICUPJU67BU1DoMb0SofU9Zo2uY1kV-jn2SqvfI,1082
-npdatetime-0.1.1.dist-info/METADATA,sha256=2fMu2a40xjDDX-uTMTDeNNlHFqJCBU9XrHs1HovupGo,5828
-npdatetime-0.1.1.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-npdatetime-0.1.1.dist-info/top_level.txt,sha256=2FR7RutVmSD6SL-iOwUcGrHd1XXgzaqUvAU78WGz_9g,11
-npdatetime-0.1.1.dist-info/RECORD,,