Funções de data

Aprenda sobre as funções de data da Digibee Integration Platform e como utilizá-las.

As funções de data são usadas para processar, gerar e converter datas. Elas estão disponíveis para conectores que suportam expressões Double Braces. Para saber como fornecer informações aos conectores usando esse recurso, consulte Funções Double Braces.

FORMATDATE

Usando Double Braces, você pode combinar esta função com o acesso ao elemento JSON de entrada de um conector.

FORMATDATE formata valores de data e hora, com suporte opcional para locale e timezone.

Sintaxe

FORMATDATE(value, "formato-origem", "formato-destino", "locale-origem"?, "timezone-origem"?, "locale-destino"?, "timezone-destino"?)

Parâmetros marcados com ? são opcionais e podem ser definidos como null.

Definição do formato de data: dd/MM/yyyy. Você também pode usar a palavra-chave timestamp no lugar de uma string de formato. O valor sempre será convertido usando ISO Zoned Date/Time.

Padrões de formato de data e hora

Consulte a documentação Java DateTimeFormatter para mais detalhes sobre padrões de formato de data e hora.

Padrões comuns:

Padrão	Descrição
y	Ano (ano da era)
u	Ano
M	Mês do ano
d	Dia do mês
E	Dia da semana (texto)
e, c	Dia da semana (número)
D	Dia do ano (1–365)
H	Hora (0–23)
h	Hora (1–12)
a	Marcador AM/PM
m	Minutos
s	Segundos

Exemplo de entrada

{
  "date": "10/10/2010 11:59:59",
  "date_no_time": "30/10/2010",
  "time_no_date": "11:12:13",
  "timestamp_date": 1564670039000,
  "date_time_utc": "2012-10-01T09:45:00.0000000+00:00"
}

Exemplos de conversão

{
  "timezone_conversion": {{ FORMATDATE(message.date, "dd/MM/uuuu HH:mm:ss", "dd/MM/uuuu HH:mm:ss z", null, "GMT-3", null, "UTC") }},

  "simple_date": {{ FORMATDATE(message.date_no_time, "dd/MM/uuuu", "MM/dd/uuuu") }},

  "simple_time": {{ FORMATDATE(message.time_no_date, "HH:mm:ss", "ss:mm:HH") }},

  "date_from_timestamp": {{ FORMATDATE(message.timestamp_date, "timestamp", "dd/MM/uuuu HH:mm:ss") }},

  "simple_date_to_timestamp": {{ FORMATDATE(message.simple_date, "dd/MM/uuuu", "timestamp") }},

  "iso_date_time": {{ FORMATDATE(message.timestamp_date, "timestamp", null) }},

  "date_month_name_pt_br": {{ FORMATDATE(NOW(), "timestamp", "dd/MMMM/uuuu", null, null, "pt-BR", null) }},

  "date_time_utc": {{ FORMATDATE(message.date_time_utc, "uuuu-MM-dd'T'HH:mm:ss.SSSSSSSXXX", "dd/MM/uuuu HH:mm:ss") }}
}

NOW

Usando Double Braces, você pode combinar esta função com o acesso ao elemento JSON de entrada de um conector.

NOW retorna a data e hora atuais como um timestamp em milissegundos.

Sintaxe

NOW()

Exemplos de uso

{
  "now": {{ NOW() }},

  "currentDate": {{ FORMATDATE(NOW(), "timestamp", "uuuuMMdd", null, "GMT-3") }},

  "currentTime": {{ FORMATDATE(NOW(), "timestamp", "HHmmss", null, "GMT-3") }},

  "tomorrow": {{ FORMATDATE(TOLONG(SUM(NOW(), 86400000)), "timestamp", "uuuuMMdd") }},

  "time5minBefore": {{ TOLONG(SUBTRACT(NOW(), TOLONG("300000"))) }}
}

SUMDATE

Usando Double Braces, você pode combinar esta função com o acesso ao elemento JSON de entrada de um conector.

SUMDATE adiciona ou subtrai uma determinada quantidade de tempo de uma data, com base em uma unidade de tempo especificada.

Sintaxe

SUMDATE(milliseconds:number, unit:string, value:string)

Parâmetros:

• milliseconds — a data de entrada como um timestamp Unix.

• unit — a unidade de tempo a ser aplicada. Valores aceitos: hour, minute, second, day, month e year.

• value — a quantidade de tempo a ser adicionada (use um número negativo para subtrair).

• zoneId — (opcional) o fuso horário da data de entrada. O padrão é UTC.

Fusos horários aceitos

• Australia/Darwin

• Australia/Sydney

• America/Argentina/Buenos_Aires

• Africa/Cairo

• America/Anchorage

• America/Sao_Paulo

• Asia/Dhaka

• Africa/Harare

• America/St_Johns

• America/Chicago

• Asia/Shanghai

• Africa/Addis_Ababa

• Europe/Paris

• America/Indiana/Indianapolis

• Asia/Kolkata

• Asia/Tokyo

• Pacific/Apia

• Asia/Yerevan

• Pacific/Auckland

• Asia/Karachi

• America/Phoenix

• America/Puerto_Rico

• America/Los_Angeles

• Pacific/Guadalcanal

• Asia/Ho_Chi_Minh

Exemplo

Para adicionar 10 segundos a um timestamp:

{
  "test": {{ SUMDATE(1599368565518, "SECOND", 10) }}
}

Resultado esperado:

{ 1599368565528 }

TOISODATE

Usando Double Braces, você pode combinar esta função com o acesso ao elemento JSON de entrada de um conector.

TOISODATE converte um valor de data e hora para o formato ISO Date, com suporte opcional a locale e timezone.

Sintaxe

TOISODATE(value, "formatoOrigem", "formatoDestino", "locale"?, "timezone"?)

Parâmetros marcados com ? são opcionais e podem ser definidos como null.

Definição do formato de data: dd/MMMM/yyyy HH:mm:ss. Você também pode usar a palavra-chave timestamp no lugar de uma string de formato. Se nenhum timezone for especificado, o UTC será usado por padrão.

Exemplo de entrada

{
  "date": "10/10/2010 11:59:59",
  "date_with_tz": "10/10/2010 11:59:59 GMT-03:00",
  "localized_date_with_tz": "10/Outubro/2010 11:59:59 GMT-03:00",
  "timestamp_date": "1564670039000",
  "date_no_time": "30/09/2018"
}

Exemplos de conversão

{
  "forced_utc_no_locale": {{ TOISODATE(message.date, "dd/MM/uuuu HH:mm:ss", null, "UTC") }},

  "inferred_tz_no_locale": {{ TOISODATE(message.date_with_tz, "dd/MM/uuuu HH:mm:ss z") }},

  "localized_date_with_tz": {{ TOISODATE(message.localized_date_with_tz, "dd/MMMM/uuuu HH:mm:ss z", "pt-BR") }},

  "date_generated_from_timestamp": {{ TOISODATE(message.timestamp_date, "timestamp") }},

  "iso_datetime_from_date_only": {{ TOISODATE(message.date_no_time, "dd/MM/uuuu", null, "GMT-3") }}
}

DIFFDATE

DIFFDATE calcula a diferença entre duas datas.

Sintaxe

DIFFDATE(timestamp1, timestamp2, "timeUnit")

Parâmetros:

• timestamp1, timestamp2 — ambas as datas devem ser fornecidas no formato timestamp.

• timeUnit — valores aceitos: year, month, day, hour, minute, second e millisecond.

O cálculo é realizado como: timestamp2 - timestamp1.

Observações:

• Se a diferença entre as duas datas for menor que 1 unidade, o resultado será 0.

• Se timestamp1 for maior que timestamp2, a função retorna um valor negativo.

Exemplo de entrada

{
  "timestamp1": "1550458800000",
  "timestamp2": "1613617200000"
}

Exemplos de aplicação

{
  "years": {{ DIFFDATE(message.timestamp1, message.timestamp2, "year") }},

  "months": {{ DIFFDATE(message.timestamp1, message.timestamp2, "month") }},

  "hours": {{ DIFFDATE(message.timestamp1, message.timestamp2, "hour") }}
}