<Chart>.TimeLevelMask (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Chart functions

Combination of masks
Available masks

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Chart>.TimeLevelMask (Function)

In french: <Graphe>.NiveauTemporelMasque

Defines the display mask for a level of the time scale in a chart.

Note: This function can be used in conjunction with <Chart>.TimeLevelMax to define the number of levels to be displayed in the time scale of a graph.

Example

// Displays the hours in 10h format
CHART_MyChart.TimeLevelMask(grtlHour, "HHh")

// Définition de l'échelle temporelle pour afficher plusieurs valeur par mois
// mais en affichant uniquement les mois dans l'échelle 
// (les jours ne sont pas affichés)
GRF_MonGraphe.NiveauTemporelMasque(grtlMonth, "Mmm")
GRF_MonGraphe.NiveauTemporelMax(1, grtlMonth)

Syntax

<Chart control>.TimeLevelMask(<Time level> , <Mask>)

<Chart control>: Control name

Name of the Chart control to use (in the window or page editor).

<Time level>: Integer constant

Time level onto which the mask will be fixed:
grtlDay The mask will be used on the days.
grtlHour The mask will be used on the hours.
grtlMillisecond The mask will be used on the milliseconds.
grtlMinute The mask will be used on the minutes.
grtlMonth The mask will be used on the months.
grtlSecond The mask will be used on the seconds.
grtlYear The mask will be used on the years.

<Mask>: Character string

Mask to use.
Please note: The mask applies to a single time level only.. Therefore, we advise you to specify it by using the data of this level only (for example, "HH" for the hour level or "YYYY" for the year level).

Remarks

Combination of masks

The masks can be combined in order to use a specific format. For example:

// Affiche les mois sous la forme mois + année
GRF_MonGraphe.NiveauTemporelMasque(grtlMonth, "Mmm AAAA")

Available masks

The available masks are as follows:

YYYY represents a 4-digit year.
YY represents a 2-digit date.
M represents the month without a leading zero.
MM represents a 2-digit month.
MMM represents a 3-letter month (e.g., Jan). The case used depends on the language options of the project.
Mmm represents a 3-letter month with the first letter in uppercase (e.g., Jan).
mmm represents a 3-letter month with the first letter in lowercase (e.g., jan).
MMMM represents the month as a full name (e.g., January). The case used depends on the language options of the project.
Mmmm represents the month as a full name with the first letter in uppercase (e.g., January).
mmmm represents the month as a full name with the first letter in lowercase (e.g., january).
D represents the day (the zero is not displayed in front of the day number).
DD represents a 2-digit day.
DDD represents a 3-letter day (e.g., Mon). The case used depends on the language options of the project.
Ddd represents a 3-letter day with the first letter in uppercase (e.g., Mon).
ddd represents a 3-letter day with the first letter in lowercase (e.g., mon).
DDDD represents the day as a full name (e.g., Monday). The case used depends on the language options of the project.
Dddd represents the day as a full name with the first letter in uppercase (e.g., Monday).
dddd represents the day as a full name with the first letter in lowercase (e.g., monday).
M represents the first letter of the day (e.g., M,T,W,T,F,S,S).
HH represents the number of hours.
mm represents the number of minutes.
SS represents the number of seconds.
CC represents the number of hundredths of a second.
AP represents "AM" or "PM" (if "AP" is used, the time is displayed in 12-hour format).

Component: wd300grf.dll