nginstack(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 |
|
timeSensitive |
boolean |
<optional> |
Determina se a parte de tempo (horas, minutos, segundos e
milissegundos) será considerada na comparação. Por padrão será |
Returns:
Será retornado um número negativo se referenceDate for menor que
compareDate, positivo se for maior e zero se forem iguais.
- Type
- number