# ========== nthBday ==========
**nthBday** is a an open-source python package to find business/working days of a month.
##### Please Note: The holidays taken here are Indian holidays. In the next versions our countries holidays will be added too.
## Installation
nthBday requires [Python 3](https://www.python.org/downloads/) and [pandas](https://pandas.pydata.org/) to execute.
To install using pip, use
`pip install nthBday`
[![Downloads](https://static.pepy.tech/personalized-badge/nthbday?period=month&units=abbreviation&left_color=black&right_color=blue&left_text=Downloads)](https://pepy.tech/project/nthbday)
## Features
### nthBday package contains different functions such as:
* **first_working_day**: Returns the first working day of a month
* **second_working_day**: Returns the second working day of a month
* **third_working_day**: Returns the third working day of a month
* **fourth_working_day**: Returns the fourth working day of a month
* **fifth_working_day**: Returns the fifth working day of a month
* **nth_working_day**: Returns the n-th working day of a month
* **last_working_day**: Returns the last working day of a month
* **nth_last_working_day**: Returns the n-th last working day of a month
* **last_sun**: Returns the last sunday of a month
* **last_sat**: Returns the last saturday of a month
* **last_fri**: Returns the last friday of a month
* **last_thu**: Returns the last thursday of a month
* **last_wed**: Returns the last wednesday of a month
* **last_tue**: Returns the last tuesday of a month
* **last_mon**: Returns the last monday of a month
* **second_sat**: Returns the second saturday of a month
* **fourth_sat**: Returns the fourth saturday of a month
## Usage
* **Import the library**:
``` python
import nthBday as nb
```
## Examples
``` python
import nthBday as nb
nb.first_working_day(2,2023)
```
returns,
``` Python
datetime.date(2023, 2, 1)
```
``` python
import nthBday as nb
nb.nth_working_day(2,2023,17)
```
returns,
``` Python
datetime.date(2023, 2, 23)
```
``` python
import nthBday as nb
nb.last_working_day(2,2023)
```
returns,
``` Python
datetime.date(2023, 2, 28)
```
``` python
import nthBday as nb
nb.nth_last_working_day(2,2023,17)
```
returns,
``` Python
datetime.date(2023, 2, 6)
```
``` python
import nthBday as nb
nb.last_thu(3,2023)
```
returns,
``` Python
datetime.date(2023, 3, 30)
```
``` python
import nthBday as nb
nb.second_sat(3,2023)
```
returns,
``` Python
datetime.date(2023, 3, 11)
```
## License
##### MIT
Raw data
{
"_id": null,
"home_page": "https://github.com/U77w41/nthBday",
"name": "nthBday",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "python,date,Business Day,Working Day,Holiday,calender",
"author": "Ujjwal Chowdhury",
"author_email": "<u77w41@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/c7/01/415a7604e147fdf8de721c013766577b61025e97a859a83af56650d01c09/nthBday-0.2.7.tar.gz",
"platform": null,
"description": "# ========== nthBday ==========\n\n\n**nthBday** is a an open-source python package to find business/working days of a month.\n\n##### Please Note: The holidays taken here are Indian holidays. In the next versions our countries holidays will be added too.\n\n## Installation\n\nnthBday requires [Python 3](https://www.python.org/downloads/) and [pandas](https://pandas.pydata.org/) to execute.\n\nTo install using pip, use\n\n`pip install nthBday`\n\n[![Downloads](https://static.pepy.tech/personalized-badge/nthbday?period=month&units=abbreviation&left_color=black&right_color=blue&left_text=Downloads)](https://pepy.tech/project/nthbday)\n\n## Features \n\n### nthBday package contains different functions such as:\n* **first_working_day**: Returns the first working day of a month\n* **second_working_day**: Returns the second working day of a month\n* **third_working_day**: Returns the third working day of a month\n* **fourth_working_day**: Returns the fourth working day of a month\n* **fifth_working_day**: Returns the fifth working day of a month\n* **nth_working_day**: Returns the n-th working day of a month\n* **last_working_day**: Returns the last working day of a month\n* **nth_last_working_day**: Returns the n-th last working day of a month\n* **last_sun**: Returns the last sunday of a month\n* **last_sat**: Returns the last saturday of a month\n* **last_fri**: Returns the last friday of a month\n* **last_thu**: Returns the last thursday of a month\n* **last_wed**: Returns the last wednesday of a month\n* **last_tue**: Returns the last tuesday of a month\n* **last_mon**: Returns the last monday of a month\n* **second_sat**: Returns the second saturday of a month\n* **fourth_sat**: Returns the fourth saturday of a month\n\n\n## Usage\n\n* **Import the library**:\n\n``` python\nimport nthBday as nb\n```\n\n## Examples\n\n\n``` python\nimport nthBday as nb\nnb.first_working_day(2,2023)\n```\n\nreturns,\n\n``` Python\ndatetime.date(2023, 2, 1)\n```\n\n\n``` python\nimport nthBday as nb\nnb.nth_working_day(2,2023,17)\n```\n\nreturns,\n\n``` Python\ndatetime.date(2023, 2, 23)\n```\n\n\n\n``` python\nimport nthBday as nb\nnb.last_working_day(2,2023)\n```\n\nreturns,\n\n``` Python\ndatetime.date(2023, 2, 28)\n```\n\n\n``` python\nimport nthBday as nb\nnb.nth_last_working_day(2,2023,17)\n```\n\nreturns,\n\n``` Python\ndatetime.date(2023, 2, 6)\n```\n\n\n\n``` python\nimport nthBday as nb\nnb.last_thu(3,2023)\n```\n\nreturns,\n\n``` Python\ndatetime.date(2023, 3, 30)\n```\n\n\n``` python\nimport nthBday as nb\nnb.second_sat(3,2023)\n```\n\nreturns,\n\n``` Python\ndatetime.date(2023, 3, 11)\n```\n\n\n\n\n\n\n\n\n## License\n\n##### MIT\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "An open-source python package to find business days of a month.",
"version": "0.2.7",
"split_keywords": [
"python",
"date",
"business day",
"working day",
"holiday",
"calender"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "04c8fd2d32d0ff883024aa16cbb938fa5cd3e0b10a37679edf2097e63a8799eb",
"md5": "9627d65709408caee105452d42cbe51a",
"sha256": "a0a749c9c1706a4057a768295ef84dceacc51762cfc71835ac65a8b60f7620fd"
},
"downloads": -1,
"filename": "nthBday-0.2.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9627d65709408caee105452d42cbe51a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 12583,
"upload_time": "2023-03-17T11:44:39",
"upload_time_iso_8601": "2023-03-17T11:44:39.096490Z",
"url": "https://files.pythonhosted.org/packages/04/c8/fd2d32d0ff883024aa16cbb938fa5cd3e0b10a37679edf2097e63a8799eb/nthBday-0.2.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c701415a7604e147fdf8de721c013766577b61025e97a859a83af56650d01c09",
"md5": "959c4bee61a1b84dfebe3707fd0f18d2",
"sha256": "294e1d15c0beb452fe392a31a331f4bb41d32d9f81b5d5c55572f96280c9979c"
},
"downloads": -1,
"filename": "nthBday-0.2.7.tar.gz",
"has_sig": false,
"md5_digest": "959c4bee61a1b84dfebe3707fd0f18d2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 13947,
"upload_time": "2023-03-17T11:44:41",
"upload_time_iso_8601": "2023-03-17T11:44:41.497574Z",
"url": "https://files.pythonhosted.org/packages/c7/01/415a7604e147fdf8de721c013766577b61025e97a859a83af56650d01c09/nthBday-0.2.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-17 11:44:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "U77w41",
"github_project": "nthBday",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "pandas",
"specs": []
},
{
"name": "datetime",
"specs": []
}
],
"lcname": "nthbday"
}