date-to-text

Converts a date/time value to text in a specified format

Takes given date (with specified format) and converts it to text. Or converts the current date-time into text.

Arguments

Inputs:

value: The input date/time value.\nIf unspecified, the current date/time will be used.

format: The format of the date, based on Unicode Technical Standard #35. If unspecified, defaults to 'ISO 8601'. https://www.unicode.org/reports/tr35/tr35-dates.html#Date_Field_Symbol_Table

locale: A language locale to be used when formatting the values. See https://github.com/moment/moment/tree/develop/locale. If unspecified, it defaults to 'en-GB'. Essentially, this determines the alphanumeric display beyond the format specified above. If the specified format contains location- or language-dependent variables (e.g. day-names, month-names, week numbers, etc), then the locale will affect how they look (e.g. 'Tuesday' or 'Mardi')

Output:

text: The date as formatted text.

Example

Date-to-text can be used to create a timestamp of when the data-flo was run.

This data-flo uses the Date-to-text adaptor to create a timestamp, then concatenates that timestamp with other text (concatenate-text) to update the name of a Microreact project. The title of the Microreact project thus always reflects when it was updated using Data-flo.

Data-flo - Run: Adaptor Demo: Date-to-text - Data-flo

Example data-flo using date-to-text

Converting the current time to text

Converting a specific date-time value into text

Possible use cases

• Preparing a date to be used as input to another adaptor's text-data-type argument.

• Updating a Microreact project name with the latest date-time the data was refreshed. This entails leaving the value argument blank and concatenating the date text output with the rest of the Microreact project name.