Share via


Função WeekdayName (Visual Basic)

Retorna um valor String contendo o nome do dia da semana especificado.

Public Function WeekdayName( _
   ByVal Weekday As Integer, _
   Optional ByVal Abbreviate As Boolean = False, _
   Optional ByVal FirstDayOfWeekValue As FirstDayOfWeek = FirstDayOfWeek.System _
) As String

Parâmetros

  • Weekday
    Obrigatório.Integer.A designação numérica para o dia da semana de 1 a 7; 1 indica o primeiro dia da semana e 7 indica o último dia da semana.As identidades do primeiro e último dias dependem da definição de FirstDayOfWeekValue.

  • Abbreviate
    Opcional.Boolean valor que indica se o nome do dia da semana deve ser abreviado. Se omitido, o padrão é False, o que significa que o nome do dia da semana não é abreviado.

  • FirstDayOfWeekValue
    Opcional.Um valor escolhido da enumeração FirstDayOfWeek que especifica o primeiro dia da semana.Se não especificado, FirstDayOfWeek.System é usado.

Configurações

O argumento FirstDayOfWeekValue pode ter uma das seguintes configurações.

Valor de enumeração

Valor

Descrição

FirstDayOfWeek.System

0

Primeiro dia da semana especificado nas configurações do sistema (padrão)

FirstDayOfWeek.Sunday

1

Domingo

FirstDayOfWeek.Monday

2

Segunda-feira (compatível com padrão 8601, Seção 3.17 ISO)

FirstDayOfWeek.Tuesday

3

Terça-feira

FirstDayOfWeek.Wednesday

4

Quarta-feira

FirstDayOfWeek.Thursday

5

Quinta-feira

FirstDayOfWeek.Friday

6

Sexta-feira

FirstDayOfWeek.Saturday

7

Sábado

Exceções

Tipo de exceção

Número de erro

Condição

ArgumentException

5

Weekday é menor que 1 ou maior que 7, FirstDayOfWeekValue é menor que 0 ou maior que 7.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

A cadeia de caracteres retornada por WeekdayName depende não somente dos argumentos de entrada, mas também das configurações Opções Regionais especificadas no Painel de Controle do Windows.

Observação:

WeekdayName utiliza a configuração atual de calendário da propriedade CurrentCulture da classe CultureInfo no namespace System.Globalization.Os valores CurrentCulture padrão são determinados por configurações do Painel de Controle.

Exemplo

O exemplo a seguir usa a função Weekday para obter o dia da semana de uma data especificada, e em seguida a função WeekDayName para obter o nome do dia da semana a partir do seu número.

Dim oldDate As Date
Dim oldWeekDayName As String
oldDate = #2/12/1969#
oldWeekDayName = WeekdayName(Weekday(oldDate))
' oldWeekDayName now contains "Wednesday".

Requisitos

Namespace:Microsoft.VisualBasic

**Módulo:**DateAndTime

**Assembly:**Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Referência

Função Day (Visual Basic)

Função Mês (Visual Basic)

Propriedade agora

Função dia da semana (Visual Basic) 

Função MonthName (Visual Basic)

Função de ano (Visual Basic)

Função DatePart (Visual Basic)

DateTime