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 |
|---|---|---|
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.
.gif "Observação") 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 dia da semana (Visual Basic)
Função MonthName (Visual Basic)