Commands

{formdate}

Sample Usage
Due date and time: {formdate: LLL}
_

Quick Overview Video

Settings


Setting NameTypeDescription
PositionalformatThe format for the date/time.
startdate/timeThe minimum selectable date/time.
enddate/timeThe maximum selectable date/time.
colsnumberThe width of the form field in columns of characters.
General Form Settings
nametextName used for labels and data bindings.
default–The default value for the form field.
formatterfunctionFormats the value of the field before snippet insertion.
General Command Settings
trimyes/no/left/rightIf yes whitespace is removed before and after the command. If left, only whitespace to the left is removed. If right, only whitespace to the right is removed.

To learn more about form commands and their capabilities, see the forms guide.

Formatting Dates and Times

The {formdate} command requires a format setting that tells Text Blaze how to format the date/time when inserting. This format uses the same notation as the {time} command.

Click here to learn about time/date formatting in Text Blaze.

The format setting must contain enough information to define a full date or a full time. Generally, the date needs to contain at least a day, month and year component to be full. Similarly, the time needs to contain hours and minutes to be full. For this reason MM DD YYYY would be considered a full date format, whereas YYYY would be short as it omits the day and month. Similarly, HH:mm would be a full time format, while HH would be short as it lacks the minutes component.

Full and Short Formats
Full Date and Time: {formdate: LLL; name=datetime} Full Date only: {formdate: YYYY-MM-DD; name=date} Full Time only: {formdate: HH:mm; name=time}

Short date format as it does not define a full date: {formdate: YYYY} Short date format as it does not define a full date: {formdate: MM YYYY} Short time format as it does not define a full time: {formdate: HH} Short time format as it does not define a full time: {formdate: mm}
_

When entering a date/time via the {formdate} in the form popup, the date selector will use the same format that you define in the {formdate}'s positional setting.

Also, the same format will be used when using the date/time in a formula.

Example Formats
Formdate 1: {formdate: MM DD, YYYY; name=date1} Formatted: {=date1} Formdate 2: {formdate: YYYY-MM-DD; name=date2} Formatted: {=date2} Formdate 3: {formdate: LL; name=date3} Formatted: {=date3} Formdate 4: {formdate: HH:mm; name=time1} Formatted: {=time1} Formdate 5: {formdate: hh:mm A; name=time2} Formatted: {=time2} Formdate 6: {formdate: LT; name=time3} Formatted: {=time3} Formdate 7: {formdate: MM DD, YYYY HH:mm; name=datetime1} Formatted: {=datetime1} Formdate 8: {formdate: LLL; name=datetime2} Formatted: {=datetime2}
_

Restricting Selectable Dates and Times

You can optionally restrict the range of dates/times that can be selected using the start and end settings.

The start and end settings are dates/times that may be entered in the same format as the formdate's format setting, or in a canonical YYYY-MM-DD or HH:mm format.

You can also embed {time} commands in order to create a dynamic range as seen in this example.

Restricting the Selectable Range
Select a date in 2012: {formdate: LL; start=2012-01-01; end=2012-12-31}

Select a date in the next 14 days: {formdate: LL; start={time: YYYY-MM-DD}; end={time: YYYY-MM-DD; shift=+14D}}
_