convertEpochToObject (time)
  • 18 Oct 2024
  • Dark
    Light
  • PDF

convertEpochToObject (time)

  • Dark
    Light
  • PDF

Article summary

Task Purpose

The convertEpochToObject task converts an Epoch timestamp into a date string with a specified time/date format.

Potential Use Case

Let's say you have a northbound system that is only capable of providing an Epoch timestamp. The convertEpochToObject task allows you to convert it into a human-readable timestamp for log files or other event records.

Properties

Input and output properties are shown below.

Input Variables

Incoming Type Description Example
epoch Number Required. The Epoch timestamp to convert. Epoch timestamps are defined as the number of seconds or milliseconds that have elapsed since midnight UTC on January 1st, 1970. 1688050800
epochFormat Enum Required. The format of the epoch timestamp value. Allowed values are Seconds or Milliseconds. Seconds
newFormatString String Optional. The moment.js format of the converted epoch value. YYYY-MM-DDTHH:mm:ss.SSSSSSZZ

Output Variables

Outgoing Type Description
convertedTime Object The converted time value. Presented in the format specified by the newFormatString parameter.

Example 1

In this IAP example:

  • The epoch variable is provided by the output of the reference task convertTimeToEpoch, which is located located elsewhere in the workflow.

    Note: The convertTimeToEpoch task was used only to simulate an incoming Epoch timestamp for this example.

  • The reference variable provided by the convertTimeToEpoch task is epochTime.

  • The EpochFormat variable is set to Seconds.

  • The newFormatString variable is set to LLL, which is the momentum.js locale format for Month name, day of month, year, time.

  • For this example, the convertedTime produced upon output will be the value of the epoch timestamp presented in a human-readable format.

    convertEpochToObject-ex01


Example 2

In this IAP example:

  • The epoch variable is provided by the output of the reference task convertTimeToEpoch, which is located located elsewhere in the workflow.

    Note: The convertTimeToEpoch task was used only to simulate an incoming Epoch timestamp for this example.

  • The reference variable provided by the convertTimeToEpoch task is epochTime.

  • The EpochFormat variable is set to Seconds.

  • The newFormatString property is set to DD-MMM-YY hh:mm a, which is a date time format for Day-Month-Year hour:min am/pm.

  • For this example, the convertedTime produced upon output will be the value of the epoch timestamp presented in a human-readable format.

    convertEpochToObject-ex02


Example 3

In this IAP example:

  • The epoch property is statically set to the number 1591045860.

  • The EpochFormat property is set to Seconds.

  • The newFormatString property is set to DD-MMM-YY hh:mm a, which is a date time format for Day-Month-Year hour:min am/pm.

  • For this example, the convertedTime produced upon output will be the value of the epoch timestamp presented in a human-readable format. In this case the converted timestamp will be 01-Jun-20 09:11 pm.

    convertEpochToObject-ex03


Was this article helpful?

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.