Utilities - DateTime | New Relic Documentation

This page provides a comprehensive reference for utilities - datetime available in the workflow automation actions catalog. These actions enable you to date and time utilities.

Convert an epoch to date/time

This action is used to transform from epoch timestamp to date/time. Possible references:

Refer fromEpoch for more information.

Input	Type	Description
timestamp	Int	Required. An integer representing epoch timestamp. Note: UNIX epochs are the number of seconds after 1st Jan 1970, midnight UTC (00:00)
timestampUnit	string	Optional. A string representing unit of provided timestamp. Acceptable values: `SECONDS`, `MILLISECONDS(DEFAULT)`
timezoneId	String	Optional. A string representing timezone for desired date/time, default: UTC For more information on supported zoneIds refer: ZoneId (Java Platform SE 8 )
pattern	String	Optional. A string representing pattern for desired datetime, default: `ISO-8601` For more information on supported patterns refer: DateTimeFormatter (Java Platform SE 8 )
selectors	List	Optional. The selectors to get the only specified parameters as output.

Field	Datatype	Description
date	String	Required. A string representation of date.
time	String	Required. A string representation of time.
datetime	String	Required. A string representation of datetime.
timezone	Map	Required. A map representation of timezoneId and abbreviation.
success		Boolean	Status of the request
errorMessage		String	Failure reason as message

Example	Workflow Input	Outputs
name: from_epoch workflowInputs: timestamp: type: Int timestampUnit: type: String timezoneId: type: String pattern: type: String steps: - name: epochTime type: action action: utils.datetime.fromEpoch version: 1 inputs: timestamp: ${{ .workflowInputs.timestamp }} timezoneId: ${{ .workflowInputs.timezoneId }} pattern: ${{ .workflowInputs.pattern }} timestampUnit: ${{ .workflowInputs.timestampUnit }} selectors: - name: date expression: ".date" - name: time expression: ".time" - name: datetime expression: ".datetime" - name: timezone expression: ".timezone"	`mutation { autoflowsStartWorkflowRun( accountId: 11933347 definition: { name: "from_epoch" } workflowInputs: [ {key: "timestamp", value: "1738236424003"} {key: "timestampUnit", value: "MILLISECONDS"} {key: "pattern", value: "yyyy-mm-dd HH:SS"} {key: "timezoneId", value: "Asia/Kolkata"} ] ) { runId } }`	`{ "success": true "date": "2025-01-30", "time": "16:57:04.003" "datetime": "2025-57-30 16:00", "timezone": { "abbreviation": "IST", "id": "Asia/Kolkata" } }`

Example

Workflow Input

Outputs

name: from_epoch

workflowInputs:
  timestamp:
    type: Int
  timestampUnit:
    type: String
  timezoneId:
    type: String
  pattern:
    type: String

steps:
  - name: epochTime
    type: action
    action: utils.datetime.fromEpoch
    version: 1
    inputs:
      timestamp: ${{ .workflowInputs.timestamp }}
      timezoneId: ${{ .workflowInputs.timezoneId }}
      pattern: ${{ .workflowInputs.pattern }}
      timestampUnit: ${{ .workflowInputs.timestampUnit }}
      selectors:
        - name: date
          expression: ".date"
        - name: time
          expression: ".time"
        - name: datetime
          expression: ".datetime"
        - name: timezone
          expression: ".timezone"

mutation {
  autoflowsStartWorkflowRun(
    accountId: 11933347
    definition: { name: "from_epoch" }
    workflowInputs: [
      {key: "timestamp", value: "1738236424003"}
      {key: "timestampUnit", value: "MILLISECONDS"}
      {key: "pattern", value: "yyyy-mm-dd HH:SS"}
      {key: "timezoneId", value: "Asia/Kolkata"}
      ]
  ) {
    runId
  }
}

{
  "success": true
  "date": "2025-01-30",
  "time": "16:57:04.003"
  "datetime": "2025-57-30 16:00", 
  "timezone": {
    "abbreviation": "IST", 
    "id": "Asia/Kolkata"
    }
}

Utilities - DateTime

Convert an epoch to date/time .css-21sua1{background:none;border:none;width:0;padding:0;}

Convert an epoch to date/time