todatetime() Function

Function

todatetime( value )

Converts a value to Date and Time.

See also: datetime()

Parameters

Keyword Type Description

value

Any Type

Value to convert.

Returns

Datetime

Usage considerations

Using todatetime() with arrays

When operating on arrays, it is not necessary to use apply with todatetime. If multiple parameters are passed, or one parameter is an Array, todatetime will return a Datetime Array.

Date formatting

Text will be parsed in 'm/d/y' format to form a datetime.

Time zones

When datetime values are presented to users in the interface, they are localized to the current user's timezone. This can cause the expected output to vary significantly. Additionally, the acronym of the local timezone (such as EST) is appended to a displayed datetime value when it appears in a form, an alert, or in an email.

Examples

todatetime(date(2005,12,13)) returns 12/13/05 12:00 AM GMT

todatetime("12/13/2005") returns 12/13/05 12:00 AM GMT

todatetime("12/13/2005","12/14/2005") and todatetime({"12/13/2005","12/14/2005"}) both return {12/13/05 12:00 AM GMT,12/14/05 12:00 AM GMT}

Feature compatibility

The table below lists this function's compatibility with various features in Appian.
Feature Compatibility Note
Portals Compatible
Offline Mobile Compatible
Sync-Time Custom Record Fields Compatible

Can be used to create a custom record field that only evaluates at sync time.

Real-Time Custom Record Fields Incompatible
Process Reports Compatible
Process Events Compatible
Open in Github Built: Fri, Jan 27, 2023 (07:42:54 PM)

On This Page

FEEDBACK