Skip to main content

O pacote CalendarioFinanceiro é uma ferramenta Python projetada para facilitar a manipulação de datas financeiras em diferentes calendários, como 'onshore' (Brasil) e 'offshore'. Com este pacote, você pode realizar operações como adicionar dias úteis a uma data, criar listas de dias úteis entre intervalos de datas e muito mais. Ele é uma solução eficiente para lidar com cálculos de datas em cenários financeiros, onde a consideração de dias úteis e feriados é essencial.

Project description

CalendarioFinanceiro

O pacote CalendarioFinanceiro fornece funcionalidades para trabalhar com dias úteis, considerando diferentes calendários, como "onshore" (Brasil) e "offshore".

Instalação

Para utilizar o pacote CalendarioFinanceiro, você precisa instalá-lo primeiro. Isso pode ser feito utilizando o gerenciador de pacotes pip. Execute o seguinte comando no terminal:

pip install calendariofinanceiro

Uso Básico

from datetime import date
from calendariofinanceiro import CalendarioFinanceiro

# Inicializa o calendário de feriados "onshore"
c_on = CalendarioFinanceiro("onshore")

# Inicializa o calendário de feriados "offshore"
c_off = CalendarioFinanceiro("offshore")

# Calcula a data após adicionar um número de dias úteis
nova_data = c_on.soma_dias_uteis(date(2023, 8, 1), 5)

# Arredonda uma data para o próximo dia útil
data_arredondada = c_off.arredonda_dia_util(date(2023, 8, 10))

# Monta uma lista de dias úteis entre duas datas
lista_dias_uteis = c_on.monta_lista_dias_uteis(date(2023, 8, 1), date(2023, 8, 15))

# Monta uma lista de datas de fechamento retroativas
lista_fechamentos = c_off.monta_lista_fechamentos_anteriores(date(2023, 8, 31), 3)

# Obtém a data de fechamento do mês anterior
fechamento_mes_anterior = c_on.fechamento_mes_anterior(date(2023, 8, 15))

Métodos Disponíveis

soma_dias_uteis(data_dt: date, dias: int) -> date

Soma um número específico de dias úteis a uma data de referência.

arredonda_dia_util(data_dt: date, arredonda_pra_cima: bool = True) -> date

Arredonda uma data para o próximo ou último dia útil, dependendo da opção escolhida.

monta_lista_dias_uteis(data_inicial: date, data_final: date, incluir_primeira: bool = True) -> List[date]

Monta uma lista de dias úteis entre as datas de referência, com a opção de incluir ou não a primeira data.

monta_lista_fechamentos_anteriores(data_final: date, numero_meses: int) -> List[date]

Monta uma lista de datas de fechamento para um número especificado de meses retroativos a partir da data final.

fechamento_mes_anterior(data: date) -> date

Retorna a data de fechamento do mês anterior à data fornecida.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

calendariofinanceiro-0.2.0.tar.gz (8.8 kB view hashes)

Uploaded Source

Built Distribution

calendariofinanceiro-0.2.0-py3-none-any.whl (9.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page