Campus Livre
addtodate
Soma um número de unidades de calendário, como meses ou dias, a um número de data.
Categoria: Language Fundamentals > Data Types
Sintaxe
d2 = addtodate(d, q, f)Soma q unidades do tipo f à data serial d.
Descrição
Anos e meses são unidades de calendário de duração desigual, então somá-los não equivale a somar um número fixo de dias. Se o dia resultante não existe, ele passa para o último dia do mês: um mês depois de 31 de janeiro é 29 de fevereiro em 2024. As unidades de 'week' para baixo são múltiplos simples de um dia.
Argumentos de entrada
d- Número de data serial, como o de
datenum. q- Quantidade a somar; pode ser negativa.
f- Unidade:
'year','month','week','day','hour','minute','second'ou'millisecond'.
Argumentos de saída
d2- Número de data serial após a soma.
Exemplo
Ajuste no fim do mês
d = datenum(2024, 1, 31);
disp(datestr(addtodate(d, 1, 'month'), 'yyyy-mm-dd'))
disp(datestr(addtodate(d, 1, 'year'), 'yyyy-mm-dd'))
disp(addtodate(d, 1, 'week') - d)Saída
2024-02-29
2025-01-31
7