# dias_uteis
Biblioteca feita para facilitar o uso e cálculos de dias úteis no calendário brasileiro.
- Sem dependências externas.
- Testado em todas versões do Python a partir da versão 3.6.
- Fácil uso, API simples.
- Extremamente leve.
# Instalação
```
pip install dias_uteis
```
# Uso
```python
import datetime
import dias_uteis as dus
```
```
>>> dus.last_du()
datetime.date(2023, 11, 7)
>>> dus.next_du()
datetime.date(2023, 11, 9)
>>> date = datetime.date(2023, 11, 8)
>>> dus.is_du(date)
True
>>> corpus_christi_2020 = datetime.date(2020, 6, 11) # Corpus Christi 2020
>>> dus.is_holiday(corpus_christi_2020)
True
>>> dus.delta_du(date, 5) # Soma 5 dias úteis
datetime.date(2023, 11, 16)
>>> dus.delta_du(date, -2) # Subtrai 2 dias úteis
datetime.date(2023, 11, 6)
>>> a = datetime.date(2023,11,6)
>>> b = datetime.date(2023,11,16)
>>> dus.diff_du(a, b)
7
>>> start = datetime.date(2023, 10, 20)
>>> end = datetime.date(2023, 11, 7)
>>> dus.du_range(start, end)
[datetime.date(2023, 10, 20), datetime.date(2023, 10, 23), datetime.date(2023, 10, 24),
datetime.date(2023, 10, 25), datetime.date(2023, 10, 26), datetime.date(2023, 10, 27),
datetime.date(2023, 10, 30), datetime.date(2023, 10, 31), datetime.date(2023, 11, 1),
datetime.date(2023, 11, 3), datetime.date(2023, 11, 6)]
>>> dus.year_holidays(2023) # Lista todos feriados de 2023
[datetime.date(2023, 1, 1), datetime.date(2023, 2, 20), datetime.date(2023, 2, 21),
datetime.date(2023, 4, 7), datetime.date(2023, 4, 21), datetime.date(2023, 5, 1),
datetime.date(2023, 6, 8), datetime.date(2023, 9, 7), datetime.date(2023, 10, 12),
datetime.date(2023, 11, 2), datetime.date(2023, 11, 15), datetime.date(2023, 12, 25)]
```
Raw data
{
"_id": null,
"home_page": "https://github.com/renanmoretto/dias_uteis",
"name": "dias-uteis",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.6",
"maintainer_email": null,
"keywords": null,
"author": "renanmoretto",
"author_email": "himynameisrenan@outlook.com",
"download_url": "https://files.pythonhosted.org/packages/d0/a1/58fb1ea5bb09bb0b7a7432f2fe8f2f9072c0beb5ec31b0dc7c2973a6afab/dias_uteis-0.1.10.tar.gz",
"platform": null,
"description": "# dias_uteis\nBiblioteca feita para facilitar o uso e c\u00e1lculos de dias \u00fateis no calend\u00e1rio brasileiro.\n\n- Sem depend\u00eancias externas.\n- Testado em todas vers\u00f5es do Python a partir da vers\u00e3o 3.6.\n- F\u00e1cil uso, API simples.\n- Extremamente leve.\n\n# Instala\u00e7\u00e3o\n```\npip install dias_uteis\n```\n\n# Uso\n```python\nimport datetime\nimport dias_uteis as dus\n```\n```\n>>> dus.last_du()\ndatetime.date(2023, 11, 7)\n\n>>> dus.next_du() \ndatetime.date(2023, 11, 9)\n\n>>> date = datetime.date(2023, 11, 8)\n>>> dus.is_du(date)\nTrue\n\n>>> corpus_christi_2020 = datetime.date(2020, 6, 11) # Corpus Christi 2020\n>>> dus.is_holiday(corpus_christi_2020)\nTrue\n\n>>> dus.delta_du(date, 5) # Soma 5 dias \u00fateis\ndatetime.date(2023, 11, 16)\n\n>>> dus.delta_du(date, -2) # Subtrai 2 dias \u00fateis\ndatetime.date(2023, 11, 6)\n\n>>> a = datetime.date(2023,11,6)\n>>> b = datetime.date(2023,11,16)\n>>> dus.diff_du(a, b)\n7\n\n>>> start = datetime.date(2023, 10, 20) \n>>> end = datetime.date(2023, 11, 7) \n>>> dus.du_range(start, end)\n[datetime.date(2023, 10, 20), datetime.date(2023, 10, 23), datetime.date(2023, 10, 24),\ndatetime.date(2023, 10, 25), datetime.date(2023, 10, 26), datetime.date(2023, 10, 27),\ndatetime.date(2023, 10, 30), datetime.date(2023, 10, 31), datetime.date(2023, 11, 1), \ndatetime.date(2023, 11, 3), datetime.date(2023, 11, 6)]\n\n>>> dus.year_holidays(2023) # Lista todos feriados de 2023\n[datetime.date(2023, 1, 1), datetime.date(2023, 2, 20), datetime.date(2023, 2, 21), \ndatetime.date(2023, 4, 7), datetime.date(2023, 4, 21), datetime.date(2023, 5, 1), \ndatetime.date(2023, 6, 8), datetime.date(2023, 9, 7), datetime.date(2023, 10, 12), \ndatetime.date(2023, 11, 2), datetime.date(2023, 11, 15), datetime.date(2023, 12, 25)]\n```",
"bugtrack_url": null,
"license": null,
"summary": "Ferramentas para c\u00e1lculos de dias \u00fateis no calend\u00e1rio brasileiro.",
"version": "0.1.10",
"project_urls": {
"Homepage": "https://github.com/renanmoretto/dias_uteis",
"Repository": "https://github.com/renanmoretto/dias_uteis"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4c4d39f3e7d565354a6dddb7a1411d965418acd07a8a430974c504f9fe5970cb",
"md5": "9073bda97365da3fba1ace22a15d5a9b",
"sha256": "b9f26c310ebfe84309f923bea3eda41b1168f7d79dc3a7572d5a6c8c4bf0711e"
},
"downloads": -1,
"filename": "dias_uteis-0.1.10-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9073bda97365da3fba1ace22a15d5a9b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.6",
"size": 7128,
"upload_time": "2024-05-30T16:21:29",
"upload_time_iso_8601": "2024-05-30T16:21:29.438420Z",
"url": "https://files.pythonhosted.org/packages/4c/4d/39f3e7d565354a6dddb7a1411d965418acd07a8a430974c504f9fe5970cb/dias_uteis-0.1.10-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d0a158fb1ea5bb09bb0b7a7432f2fe8f2f9072c0beb5ec31b0dc7c2973a6afab",
"md5": "c6a561c902aec2db2b9e089b1fe2feab",
"sha256": "592ea60cf734df6fe792c2d07471355865bc19d98f757eee899cfb2f4a4b46cd"
},
"downloads": -1,
"filename": "dias_uteis-0.1.10.tar.gz",
"has_sig": false,
"md5_digest": "c6a561c902aec2db2b9e089b1fe2feab",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.6",
"size": 6458,
"upload_time": "2024-05-30T16:21:30",
"upload_time_iso_8601": "2024-05-30T16:21:30.899570Z",
"url": "https://files.pythonhosted.org/packages/d0/a1/58fb1ea5bb09bb0b7a7432f2fe8f2f9072c0beb5ec31b0dc7c2973a6afab/dias_uteis-0.1.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-30 16:21:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "renanmoretto",
"github_project": "dias_uteis",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "dias-uteis"
}
JSON
