Compartilhar via


WorksheetFunction.WorkDay method (Excel) (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. Utilize o WorkDay para excluir fins de semana ou feriados quando calcula as datas para conclusão da fatura, os tempos de entrega esperados ou o número de dias de trabalho realizados.

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 Variant Data_inicial - uma data que representa a data inicial.
Arg2 Obrigatório Variant 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 Variant 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. Podem ocorrer problemas se as datas forem introduzidas 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 um argumento não for uma data válida, o WorkDay devolve o #VALUE! valor de erro.

Se start_date mais dias resultar numa data inválida, o WorkDay devolve 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.