A custom format is used for the output of objects. The value of a custom format is the method name evaluated upon the object to be inserted. The method should return an object that, when converted to a string, yields the desired text. For example, the DTML source text:
<!--#var date fmt=DayOfWeek-->
inserts the result of calling the method, DayOfWeek, with the value of the variable date . As the example suggests, the most common use of custom formats in Zope is in the output of date-time data. Appendix A, Date-time data provides a summary of the custom formats available for date-time data.
In addition to custom formats, a few special formats are defined by the var tag that can be used with the fmt attribute. These are summarized in table See Special formats that may be used with the var tag fmt attribute.
Show a numeric value with a dollar symbol and two decimal places. |
|
In addition to custom and special formats, C11-style formats may also be used. A C-style format consists of text containing a single conversion specification. A conversion specification consists of a percent sign, optionally followed by a flag, a field width, a precision value, and a conversion specifier. A description of C-style formats is beyond the scope of this document. For details on C-style formats, see a C-language reference manual. Not all conversion specifiers are supported by DTML. Table See C-style specifiers for the fmt attribute summarizes the conversion specifiers that DTML does support.