weekday

Dia da semana de uma data, como número de 1 (domingo) a 7 (sábado).

Categoria: Language Fundamentals > Data Types

Sintaxe

n = weekday(t)

[n, name] = weekday(t, format)

Descrição

A numeração começa no domingo, então segunda-feira é 2 e sábado é 7. O cálculo depende apenas da data do calendário, não da hora do dia.

O resultado é um array double simples, útil para indexar uma tabela de rótulos ou para testar fins de semana com ismember(n, [1 7]).

Argumentos de entrada

t

Datas como array datetime, números seriais de data ou texto de data.

format

Opcional: 'long' (por exemplo Friday) ou 'short' (Fri) para a saída com o nome.

Argumentos de saída

n

Array do mesmo tamanho de t com inteiros de 1 a 7.

name

Nomes dos dias, um por data, quando duas saídas são pedidas.

Exemplo

Três dias seguidos

t = datetime(2024, 3, 15) + days(0:2);
weekday(t)

ans = 1×3

     6     7     1

Veja também

datetime day datenum calendarDuration weeknum