DateAndTime.WeekdayName(Int32, Boolean, FirstDayOfWeek) Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Devolve um valor de cadeia contendo o nome do dia útil 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

Required. Inteiro. A designação numérica para o dia útil, das 1 às 7; 1 indica o primeiro dia da semana e 7 indica o último dia da semana. As identidades dos primeiros e últimos dias dependem do contexto de FirstDayOfWeekValue.

Abbreviate
Boolean

Optional. Boolean valor que indica se o nome do dia útil deve ser abreviado. Se for omitido, o padrão é False, o que significa que o nome do dia útil não é abreviado.

FirstDayOfWeekValue
FirstDayOfWeek

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

Devoluções

String

Um valor de cadeia contendo o nome do dia útil especificado.

Exceções

ArgumentException

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

Exemplos

O exemplo seguinte utiliza a Weekday função para obter o dia da semana a partir de uma data especificada, e depois a WeekDayName função 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".

Observações

A cadeia devolvida por WeekdayName depende não só dos argumentos de entrada, mas também das definições Regional Options especificadas no Windows Painel de Controlo.

Note

WeekdayName usa a definição atual do calendário da CurrentCulture propriedade da CultureInfo classe no System.Globalization namespace. Os valores predefinidos de CurrentCulture são determinados pelas definições Painel de Controlo.

O FirstDayOfWeekValue argumento pode ter um dos seguintes contextos.

Valor de enumeração Value Descrição
FirstDayOfWeek.System 0 Primeiro dia da semana especificado nas definições do sistema (por defeito)
FirstDayOfWeek.Sunday 1 Domingo
FirstDayOfWeek.Monday 2 Segunda-feira (cumpre a norma ISO 8601, secção 3.17)
FirstDayOfWeek.Tuesday 3 Tuesday
FirstDayOfWeek.Wednesday 4 Quarta-feira
FirstDayOfWeek.Thursday 5 Quinta-feira
FirstDayOfWeek.Friday 6 Sexta-feira
FirstDayOfWeek.Saturday 7 Sábado

Aplica-se a

Ver também