Module: @nginstack/engine/lib/date/dateCompare


(require("@nginstack/engine/lib/date/dateCompare"))(referenceDate, compareDate [, timeSensitive])

Compara duas datas e retorna 0 se forem iguais, um número negativo se a primeira for menor que a segunda e um positivo no caso contrário.

Por padrão, serão considerados apenas ano, mês e dia na comparação, mas esse comportamento pode ser alterado informando true no parâmetro timeSensitive, aumentando a precisão para milissegundos. Para fins de comparação, valores nulos são considerados inferiores que qualquer data válida.

Esta função também é publicada como ngin.date.compare() no escopo global e é uma alternativa compatível com runtime V8 ao método Date.prototype.compare(), implementado apenas no runtime Ije.

Parameters:
Name Type Argument Description
referenceDate Date

Data que será comparada.

compareDate Date

Data contra a qual referenceDate será comparada.

timeSensitive boolean <optional>

Determina se a parte de tempo (horas, minutos, segundos e milissegundos) será considerada na comparação. Por padrão será false.

Returns:

Será retornado um número negativo se referenceDate for menor que compareDate, positivo se for maior e zero se forem iguais.

Type
number