dateshift

Move valores datetime para o início ou o fim de uma unidade de tempo.

Categoria: Language Fundamentals > Data Types

Sintaxe

t2 = dateshift(t, 'start', unit)

t2 = dateshift(t, 'end', unit)

Descrição

dateshift(t,'start','month') dá a meia-noite do primeiro dia do mês. O fim de uma unidade é o último instante antes de a seguinte começar, e é exibido como a última data da unidade. A semana começa no domingo.

É a forma usual de agrupar datas por mês ou ano, por exemplo antes de um groupsummary.

Argumentos de entrada

t

Array datetime.

unit

'year', 'month', 'week' ou 'day'.

Argumentos de saída

t2

Array datetime com o tamanho de t.

Exemplo

Limites de mês e ano

t = datetime(2020,5,17,13,30,0);
dateshift(t, 'start', 'month')
dateshift(t, 'end', 'month')
dateshift(t, 'start', 'year')

ans = datetime
   01-May-2020
ans = datetime
   31-May-2020
ans = datetime
   01-Jan-2020

Observações

A forma 'dayofweek' (ir para a próxima segunda-feira, por exemplo) pode devolver a data de entrada sem alteração no MatLivre.

Veja também

datetime month calmonths eomday groupsummary