<dvt:timeAxisDateFormat>

timeAxisDateFormat time axis date format


Use the timeAxisDateFormat tag to specify the format for the time axis.

Relationship with other tags

This component must be a child of one of the following components:

Example

The following example shows the XML for a timeAxisDateFormat tag.

   <dvt:graph> 
      <dvt:timeAxisDateFormat yearFormat="YEAR_LONG"/>
   </dvt:graph>

Attributes

Name Type Supports EL? Description
id java.lang.String no Specifies the identifier for the component
yearFormat java.lang.String yes Specifies the format for year information.

The default value is automatic, and it will change based on the occupancy of the axis labels. Valid values are:

  • AUTOMATIC - (Default) The graph chooses the setting automatically.
  • YEAR_LONG - The number of the year. Example: 2006.
  • YEAR_LONG_WITH_COMMA - The number of the year with a comma. Example: 2,006.
  • YEAR_SHORT - The number of the year without the century indicator. Example: 06 instead of 2006.
  • YEAR_SHORT_WITH_APOSTROPHE - The number of the year without the century indicator but with a comma. Example: '06.
  • NONE - Year is not shown.
quarterFormat java.lang.String yes Specifies the format for quarter information.

The default value is automatic, and it will change based on the occupancy of the axis labels. Valid values are:

  • AUTOMATIC - (Default) The graph chooses the setting automatically.
  • QUARTER_LONG - The text and number of the quarter. Example: Quarter 1.
  • QUARTER_SHORT - Abbreviated text and number of the quarter. Example: Qtr 1.
  • QUARTER_SINGLE_LETTER - Single letter and the number of the quarter. Example: Q1.
  • NONE - Quarter is not shown.
monthFormat java.lang.String yes Specifies the format for month information.

The default value is automatic, and it will change based on the occupancy of the axis labels. Valid values are:

  • AUTOMATIC - (Default) The graph chooses the setting automatically.
  • MONTH_LONG - Full name of the month. Example: January.
  • MONTH_SHORT - Abbreviated name of the month. Example: Jan.
  • MONTH_NUMBER - Number of the month. Example for January: 1.
  • MONTH_SINGLE_LETTER - First letter of the month. Example for January: J.
  • NONE - Month is not shown.
dayFormat java.lang.String yes Specifies the format for day information.

The default value is automatic, and it will change based on the occupancy of the axis labels. Valid values are:

  • AUTOMATIC - (Default) The graph chooses the setting automatically.
  • DAY_OF_WEEK_NUMBER - The number of the day in the week. Example for Monday: 1.
  • DAY_OF_WEEK - The text for the day of the week. Example: Monday.
  • DAY_OF_WEEK_ABBR - The string abbreviation of the day of the week. Example: Mon.
  • DAY_SINGLE_LETTER - The first letter of the day of the week. Example: M.
  • NONE - Day is not shown.
timeFormat java.lang.String yes Specifies the format for time information.

The default value is automatic, and it will change based on the occupancy of the axis labels. Valid values are:

  • AUTOMATIC - (Default) The graph chooses the setting automatically.
  • HOUR - Hour on a 12-hour clock. Example: 03 pm.
  • HOUR24 - Hour on a 24-hour clock. Example: 15.
  • HOUR_MINUTE - Hour and minute on a 12-hour clock. Example: 03:20 pm.
  • HOUR24_MINUTE - Hour and minute on a 24-hour clock. Example: 15:20.
  • HOUR_MINUTE_SECOND - Hour, minute, second on a 12-hour clock. Example: 03:20:05 pm.
  • HOUR24_MINUTE_SECOND - Hour, minute, second on a 24-hour clock. Example: 15:20:05.
  • NONE - Time is not shown.