Função Weekday

Retorna uma Variante (Inteiro) que contém um número inteiro representando o dia da semana.

Sintaxe

Dia da semana ( Data [, primeiro_dia_semana ] )

A sintaxe da função dia da semana tem os seguintes argumentos:

Argumento

Descrição

data

Obrigatório. Variant, expressão numérica, expressão de cadeia de caracteres ou qualquer combinação desses que pode representar uma data. Se a Data contiver nulo, será retornado nulo .

primeirodiadasemana

Opcional. Um constante que especifica o primeiro dia da semana. Se não for especificado, o vbSunday será presumido.

Configurações

O argumento FirstDayOfWeek tem as seguintes configurações:

Constante

Valor

Descrição

vbUseSystem

0

Use a configuração da API NLS.

vbSunday

1

Domingo (padrão)

vbMonday

2

Segunda-feira

vbTuesday

3

Terça-feira

vbWednesday

4

Quarta-feira

vbThursday

5

Quinta-feira

vbFriday

6

Sexta-feira

vbSaturday

7

Sábado

Valores de retorno

A função de dia da semana pode retornar qualquer um dos seguintes valores:

Constante

Valor

Descrição

vbSunday

1

Domingo

vbMonday

2

Segunda-feira

vbTuesday

3

Terça-feira

vbWednesday

4

Quarta-feira

vbThursday

5

Quinta-feira

vbFriday

6

Sexta-feira

vbSaturday

7

Sábado

Comentários

Se a configuração da propriedade calendário for Gregoriano, o número inteiro retornado representará o dia gregoriano da semana para o argumento de data. Se o calendário for islâmico, o número inteiro retornado representará o dia islâmico da semana para o argumento de data. Para datas islâmicas, o número do argumento é qualquer expressão numérica que possa representar uma data e/ou hora de 1/1/100 (2 de agosto de 718,) a 4/3/9666 (gregoriano de 31 de dezembro de 9999).

Exemplos de consulta

Expressão

Resultados

Selecione DateofSale, dia da semana ([DateofSale]) como expr1 em ProductSales;

Retorna os valores do campo "DateofSale" e o número que representa o ' dia da semana ' desses valores de data. (Por padrão, domingo é considerado o primeiro dia da semana; 1).

Selecione DateofSale, dia da semana ([DateofSale], 2) como NewWeekDay do ProductSales;

Retorna os valores do campo "DateofSale" e o número que representa o ' dia da semana ' desses valores de data. (considerando segunda-feira, como o primeiro dia da semana).

Exemplo de VBA

Observação: Exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione referência do desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.

Este exemplo usa a função Weekday para obter o dia da semana de uma data especificada.

Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.

Observação:  Esta página foi traduzida automaticamente e pode apresentar erros gramaticais ou imprecisões. Nosso objetivo é que este conteúdo seja útil para você. Você pode nos dizer se as informações foram úteis? Use o artigo em inglês como referência.​

Consulte Também

Escolher a função de data certa

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×