Date functions

Learn about date functions in the Digibee Integration Platform and how to use them.

The date functions treat, generate and convert dates and are available for components that support Double Braces expressions. To know how to provide information to the components using this resource, refer to Double Braces Functions.

Check the Oracle SimpleDateFormat documentation to obtain more information about date formats and how to use it in functions such as FORMATDATE.

FORMATDATE

By using Double Braces, you can combine the function with the access to the input JSON element of a component.

The function is applied to format date and time (including the possibility of treating your locale and timezone).

Syntax

FORMATDATE(value, "origin-format", "destination-format", "locale-origin"?, "timezone-origin"?, "locale-destination"?, "timezone-destination"?)

The items included with "?" can be defined with null value.

• date format definition: dd/MM/yyyy. It's also possible to define the 'timestamp' word only.

• the value will be always converted with ISO Zoned Date/Time.

Input value:

{
"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"
}

Conversion examples:

{

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

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

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

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

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

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

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

"date_time_utc" : {{FORMATDATE(message.date_time_utc, "yyyy-MM-dd'T'HH:mm:ss.SSSSSSS+SS:SS", "dd/MM/yyyy HH:mm:ss")}}

}

NOW

By using Double Braces, you can combine the function with the access to the input JSON element of a component.

The function is applied to return double value from a whole number.

Syntax

NOW()

{

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

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

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

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

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

}

The return of this function will be the current date in milliseconds.

SUMDATE

By using Double Braces, you can combine the function with the access to the input JSON element of a component.

The function returns the sum or subtraction of a determined date and time given a time unit.

Syntax

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

● milliseconds: timestamp

● unit: time unit (accepted values: hour, minute, second, day, month and year)

● value: date and time values to be added

● zoneId: zone of the informed date (standard: UTC)

The accepted zones (UTC) are:

• 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

Let's say you need to obtain date and time adding 10 seconds to it. You can do the following:

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

The expected result will be:

{1599368565528}

TOISODATE

By using Double Braces, you can combine the function with the access to the input JSON element of a component.

The function is applied to convert date and time to ISO Date (including the possibility to treat your locale and timezone).

Syntax

TOISODATE(valor, "formatSource", "formatDestination", "locale"?, "timezone"?)

The items included with "?" can be defined with null value.

• definition of the date format: dd/MMMM/yyyy HH:mm:ss. It's also possible to define the 'timestamp' word only.

• If the timezone isn't defined, the UTC will be used.

Input value:

{
"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"
}

Conversion examples:

{

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

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

"localized_date_with_tz": {{TOISODATE(message.localized_date_with_tz, "dd/MMMM/yyyy 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/yyyy", null, "GMT-3")}}

}

DIFFDATE

This function allows you to calculate the difference of time between two dates.

Syntax

DIFFDATE(timestamp1, timestamp2, "timeUnit")

• The dates that will be used must be in timestamp format.

• The timeUnit parameter only accept the values: year, month, day, hour, minute, second e millisecond.

• The calculation applied will be: timestamp2 - timestamp1

Input values:

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

Application examples:

{

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

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

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

}

If the function receives 2 dates that have a difference lower than 1 based on the time unit given, the result will be 0. If the timestamp1 parameter is greater than timestamp2, the function will return the negative difference.