Método WorksheetFunction.WorkDay (Excel)
Retorna um número que representa uma data que é o número indicado de dias úteis antes ou após uma data (a data inicial). Os dias úteis excluem fins de semana e quaisquer datas identificadas como feriados. Use o WorkDay para excluir fins de semana ou feriados quando calcular as datas de vencimento da fatura, os tempos de entrega esperados ou o número de dias de trabalho executados.
Sintaxe
expressão. WorkDay (Arg1, Arg2, Arg3)
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 | Data_inicial - uma data que representa a data inicial. |
| Arg2 | Obrigatório | Variantes | Dias - o número de dias úteis antes ou depois de data_inicial. Um valor positivo para dias gera uma data futura; um valor negativo gera uma data passada. |
| Arg3 | Opcional | Variantes | Feriados - uma lista opcional com uma ou mais datas a serem excluídas do calendário de trabalho, como feriados estaduais, federais e flutuantes. A lista pode ser um intervalo de células que contém as datas ou uma constante de matriz dos números de série que representam as datas. |
Valor de retorno
Double
Comentários
Importante
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. Problemas podem ocorrer se as datas forem inseridas como texto .
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.
Se qualquer argumento não for uma data válida, o WorkDay retornará o #VALUE! valor de erro.
Se start_date dias mais renderem uma data inválida, o WorkDay retornará o #NUM! valor de erro.
Se dias não for um inteiro, será truncado.
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.