clsUTCToTimeZone Step

Use this step to convert UTC datetime to selected time zone.

Last published at: June 11th, 2024

Description:

Convert UTC date times to the selected time zone

 

Inputs

  • timeZone - Select Time Zone
  • utcVarGlobals - Select UTC date/time and variables/globals
 

 

Returns

  • True – step executed successfully 
  • False – step failed to execute
 

 

Usage:

 

 

Example:

Let’s build and execute the clsUTCToTimeZoneDef example.

  • Create a new definition called “clsUTCToTimeZoneDef.
  • Select the definition and click the “design” button
  • Drag the above controls to the canvas
  • Connect the dots between the controls as above
  • Define a variable/global to store the result after execution

 

  • Click on the “clsUTCToTimeZone” step to configure its “Settings” properties. Provide the step name. Select the time zone from the drop-down list to convert the UTC datetime value. Click on the button to configure the UTC datetime value.  

 

  • Click on the button to configure the UTC datetime value.  A popup window is displayed for configuration. Provide the UTC datetime value or a variable reference. This UTC value is converted to the selected time zone and stored in the variable/global reference provided here. Click on the Save button to confirm.  

 

  • The “Logging” setting configuration is necessary for documentation and also measures the workflow progress and the percent complete. This is achieved by configuring the step state and percent fields individually, as shown in the images below. Configure the “Logging” using the following properties.

 

  • Save the process definition, create a new process instance, and execute. Render the process instance. Click on the process step to view its properties. The step should convert UTC date times to the selected time zone, as shown in the graphic below.

 

  • In this example, the UTC value “2024-06-11T18:05:00” is converted to “2024-06-11T14:05:00” with Eastern Standard Time Zone.