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.