Método WorksheetFunction.YearFrac (Excel)

  • Artigo

Calcula a fração de ano que representa o número de dias inteiros entre duas datas (data_inicial e data_final). Use a função de planilha YearFrac para identificar a proporção de benefícios ou obrigações de um ano inteiro para atribuir a um termo específico.

Sintaxe

expressão. YearFrac (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 Data_final - a data que representa a data final.
Arg3 Opcional Variantes Base - o tipo de base de contagem diária a ser usado.

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. Poderão ocorrer problemas se as datas forem inseridas como texto.

A tabela a seguir representa valores possíveis para o Arg3.

Base Base de contagem diária
0 ou omitido USA (NASD) 30/360
1 Real/real
2 Real/360
3 Real/365
4 Europeu 30/360

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.

Todos os argumentos são truncados para inteiros.

Se start_date ou end_date não forem datas válidas, YearFrac retornará o #VALUE! valor de erro.

Se base < 0 ou se base > 4, YearFrac retornará o #NUM! valor de erro.

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.