Ações de Data
Ações de data são ações para interagir com data no Marvin.
Máscara de data
Para interagir com as datas deve-se definir uma mask.
%Y: Ano com quatro dígitos, ex: 2020.
%m: Mês com dois dígitos, ex: 01.
%d: Dia com dois dígitos, ex: 05.
Considerando o dia 2020-05-30, usando a máscara podemos obter as seguintes saídas:
%Y/%m/%d: 30/05/2020
%d-%m-%Y: 30-05-2020
%Y%m: 202005
Ações
date.convert_date_format
Converta o formato de data para outro formato conforme desejado.
Parâmetros:
date_str - data como texto no formato atual. Esta é a entrada para a conversão.
input_mask (opcional) - mask da data do texto de entrada (padrão=%Y-%m-%d).
output_mask (opcional) - mask da data do texto de saída (padrão=%Y-%m-%d).
Retornar:
date - data de texto com a máscara fornecida
date.delta_business_days
Retornar uma data considerando quantos dias úteis antes ou depois. Se precisar de dias passados, use números negativos, se precisar de dias futuros, use números positivos.
Parâmetros:
date (opcional) - data base para calcular o delta de dias úteis (padrão=hoje).
days (opcional) - quantos dias úteis devem ser somados ou subtraídos da data base. Números positivos darão dias úteis futuros e números negativos passados dias úteis.
mask (opcional) - mask da data do texto de saída (padrão=%Y-%m-%d).
Retornar:
date - data de texto com a máscara fornecida
date.delta_days
Retorna um novo data de texto considerando o intervalo desejado.
Parâmetros:
date (opcional) - data base para calcular o delta de dias úteis (padrão=hoje).
years (opcional) - quantos anos devem ser somados ou subtraídos da data base. Números positivos fornecerão datas futuras e números negativos datas passadas (padrão = 0).
months (opcional) - quantos meses devem ser somados ou subtraídos da data base. Números positivos fornecerão datas futuras e números negativos datas passadas (padrão = 0).
days (opcional) - quantos dias devem ser adicionados ou subtraídos da data base. Números positivos fornecerão datas futuras e números negativos datas passadas (padrão = 0).
mask (opcional) - mask da data do texto de saída (padrão=%Y-%m-%d).
Retornar:
date - data de texto com a máscara fornecida
date.first_day_of_month
Retorna o primeiro dia do mês para o mês e ano especificados. Se nenhum mês e ano foram fornecidos, ele usará hoje como ano/mês padrão.
Importante:
anoemêsdevem ser informados para serem considerados como uma entrada válida. Se um desses parâmetros não estiver definido, hoje será usado como padrão ano/mês.
Parâmetros:
years (opcional) - número do ano para retornar no primeiro dia
months (opcional) - número do mês para retornar o primeiro dia
mask (opcional) - mask da data do texto de saída (padrão=%Y-%m-%d).
Retornar:
date - data de texto com a máscara fornecida
date.last_day_of_month
Retorna o último dia do mês para o mês e ano especificados. Se nenhum mês e ano foram fornecidos, ele usará hoje como ano/mês padrão.
Importante:
anoemêsdevem ser informados para serem considerados como uma entrada válida. Se um desses parâmetros não estiver definido, hoje será usado como padrão ano/mês.
Parâmetros:
years (opcional) - número do ano para retornar no primeiro dia
months (opcional) - número do mês para retornar o primeiro dia
mask (opcional) - mask da data do texto de saída (padrão=%Y-%m-%d).
Retornar:
date - data de texto com a máscara fornecida
date.today
Retornar uma nova data de texto como hoje
Parâmetros:
mask (opcional) - mask da data do texto de saída (padrão=%Y-%m-%d).
Retornar:
date - data de texto com a data de hoje na máscara fornecida