The Label property specifies a predefined label for a specified unit. Use the UnitScale property to change the scale unit. The UnitScale property changes the Label, Unit and the ToolTip for a level with predefined values defined by the Label and LabelToolTip properties. Use the UnitWidth property to specify the width of the time unit. Use the Zoom method to zoom the chart to a specified interval of dates. Use the Label property to assign a different label for a specified level. Use the LabelToolTip property to specify the predefined type of tooltip being displayed when the chart is zoomed. Use the ToolTip property to specify the tooltip that shows up when the cursor hovers the level. Use the FormatDate property to format a date. Use the MonthNames property to specify the name of the months in the year. The WeekDays property retrieves or sets a value that indicates the list of names for each week day, separated by space. If the Label property is empty, the unit is not displayed in the zooming scale, if the AllowOverviewZoom property is not exDisableZoom.

The Label property supports alternative HTML labels being separated by "<|>" and values for Count and Unit being separated by "<||>". By alternate HTML label we mean that you can define a list of HTML labels that may be displayed in the chart's header based on the space allocated for the time-unit. In other words,  the control chooses automatically the alternate HTML label to be displayed for best fitting in the portion of the chart where the time-unit should be shown. 

The Label property format is "ALT1[<|>ALT2<|>...[<||>COUNT[<||>UNIT]]]" where 

• ALT defines a HTML label
• COUNT specifies the value for the Count property
• UNIT field indicates the value for the Unit property
• and the parts delimited by [] brackets may miss.

The Label property may change the Unit and the Count property. You can always use a different Unit or Count by setting the property after setting the Label property. 

The Label property supports the following built-in tags:

• <%d%> - Day of the month in one or two numeric digits, as needed (1 to 31).
• <%dd%> - Day of the month in two numeric digits (01 to 31).
• <%d1%> - First letter of the weekday (S to S). ( Use the WeekDays property to specify the name of the days in the week )
• <%d2%> - First two letters of the weekday (Su to Sa). ( Use the WeekDays property to specify the name of the days in the week )
• <%d3%> - First three letters of the weekday (Sun to Sat). ( Use the WeekDays property to specify the name of the days in the week )
• <%ddd%> - First three letters of the weekday (Sun to Sat). ( Use the WeekDays property to specify the name of the days in the week ). You can use the <%loc_ddd%> that indicates the day of week as a three-letter abbreviation using the current user regional and language settings.
• <%loc_ddd%> - Indicates the day of week as a three-letter abbreviation using the current user regional and language settings.
• <%dddd%> - Full name of the weekday (Sunday to Saturday). ( Use the WeekDays property to specify the name of the days in the week ). You can use the <%loc_dddd%> that indicates day of week as its full name using the current user regional and language settings.
• <%loc_dddd%> - Indicates day of week as its full name using the current user regional and language settings.
• <%i%> - Displays the number instead the date. For instance, you can display numbers as 1000, 1001, 1002, 1003,  instead dates. ( the valid range is from -647,434 to 2,958,465 )
• <%w%> - Day of the week (1 to 7).
• <%ww%> - Week of the year (1 to 53).
• <%m%> - Month of the year in one or two numeric digits, as needed (1 to 12).
• <%mr%> - Month of the year in Roman numerals, as needed (I to XII).
• <%mm%> - Month of the year in two numeric digits (01 to 12).
• <%m1%> - First letter of the month (J to D). ( Use the MonthNames property to specify the name of the months in the year )
• <%m2%> - First two letters of the month (Ja to De). ( Use the MonthNames property to specify the name of the months in the year )
• <%m3%> - First three letters of the month (Jan to Dec). ( Use the MonthNames property to specify the name of the months in the year )
• <%mmm%> - First three letters of the month (Jan to Dec). ( Use the MonthNames property to specify the name of the months in the year ). You can use the <%loc_mmm%> that indicates month as a three-letter abbreviation using the current user regional and language settings.
• <%loc_mmm%> - Indicates month as a three-letter abbreviation using the current user regional and language settings.
• <%mmmm%> - Full name of the month (January to December). ( Use the MonthNames property to specify the name of the months in the year ). You can use the <%loc_mmmm%> that indicates month as its full name using the current user regional and language settings.
• <%loc_mmmm%> - Indicates month as its full name using the current user regional and language settings.
• <%q%> - Date displayed as the quarter of the year (1 to 4).
• <%y%> - Number of the day of the year (1 to 366).
• <%yy%> - Last two digits of the year (01 to 99).
• <%yyyy%> - Full year (0100 to 9999).
• <%hy%> - Date displayed as the half of the year (1 to 2).
• <%loc_gg%> - Indicates period/era using the current user regional and language settings.
• <%loc_sdate%> - Indicates the date in the short format using the current user regional and language settings.
• <%loc_ldate%> - Indicates the date in the long format using the current user regional and language settings.
• <%loc_dsep%> - Indicates the date separator using the current user regional and language settings (/).
• <%h%> - Hour in one or two digits, as needed (0 to 23).
• <%hh%> - Hour in two digits (00 to 23).
• <%n%> - Minute in one or two digits, as needed (0 to 59).
• <%nn%> - Minute in two digits (00 to 59).
• <%s%> - Second in one or two digits, as needed (0 to 59).
• <%ss%> - Second in two digits (00 to 59).
• <%AM/PM%> - Twelve-hour clock with the uppercase letters "AM" or "PM", as appropriate. ( Use the AMPM property to specify the name of the AM and PM indicators ). You can use the <%loc_AM/PM%> that indicates the time marker such as AM or PM using the current user regional and language settings. You can use <%loc_A/P%> that indicates the one character time marker such as A or P using the current user regional and language settings
• <%loc_AM/PM%> - Indicates the time marker such as AM or PM using the current user regional and language settings.
• <%loc_A/P%> - Indicates the one character time marker such as A or P using the current user regional and language settings.
• <%loc_time%> - Indicates the time using the current user regional and language settings.
• <%loc_time24%> - Indicates the time in 24 hours format without a time marker using the current user regional and language settings.
• <%loc_tsep%> - indicates the time separator using the current user regional and language settings (:).

The following tags are displayed based on the user's Regional and Language Options:

• <%loc_sdate%> - Indicates the date in the short format using the current user settings.
• <%loc_ldate%> - Indicates the date in the long format using the current user settings.
• <%loc_ddd%> - Indicates day of week as a three-letter abbreviation using the current user settings.
• <%loc_dddd%> - Indicates day of week as its full name using the current user settings.
• <%loc_mmm%> - Indicates month as a three-letter abbreviation using the current user settings.
• <%loc_mmmm%> - Indicates month as its full name using the current user settings.
• <%loc_gg%> - Indicates period/era using the current user settings.
• <%loc_dsep%> - Indicates the date separator using the current user settings.
• <%loc_time%> - Indicates the time using the current user settings.
• <%loc_time24%> - Indicates the time in 24 hours format without a time marker using the current user settings.
• <%loc_AM/PM%> - Indicates the time marker such as AM or PM using the current user settings.
• <%loc_A/P%> - Indicates the one character time marker such as A or P using the current user settings.
• <%loc_tsep%> - Indicates the time separator using the current user settings.
• <%loc_y%> - Represents the Year only by the last digit, using current regional settings.
• <%loc_yy%> - Represents the Year only by the last two digits, using current regional settings. A leading zero is added for single-digit years.
• <%loc_yyyy%> - Represents the Year by a full four or five digits, depending on the calendar used. Thai Buddhist and Korean calendars have five-digit years. The "yyyy" pattern shows five digits for these two calendars, and four digits for all other supported calendars. Calendars that have single-digit or two-digit years, such as for the Japanese Emperor era, are represented differently. A single-digit year is represented with a leading zero, for example, "03". A two-digit year is represented with two digits, for example, "13". No additional leading zeros are displayed.

The Label property supports the following built-in HTML tags:

• <b> ... </b> displays the text in bold
• <i> ... </i> displays the text in italics
• <u> ... </u> underlines the text
• <s> ... </s> Strike-through text
• <a id;options> ... </a> displays an anchor element that can be clicked. An anchor is a piece of text or some other object (for example an image) which marks the beginning and/or the end of a hypertext link.The <a> element is used to mark that piece of text (or inline image), and to give its hypertextual relationship to other documents. The control fires the AnchorClick(AnchorID, Options) event when the user clicks the anchor element. The FormatAnchor property customizes the visual effect for anchor elements.

  The control supports expandable HTML captions feature which allows you to expand(show)/collapse(hide) different information using <a ;exp=> or <a ;e64=> anchor tags. The exp/e64 field of the anchor stores the HTML line/lines to show once the user clicks/collapses/expands the caption.

  • exp, stores the plain text to be shown once the user clicks the anchor, such as <a ;exp=show lines>
  • e64, encodes in BASE64 the HTML text to be shown once the user clicks the anchor, such as <a ;e64=gA8ABmABnABjABvABshIAOQAEAAHAAGESikWio+ABzABohp3iELABpABuABljYAgRhAEaFsqAAvAEsjUCmUEg0IhUMhUPjQAAEBA>+</a> that displays show lines- in gray when the user clicks the + anchor. The gA8ABmABnABjABvABshIAOQAEAAHAAGESikWio+ABzABohp3iELABpABuABljYAgRhAEaFsqAAvAEsjUCmUEg0IhUMhUPjQAAEBA string encodes the <fgcolor 808080>show lines<a>-</a></fgcolor> The Decode64Text/Encode64Text methods of the eXPrint can be used to decode/encode e64 fields.

  Any ex-HTML caption can be transformed to an expandable-caption, by inserting the anchor ex-HTML tag. For instance, <solidline><b>Header</b></solidline><br>Line1<r><a ;exp=show lines>+</a><br>Line2<br>Line3 shows the Header in underlined and bold on the first line and Line1, Line2, Line3 on the rest. The show lines is shown instead of Line1, Line2, Line3 once the user clicks the + sign.

• <font face;size> ... </font> displays portions of text with a different font and/or different size. For instance, the <font Tahoma;12>bit</font> draws the bit text using the Tahoma font, on size 12 pt. If the name of the font is missing, and instead size is present, the current font is used with a different size. For instance, <font ;12>bit</font> displays the bit text using the current font, but with a different size.
• <fgcolor rrggbb> ... </fgcolor> or <fgcolor=rrggbb> ... </fgcolor> displays text with a specified foreground color. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
• <bgcolor rrggbb> ... </bgcolor> or <bgcolor=rrggbb> ... </bgcolor> displays text with a specified background color. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
• <solidline rrggbb> ... </solidline> or <solidline=rrggbb> ... </solidline> draws a solid-line on the bottom side of the current text-line, of specified RGB color. The <solidline> ... </solidline> draws a black solid-line on the bottom side of the current text-line. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
• <dotline rrggbb> ... </dotline> or <dotline=rrggbb> ... </dotline> draws a dot-line on the bottom side of the current text-line, of specified RGB color. The <dotline> ... </dotline> draws a black dot-line on the bottom side of the current text-line. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
• <upline> ... </upline> draws the line on the top side of the current text-line (requires <solidline> or <dotline>).
• <r> right aligns the text
• <c> centers the text
• <br> forces a line-break
• <img>number[:width]</img> inserts an icon inside the text. The number indicates the index of the icon being inserted. Use the Images method to assign a list of icons to your chart. The last 7 bits in the high significant byte of the number expression indicates the identifier of the skin being used to paint the object. Use the Add method to add new skins to the control. If you need to remove the skin appearance from a part of the control you need to reset the last 7 bits in the high significant byte of the color being applied to the part. The width is optional and indicates the width of the icon being inserted. Using the width option you can overwrite multiple icons getting a nice effect. By default, if the width field is missing, the width is 18 pixels.
• <img>key[:width]</img> inserts a custom size picture into the text being previously loaded using the HTMLPicture property. The Key parameter indicates the key of the picture being displayed. The Width parameter indicates a custom size, if you require to stretch the picture, else the original size of the picture is used.
• & glyph characters as &amp; ( & ), &lt; ( < ), &gt; ( > ),  &qout; ( " ) and &#number; ( the character with specified code ), For instance, the &#8364; displays the EUR character. The & ampersand is only recognized as markup when it is followed by a known letter or a #character and a digit. For instance if you want to display <b>bold</b> in HTML caption you can use &lt;b&gt;bold&lt;/b&gt;
• <off offset> ... </off> defines the vertical offset to display the text/element. The offset parameter defines the offset to display the element. This tag is inheritable, so the offset is keep while the associated </off> tag is found. You can use the <off offset> HTML tag in combination with the <font face;size> to define a smaller or a larger font to be displayed. For instance: Text with <font ;7><off 6>subscript displays the text such as: Text with _subscript The Text with <font ;7><off -6>superscript displays the text such as: Text with ^subscript
• <gra rrggbb;mode;blend> ... </gra> defines a gradient text. The text color or <fgcolor> defines the starting gradient color, while the rr/gg/bb represents the red/green/blue values of the ending color, 808080 if missing as gray. The mode is a value between 0 and 4, 1 if missing, and blend could be 0 or 1, 0 if missing. The <font> HTML tag can be used to define the height of the font. Any of the rrggbb, mode or blend field may not be specified. The <gra> with no fields, shows a vertical gradient color from the current text color to gray (808080). For instance the <font ;18><gra FFFFFF;1;1>gradient-center</gra></font> generates the following picture:
  
• <out rrggbb;width> ... </out> shows the text with outlined characters, where rr/gg/bb represents the red/green/blue values of the outline color, 808080 if missing as gray, width indicates the size of the outline, 1 if missing. The text color or <fgcolor> defines the color to show the inside text. The <font> HTML tag can be used to define the height of the font. For instance the <font ;31><out 000000><fgcolor=FFFFFF>outlined</fgcolor></out></font> generates the following picture:
  
• <sha rrggbb;width;offset> ... </sha> define a text with a shadow, where rr/gg/bb represents the red/green/blue values of the shadow color, 808080 if missing as gray, width indicates the size of shadow, 4 if missing, and offset indicates the offset from the origin to display the text's shadow, 2 if missing. The text color or <fgcolor> defines the color to show the inside text. The <font> HTML tag can be used to define the height of the font.  For instance the <font ;31><sha>shadow</sha></font> generates the following picture:
  

  or  <font ;31><sha 404040;5;0><fgcolor=FFFFFF>outline anti-aliasing</fgcolor></sha></font> gets:

  

The Label property may be a combination of any of these tags. For instance, the "<b><%mmm%></b> <%d%>, '<%yy%>" displays a date like: "May 29,'05".

By default, the Label property is:

• exYear: "<%yy%><|>'<%yy%><|><%yyyy%>"
• exHalfYear: ""
• exQuarterYear: ""
• exMonth: "<|><%m1%><|><%m2%><|><%m3%><|><%mmmm%><|><%m3%> '<%yy%><|><%mmmm%> <%yyyy%>"
• exThirdMonth: ""
• exWeek: "<|><%ww%><|><%m3%> <%d%>, '<%yy%><r><%ww%><|><%mmmm%> <%d%>, <%yyyy%><r><%ww%><||><||>256"
• exDay: "<|><%d1%><|><%d2%><|><%d3%><|><%dddd%><|><%d3%>, <%m3%> <%d%>, '<%yy%><|><%dddd%>, <%mmmm%> <%d%>, <%yyyy%><||><||>4096"
• exHour: "<|><%hh%><|><%h%> <%AM/PM%><|><%d3%>, <%m3%> <%d%>, '<%yy%> <%h%> <%AM/PM%><|><%dddd%>, <%mmmm%> <%d%>, <%yyyy%> <%h%> <%AM/PM%><||><||>65536"
• exMinute: "<|><%nn%><|><%h%>:<%nn%> <%AM/PM%><|><%d3%>, <%m3%> <%d%>, '<%yy%> <%h%>:<%nn%> <%AM/PM%><|><%dddd%>, <%mmmm%> <%d%>, <%yyyy%> <%h%>:<%nn%> <%AM/PM%>"
• exSecond: "<|><%ss%><|><%nn%>:<%ss%><|><%h%>:<%nn%>:<%ss%> <%AM/PM%><|><%d3%>, <%m3%> <%d%>, '<%yy%> <%h%>:<%nn%>:<%ss%> <%AM/PM%><|><%dddd%>, <%mmmm%> <%d%>, <%yyyy%> <%h%>:<%nn%>:<%ss%> <%AM/PM%>"

For instance the Label(exWeek) is "<|><%ww%><|><%m3%> <%d%>, '<%yy%><r><%ww%><|><%mmmm%> <%d%>, <%yyyy%><r><%ww%><||><||>256" which means that if a level's unit is set on exWeek it may display one of the following alternate labels:

• nothing, if the space is less than 6 pixels
•  <%ww%> - week number
• <%m3%> <%d%>, '<%yy%><r><%ww%> - month, day, year in short format where the week begins, including the week number on the right
•  <%mmmm%> <%d%>, <%yyyy%><r><%ww%> - month, day, year in long format where the week begins, including the week number on the right

So actually, the control will choose any of these formats based on the UnitWidth, Font and the layout of the levels.