Ir para o conteúdo principal
Workday User Guide
Última atualização: 2023-06-23
WD.DATEDIF

WD.DATEDIF

Descrição

Retorna a quantidade de tempo entre duas datas com base no período especificado e na unidade correspondente a ele. Recomendamos usar WD.DATEDIF em vez de DATEDIF. Fornecemos a função DATEDIF para fins de compatibilidade, porém ela calcula resultados incorretos em algumas situações. Observe que o Worksheets não oferece suporte ao envio de valores em outros idiomas para os argumentos.

Sintaxe

WD.DATEDIF(
start_date
,
end_date
,
period
,
unit
)
  • start_date
    : a data de início da contagem. A Workday recomenda usar uma referência da célula para especificar a data, em vez de inserir a data como texto, garantindo resultados confiáveis.
  • end_date
    : a data de término da contagem. A Workday recomenda usar uma referência da célula para especificar a data, em vez de inserir a data como texto, garantindo resultados confiáveis.
  • period
    : número de períodos completos entre
    start_date
    e
    end_date
    . Se o período é um agrupamento de valores, como
    YMD
    , a função calcula todos os períodos completos como segmentos; você usa a
    unit
    argumento para especificar qual número (segmento) retornar. Exemplo: se o
    start_date
    é 1º de janeiro de 2010, e a data de
    end_date
    é 3 de fevereiro de 2020, a função calcula que Ano = 10, Mês = 1 e Dia = 2. Se unit=Month, a função retorna 1.
    • Year (Y)
    • Month (M)
    • Week (W)
    • Day (D)
    • Hour (H)
    • Minute (M)
    • Second (Sec ou S)
    • Milli (Mil ou MS)
    • YearMonthWeekDayTime (YMWDT): anos, meses, semanas, dias, horas, minutos, segundos e milissegundos.
    • YearMonthDayTime (YMDT): anos, meses, dias, horas, minutos, segundos e milissegundos
    • YearMonthDay (YMD): anos, meses e dias
    • YearWeekDayTime (YMDT): anos, semanas, dias, horas, minutos, segundos e milissegundos
    • YearWeekDay (YWD): anos, semanas e dias
    • YearDayTime (YDT): anos, dias, horas, minutos, segundos e milissegundos
    • YearDay (YD): anos e dias
    • DayTime (DT): dias, horas, minutos, segundos e milissegundos
    • Time (T): horas, minutos, segundos e milissegundos
  • unit
    : o número a ser retornado. Se a
    period
    é um valor único, como Dia, o
    unit
    deve corresponder a
    period
    . Se a
    period
    é um valor agrupado, como YMD, o
    unit
    deve corresponder a um dos segmentos no
    period
    .
    • Year (Y)
    • Month (M)
    • Week (W)
    • Day (D)
    • Hour (H)
    • Minute (Min)
    • Second (S ou Sec)
    • Milli (MS ou Mil)

Exemplo

Os exemplos são baseados nestes dados:
A
B
C
D
1
Data de início
Data de término
Período
Unidade
2
07/02/2018 05:17:33.636 PM
03/31/2020 12:00:00.000 AM
Year
Year
3
Month
Month
4
Week
Week
5
Day
Day
6
YMD
M
Aqui estão alguns exemplos de fórmulas e resultados:
Fórmula
Resultado
=WD.DATEDIF(A2,B2,C2,D2)
1
=WD.DATEDIF(A2,B2,C3,D3)
20
=WD.DATEDIF(A2,B2,C4,D4)
91
=WD.DATEDIF(A2,B2,C5,D5)
637
=WD.DATEDIF(A2,B2,C6,D6)
8
Em um exemplo mais complexo, você pode especificar vários valores de unit usando um intervalo de células para calcular o mesmo número de resultados.
Exemplo de WD.DATEDIF usando intervalo para o argumento Unit
Coloque a fórmula =WD.DATEDIF(A2,B2,C2,D2:F2) na célula D3 e envie-a como uma fórmula de matriz sem restrições usando Ctrl + Alt + Enter (Window) ou Option + Alt + Enter (Mac).