DateAndTime.WeekdayName(Int32, Boolean, FirstDayOfWeek) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna um valor de cadeia de caracteres que contém o nome do dia da semana especificado.
public static string WeekdayName (int Weekday, bool Abbreviate = false, Microsoft.VisualBasic.FirstDayOfWeek FirstDayOfWeekValue = Microsoft.VisualBasic.FirstDayOfWeek.System);
static member WeekdayName : int * bool * Microsoft.VisualBasic.FirstDayOfWeek -> string
Public Function WeekdayName (Weekday As Integer, Optional Abbreviate As Boolean = false, Optional FirstDayOfWeekValue As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.System) As String
Parâmetros
- Weekday
- Int32
Obrigatórios. Inteiro. 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 do último dia dependem da configuração de FirstDayOfWeekValue
.
- Abbreviate
- Boolean
Opcional. O valor Boolean
que indicará se o nome do dia da semana deverá ser abreviado. Se for omitido, o padrão será False
, que significa que o nome do dia da semana não é abreviado.
- FirstDayOfWeekValue
- FirstDayOfWeek
Opcional. Um valor escolhido na enumeração de FirstDayOfWeek que especifica o primeiro dia da semana. Se não for especificado, é usado FirstDayOfWeek.System
.
Retornos
Um valor de cadeia de caracteres que contém o nome do dia da semana especificado.
Exceções
Weekday
é menor que 1 ou maior que 7 ou FirstDayOfWeekValue
é menor que 0 ou maior que 7.
Exemplos
O exemplo a seguir usa a Weekday
função para obter o dia da semana de uma data especificada e, em seguida, a WeekDayName
função para obter o nome do dia da semana de seu número.
Dim oldDate As Date
Dim oldWeekDayName As String
oldDate = #2/12/1969#
oldWeekDayName = WeekdayName(Weekday(oldDate))
' oldWeekDayName now contains "Wednesday".
Comentários
A cadeia de caracteres retornada por WeekdayName
depende não apenas dos argumentos de entrada, mas também das configurações de Opções Regionais especificadas no Painel de Controle do Windows.
Observação
WeekdayName
usa a configuração de calendário atual da CurrentCulture propriedade da CultureInfo classe no System.Globalization namespace . Os valores padrão CurrentCulture são determinados por Painel de Controle configurações.
O FirstDayOfWeekValue
argumento pode ter uma das configurações a seguir.
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 | Sunday |
FirstDayOfWeek.Monday |
2 | Segunda-feira (em conformidade com o padrão ISO 8601, seção 3.17) |
FirstDayOfWeek.Tuesday |
3 | Terça-feira |
FirstDayOfWeek.Wednesday |
4 | Quarta-feira |
FirstDayOfWeek.Thursday |
5 | Quinta-feira |
FirstDayOfWeek.Friday |
6 | Friday |
FirstDayOfWeek.Saturday |
7 | Sábado |