Método WorksheetFunction.WeekNum (Excel)
Retorna o número que indica onde se encontra a semana, numericamente, em um ano.
Sintaxe
expressão. WeekNum (Arg1, Arg2)
Expressão Uma variável que representa um objeto WorksheetFunction .
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| Arg1 | Obrigatório | Variantes | Núm_série - uma data na semana. As datas devem ser inseridas com a função DATA ou como resultado de outras fórmulas ou funções. Por exemplo, use DATA(2008;5;23) para 23 de maio de 2008. Poderão ocorrer problemas se as datas forem inseridas como texto. |
| Arg2 | Opcional | Variantes | Tipo_retorno - um número que determina em que dia a semana começa. O padrão é 1. |
Valor de retorno
Double
Comentários
Importante
A função WeekNum considera a semana que contém 1º de janeiro como a primeira semana do ano. No entanto, existe um padrão europeu que define a primeira semana como aquela que tem o maior número de dias (quatro ou mais) no novo ano. Isso significa que, durante anos em que há três dias ou menos na primeira semana de janeiro, a função WeekNum retorna números de semana incorretos de acordo com o padrão europeu.
A tabela a seguir representa valores possíveis para o Arg2.
| Return_type | Começa a semana |
|---|---|
| 1 | A semana começa no domingo. Os dias da semana são numerados de 1 a 7. |
| 2 | A semana começa na segunda-feira. Os dias da semana são numerados de 1 a 7. |
O Microsoft Excel armazena datas como números de série sequenciais para que eles possam ser usados em cálculos. Por padrão, 1 de janeiro de 1900 é o número de série 1, e 1 de janeiro de 2008 é o número de série 39448, porque vem 39.448 dias depois de 1 de janeiro de 1900. O Microsoft Excel para o Macintosh usa um sistema de data diferente como padrão.
Observação
O Visual Basic for Applications (VBA) calcula datas de série diferentemente do Excel. No VBA, o número de série 1 é 31 de dezembro de 1899, em vez de 1 de janeiro de 1900.
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.