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.



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'.

locale: A language locale to be used when formatting the values. See 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')


text: The date as formatted text.


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.

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.

Last updated