Date Axis

Date Axis is a subtype of the value axis that displays date/time values. It is designed to be flexible about the range of dates/times that it can display -- anything from a few milliseconds to several centuries can be handled.

Although the axis displays dates for tick labels, at the lowest level it is still working with floating point numbers obtained from the plot's dataset. The values are interpreted as the number of milliseconds since 1 January 1970.

Additional properties of a date axis:

Property

Name

Type

Description

Tick Unit

dateTickUnit

Data Table

This option allows to configure tick units if Auto Tick Unit Selection is disabled. There are four fields:

  • Unit Type. Year, Month, Day, Hour, Minute, Second, or Millisecond.
  • Multiple. Unit multiple, i.e. the number of units between two adjacent tick marks.

Tick Unit Format Override

dateFormatOverride

String

A date/time formatting pattern for the tick labels on the axis.

Range

dateRange

Data Table

A manually set axis range. Specified as Lower Bound and Upper Bound timestamps. This setting is available if Auto Range is disabled.

Default Auto Range

defaultDateAutoRange

Data Table

An axis range to use if the dataset has no data. Specified as Lower Bound and Upper Bound timestamps.

Tick Mark Position

tickMarkPosition

String

Tick mark position: Start, Middle or End of the time period.

Time Zone

timeZone

String

Time zone for the axis, which affects the conversion of date values to string labels.

Was this page helpful?