Home
Function Reference
1010data Insights Platform offers a rich set of functions that may be used in value expressions when creating computed columns and in selection expressions when performing row selections.
Time/Date functions
The time/date functions are vector functions that operate on columns containing time-related data and return specific information about the date/time for each row.
Time functions
These functions provide a set of tools for performing time-related operations in the 1010data Insights Platform Macro Language.
fromdatetime(X;Y)
Formats a date+time in the form XXXX.YYYYYYYYYYY as a string according to a template. (Available as of version 15.19)

Function Reference
1010data Insights Platform offers a rich set of functions that may be used in value expressions when creating computed columns and in selection expressions when performing row selections.
- All 1010data Functions
  1010data provides a whole range of functions that can provide information and act on your data.
- Time/Date functions
  The time/date functions are vector functions that operate on columns containing time-related data and return specific information about the date/time for each row.
  - Time functions
    These functions provide a set of tools for performing time-related operations in the 1010data Insights Platform Macro Language.
    - datetime(X;Y)
      Returns the date+time value corresponding to a given date and time.
    - dtunix(X;Y)
      Return a 1010 timestamp (date+time) value given an integer, bigint, or floating-point value representing Unix-epoch time. (Available as of version 18.04)
    - fromdatetime(X;Y)
      Formats a date+time in the form XXXX.YYYYYYYYYYY as a string according to a template. (Available as of version 15.19)
    - fromtime(X;Y)
      Formats a time value in the form HHMMSS as a string according to a template. (Available as of version 15.19)
    - hour(X)
      Returns the hour portion of a time-related value.
    - logindatetime(X)
      Returns the date and time of the current session's login within a given time zone.
    - minute(X)
      Returns the minutes portion of a time-related value.
    - second(X)
      Returns the seconds portion of a time-related value.
    - secs(X)
      Returns the number of seconds from midnight to a time-related value.
    - time(X)
      Returns the time portion of a date+time value.
    - todatetime(X;Y)
      Convert a string, date+time, or date to a date+time value in the form XXXX.YYYYYYYYYYY. (Available as of version 15.19)
    - tohour(X;Y)
      Convert a string, date+time, or time to a time value in the form HH. (Available as of version 18.04)
    - tohrmin(X;Y)
      Convert a string, date+time, or time to a time value in the form HHMM. (Available as of version 18.04)
    - tohrmin00(X;Y)
      Convert a string, date+time, or time to a time value in the form HHMM*100. (Available as of version 18.04)
    - tominute(X;Y)
      Convert a string, date+time, or time to a time value in the form MM. (Available as of version 18.04)
    - tosecond(X;Y)
      Convert a string, date+time, or time to a time value in the form SS. (Available as of version 18.04)
    - totime(X;Y)
      Convert a string, date+time, or time to a time value in the form HHMMSS. (Available as of version 15.19)
    - unixdt(X;Y)
      Return a Unix-epoch time value given a string, date, or date+time value. (Available as of version 18.04)
  - Date Functions
    These functions provide a set of tools for performing common and advanced operations on dates in the 1010data Insights Platform Macro Language.
- Group functions (g_functions)
  Group functions, or g_functions, are used to perform operations, such as summarizations, on rows that have the same values in a set of given columns.
- Math functions
  Math functions are vector functions that perform mathematical operations on one or more columns and return a column of results based on the operation.
- Matrix functions
- Categorization functions
  Categorization functions are vector functions that organize data and determine logical groupings. These functions can be used for conditionalizing results and/or bucketing value ranges.
- String functions
  String functions are vector functions that manipulate vectors of strings to provide information about a string or substring, concatenate and split strings, or transform strings based on specified criteria.
- List functions
  List functions are scalar functions that return lists, subsets of lists, and combinations of lists, among other functionality. Lists, along with packages, are compound scalar data types that facilitate programmatic interaction with scalar data values and variables.
- Data-handling functions
  Data-handling functions are vector functions that return a hash value based on an input column or columns.
- Row functions
  Row functions are vector functions that return computational outputs for row inputs, as opposed to column outputs. Row inputs are defined as a space- or comma-separated list of column names.
- SQL compatibility functions
  SQL compatibility functions are functions that treat null values as SQL nulls.
- Financial functions
- System functions
  System functions are special functions in 1010data that return information about users, tables, and other system objects.
- Object functions
  The object functions can be used to check the existence, type, and accessibility of objects such as folders, tables, and queries on the 1010data Insights Platform.
- Miscellaneous functions
  This category of functions contains special functions that don't neatly fit into other categories of functions.

`fromdatetime(X;Y)`

Formats a date+time in the form XXXX.YYYYYYYYYYY as a string according to a template. (Available as of version 15.19)

Syntax

fromdatetime(X;Y)

Input

Argument Type Description

X

decimal

A scalar value or the name of a column containing date-related values

Valid values can be of the form:

date+time

Y

text

A "template" string specifying how the output should be formatted

The following is a partial list of string templates:

'MM/DD/YY_HH:MI:SS'
'MM/DD/YYYY_HH:MI:SS'
'YYYY-MM-DD HH:MI:SS'
'YYYY-MM-DD HH24:MI:SS'
'YYYY-MM-DD"T"HH24:MI:SS"Z"'

Return Value

Returns a string value of the date formatted using the template specified in the Y argument.

For more information about date formats, see Dates and time.

Example

The following example first uses datetime(X;Y) to create a date+time value from two columns in the pub.demo.weather.wunderground.observed_hourly table: date and time. The date+time value appears in the Observed Date/Time column.

Then, fromdatetime(X;Y) converts the date+time value into a string value in the form 'YYYY-MM-DD HH24:MI:SS'. This string value appears in the Observed Date/Time (string) column.

Note: Because the pub.demo.weather.wunderground.observed_hourly table is so large, the calculations are only done for one particular zip code.

<base table="pub.demo.weather.wunderground.observed_hourly"/>
<sel value="(zipcode='10017')"/>
<willbe name="observed_date_time" value="datetime(date;time)" 
 label="Observed Date/Time" format="type:datehms24"/>
<willbe name="observed_date_time_string" value="fromdatetime(observed_date_time;'YYYY-MM-DD HH24:MI:SS')"
 label="Observed Date/Time (string)"/>
<colord cols="date,time,observed_date_time,observed_date_time_string"/>