Microsoft Office Online
Iniciar sessão no Meu Office Online (O que é isto?) | Iniciar sessão

 
 
Microsoft Office Access
Procurar
Procurar
 
Experimentar ou comprar
Experimentar o Office 2007
Assistência do Office
Verificar existência de actualizações: (c) Microsoft
Transferências do Office
 
 
 
Ajuda e Procedimentos
Escolha a sua versão
Formação
Modelos
Suporte e Comentários
Recursos Técnicos
Recursos Adicionais
Aviso: está a visualizar esta página com um browser não suportado. Este Web site funciona melhor com o Microsoft Internet Explorer 6.0 ou posterior, o Firefox 1.5 ou o Netscape Navigator 8.0 ou posterior. Mais informações sobre browsers suportados.
Versão Optimizada para ImpressãoVersão Optimizada para Impressão
Função DiaSemana
 

Devolve uma Variante (Número Inteiro) que contém um número inteiro que representa o dia da semana.

Sintaxe

DiaSemana(data [, primeirodiadasemana ] )

A sintaxe da função DiaSemana tem os seguintes argumentos (argumento: valor que fornece informações a uma acção, evento, método, propriedade, função ou procedimento.):

Argumento Descrição
data Obrigatório. Variante (tipo de dados Variante: tipo de dados predefinido para variáveis que não possuem caracteres de declaração de tipo quando uma instrução do tipo Def não está em vigor. Uma Variante pode armazenar dados numéricos, de cadeia, de data/hora, Nulo ou Vazio.), expressão numérica (expressão numérica: qualquer expressão que possa gerar um número. A expressão pode ser qualquer combinação de variáveis, constantes, funções e operadores.), expressão de cadeia (expressão de cadeia: expressão que equivale a uma sequência de caracteres contíguos. Os elementos da expressão podem ser: funções que devolvem uma cadeia ou uma Variante de cadeia (VarType 8); uma cadeia literal, uma constante, uma variável ou Variante.) ou qualquer combinação destas que possa representar uma data. Se a data contiver um valor Nulo (Null: valor que pode introduzir num campo ou utilizar em expressões ou consultas para indicar dados em falta ou desconhecidos. No Visual Basic, a palavra-chave Null indica um valor nulo (Null). Alguns campos, tais como campos de chave primária, não podem conter um valor Null.), é devolvido um valor Nulo.
primeirodiadasemana Opcional. Uma constante (constante: valor que não é calculado e que, por isso, não é alterado. Por exemplo, o número 210 e o texto "Rendimento trimestral" são constantes. Uma expressão ou um valor que resulte de uma expressão não é uma constante.) que especifica o primeiro dia da semana. Se não for especificada, é assumido vbSunday.

Definições

O argumento primeirodiadasemana tem as seguintes definições:

Constante Valor Descrição
vbUseSystem 0 Utilizar a definição NLS de API.
vbSunday 1 Domingo (predefinido)
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 Devolvidos

A função DiaSemana pode devolver 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

Observações

Se a definição da propriedade Calendário for Gregoriano, o número inteiro devolvido representa o dia da semana Gregoriano para o argumento data. Se o calendário for Hijri, o número inteiro devolvido representa o dia da semana Hijri para o argumento data. Em datas Hijri, o número do argumento é qualquer expressão numérica que represente uma data e/ou hora de 1/1/100 (2 de Ago de 718, Gregoriano) a 3/4/9666 (31 de Dez de 9999, Gregoriano).

Exemplo

 Nota   Os exemplos que se seguem demonstram a utilização desta função num módulo do Visual Basic for Applications (VBA). Para mais informações sobre como trabalhar com VBA, seleccione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de procura.

Este exemplo utiliza a função DiaSemana para obter o dia da semana a partir de uma data especificada.

Dim MinhaData, MeuDiaSemana
MinhaData = #12 de Fevereiro, 1969#    ' Atribuir uma data.
MeuDiaSemana = DiaSemana(MinhaData)    
' MeuDiaSemana contém 4 porque 
' MinhaData representa uma Quarta-feira.
Consulte também
anúncio
Versão Optimizada para ImpressãoVersão Optimizada para Impressão