The <datetext> element is used to add text containing the current date and/or time to the map drawn.

Note that the position attribute must be defined in the units defined by the units attribute of the <template> element, but the font-size is always defined in points.

Frequency Parent Elements (the <datetext> element is valid within): PO+ <template>

Frequency Description (in this context) PO+ The <datetext> element may appear one or more times within the <template> element in any order.

Attributes Description position The page position of the text, expressed in the units specified in the units attribute of the <template> element. The position should be two numbers separated by a comma (with no white space), representing the x and y location. For example, if the units are "points", a value of "72,72" would indicate a position one inch from the left side and bottom side of the page. Required. alignment The alignment of the text, relative to the position. Valid values are "left", "right", and "center". Required. format The date formatting keyword, chosen from one of the following self explaining codes: "date_long", "date_medium", "date_short", "datetime_long", "datetime_medium", "datetime_short", "time_long", "time_medium", "time_short". Optional, defaults to "date_medium". font The font of the text, chosen from one of the following valid font names: "helvetica", "helvetica_bold", "helvetica_boldoblique", "helvetica_oblique", "times_roman", "times_bold", "times_bolditalic", "times_italic", "courier", "courier_bold", "courier_boldoblique", "courier_oblique". Optional, defaults to "helvetica". font-size The font size for the text, expressed in points. Integer value expected, example: font-size="9". Optional, defaults to "9". prefix Text to appear before the date text. Example: prefix="Printed: ". Optional, defaults to no prefix. suffix Text to appear after the date text. Optional, defaults to no suffix. locale-language Used to localize the display of the date to the format used in a particular region. If used, the locale-language attribute must be a lower-case, two-letter ISO Language Code as defined by ISO-639. You can find a full list of these codes here. Optional, defaults to "en" (English) if this attribute is not used. locale-country Used to localize the display of the date to the format used in a particular region. If used, the locale-country attribute must be an upper-case, two-letter ISO Country Code as defined by ISO-3166. You can find a full list of these codes here. Optional, defaults to "US" (United States of America) if this attribute is not used.

Example:

<datetext position="768,26"
     prefix="Printed: "
     font="helvetica" font-size="9"
     format="datetime_medium"
     alignment="right"
     locale-country="AU"/>