nginstack

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

(require("@nginstack/engine/lib/date/parseDate"))(dateStr [, opt_options])

Cria uma data a partir de uma data formatada ou expressão.

Além de datas completas ou parciais, como "31/12/2026", "3112" ou "15", são aceitas expressões relativas à data base, como "h" (hoje), "-30d" (30 dias atrás), "fm-1m" (fim do mês anterior), "it" (início do trimestre) e "ia-1a" (início do ano anterior). A gramática completa das expressões está descrita em module:@nginstack/engine/lib/date/evaluateDateExpression.

Parameters:
Name Type Argument Description
dateStr string

Data formatada ou expressão.
opt_options Object <optional>

Opções.

Properties
Name Type Argument Description
format DateFormat <optional>

Formato desejado.
rangeLimit Limit <optional>

Indica se o resultado da função representa início ou fim de um intervalo, atualmente só é suportado para formatos abrangentes como DateFormat.MMYYYY (mês/ano) ou DateFormat.WWYYYY(semana/ano). O desenvolvedor pode utilizar Limit.START para pegar o menor (ou Limit.END para o maior) dia dentro do intervalo determinado pelo formato. O resultado das expressões também é ajustado para o menor ou o maior dia do intervalo.
baseDate Date <optional>

Data de onde será montada a data resultante, caso não seja informada será utilizada a data do dia corrente.
See:
Returns:

Data obtida a partir da string informada. Será gerado um erro caso não seja possível converter a string em uma data.

Type
Date

Methods

<inner> snapToRangeLimit(date, format, rangeLimit)

Ajusta o resultado de uma expressão ao período representado pelo formato, assim como ocorre com as datas digitadas: nos formatos de semana e ano ou de mês e ano, o resultado é o primeiro ou o último dia do período, de acordo com o limite informado.

Parameters:
Name Type Description
date Date

Resultado da expressão.
format DateFormat

Formato desejado.
rangeLimit Limit

Limite do intervalo.
Returns:
Type
Date

<inner> validateIsoWeekYearDate(dateExpr)

Valida data para formato semana/ano no padrão iso-8601.

Parameters:
Name Type Description
dateExpr Array.<string>

Data no formato semana/ano no padrão iso-8601.