grTimeLevelMask (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing charts

grScatter3DDeleteAltitudeColor

gr3DSParameter

grAddData

grAddTimeData

grAutoRefreshCategoryLabel

grComparativeSeriesPosition

grDonutHolePercentage

grScatter3DAltitudeColor

grScatter3DDeleteMarkCaption

grScatter3DGridlines

grScatter3DLinkPoint

grScatter3DMarkCaption

grScatter3DProjection

grSeriesSecondaryAxis

grSeriesType

grSmoothing

grSourceCategoryLabel

grSunburstRootSection

grSunburstSectionColor

grSunburstStartAngle

grSurfaceAddData

grSurfaceAltitudeColor

grSurfaceDeleteAltitudeColor

grSurfaceDeleteMarkCaption

grSurfaceGetData

grSurfaceGridlines

grSurfaceMarksCaption

grWaterfallCategoryType

grWaterfallColor

grWndSize

grZoom

Combination of masks
Available masks

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

grTimeLevelMask (Function)

In french: grNiveauTemporelMasque

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

Example

// Displays the hours in 10h format
grTimeLevelMask(CHART_MyChart, grntHour, "HHh")

Syntax

grTimeLevelMask(<Chart name> , <Time level> , <Mask>)

<Chart name>: Character string (with or without quotes)

Name of chart to use. This name corresponds to:
the chart name defined by programming with grCreate.
the name of Chart control found in the window editor or page editor.
Only the Chart controls are available.

<Time level>: Integer constant

Time level onto which the mask will be fixed:
grntYear The mask will be used on the years.
grntHour The mask will be used on the hours.
grntDay The mask will be used on the days.
grntMillisecond The mask will be used on the milliseconds.
grntMinute The mask will be used on the minutes.
grntMonth The mask will be used on the months.
grntSecond The mask will be used on the seconds.

<Mask>: Character string (with quotes)

Mask to use.
Caution: The mask is applied to a single time level. 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:

// Displays the months in month + year format
grTimeLevelMask(CHART_MyChart, grntMonth, "Mmm YYYY")

Available masks

The available masks are as follows:

YYYY represent the year on 4 digits.
YY represent the date on 2 digits.
M represents the month (no zero is displayed in front of the month number).
MM represent the month on 2 digits.
MMM represent the month in letters on 3 characters (for example: jan). The case used depends on the linguistic options of project.
Mmm represent the month in letters on 3 characters with the first letter forced in uppercase (for example: Jan).
mmm represent the month in letters on 3 characters with the first letter forced in lowercase (for example: jan).
MMMM represent the full month in letters (for example: January). The case used depends on the linguistic options of project.
Mmmm represent the full month in letters with the first letter forced in uppercase (for example: January).
mmmm represent the full month in letters with the first letter forced in lowercase (for example: january).
D represents the day (no zero is displayed in front of the day number).
DD represent the day on 2 digits.
DDD represent the day in letters on 3 characters (for example: Mon). The case used depends on the linguistic options of project.
Ddd represent the day in letters on 3 characters with the first letter forced in uppercase (for example: Mon).
ddd represent the day in letters on 3 characters with the first letter forced in lowercase (for example: mon).
DDDD represent the full day in letters (for example: monday). The case used depends on the linguistic options of project.
Dddd represent the full day in letters with the first letter forced in uppercase (for example: Monday).
dddd represent the full day in letters with the first letter forced in lowercase (for example: monday).
M represents the first letter of the day (for example: M, T, W, T, F, S, S).
HH represent the number of hours.
mm represent the number of minutes.
SS represent the number of seconds.
CC represent the number of hundredths of a second.
AP represent "AM" or "PM" (if "AM" is found in the format, the time is displayed over 12 hours).

Component : wd250grf.dll