UNIXTIME Function

Contents:

Expand all Collapse all

Derives the Unixtime (or epoch time) value from a Datetime value. Source value can be a reference to a column containing Datetime values.

Unix time is a date-time format used to express the number of milliseconds that have elapsed since January 1, 1970 00:00:00 (UTC).

Unix time does not handle the extra seconds that occur on the extra day of leap years.

This function factors any timezone values in the inputs.

If you have a column with multiple time zones, you can convert the column to Unixtime so you can perform Date/Time operations with a standardized time zone.
If you want to work with local times, you can truncate the time zone or use other Date functions.
If the source Datetime value does not include a valid input for this function, a missing value is returned.

Basic Usage

derive type:single value:UNIXTIME(MyDate)

Output: Generates a column of values that computes the Unix time values from the MyDate column.

derive type:single value:UNIXTIME(datetime_col)

Argument	Required?	Data Type	Description
datetime_col	Y	datetime	Name of column whose Unix time values are to be computed

For more information on syntax standards, see Language Documentation Syntax Notes.

Name of the column whose Unix time value is to be computed.

Missing values for this function in the source data result in missing values in the output.
Invalid or out-of-range source values generate missing values in the output.
Multiple columns and wildcards are not supported.
Includes time zone offset when it converts Date/Time values to unixtime.
If the date value does not include a time zone, unixtime uses UTC (0:00).

Usage Notes:

Required?	Data Type	Example Value
Yes	Datetime	`myDate`

Tip: For additional examples, see Common Tasks.

This example illustrates how you can use functions to manipulate Unix time values in a column of Datetime type.

UNIXTIME - Returns the Unix time value computed from a Datetime value. See UNIXTIME Function.
UNIXTIMEFORMAT - Formats a Unix time value in the specified manner. See UNIXTIMEFORMAT Function.

Source:

Transform:

Use the following to generate a column containing the above values as Unix timecode values:

derive type:single value: UNIXTIME (date)

Results:

NOTE: If the source Datetime value does not contain a valid input for one of these functions, no value is returned.

See Also for UNIXTIME Function:

Send Feedback