dateaxis (Financial Toolbox)

Convert serial-date axis labels to calendar-date axis labels

Syntax

```
dateaxis(Aksis, DateForm, StartDate)
```

Arguments

Aksis
(Optional) Determines which axis tick labels--x, y, or z--to replace. Enter as a string. Default = 'x'.

DateForm
(Optional) Specifies which date format to use. Enter as an integer from 0 to 17. If no DateForm argument is entered, this function determines the date format based on the span of the axis limits. For example, if the difference between the axis minimum and maximum is less than 15, the tick labels are converted to three-letter day-of-the-week abbreviations (DateForm = 8). See DateForm format descriptions below.

StartDate
(Optional) Assigns the date to the first axis tick value. Enter as a string. The tick values are treated as serial date numbers. The default StartDate is the lower axis limit converted to the appropriate date number. For example, a tick value of 1 is converted to the date 01-Jan-0000. Entering StartDate as '06-apr-1999' assigns the date April 6, 1999 to the first tick value and the axis tick labels are set accordingly.

`Aksis`	(Optional) Determines which axis tick labels--x, y, or z--to replace. Enter as a string. Default `=` `'x'`.
`DateForm`	(Optional) Specifies which date format to use. Enter as an integer from 0 to 17. If no `DateForm` argument is entered, this function determines the date format based on the span of the axis limits. For example, if the difference between the axis minimum and maximum is less than 15, the tick labels are converted to three-letter day-of-the-week abbreviations (`DateForm = 8`). See DateForm format descriptions below.
`StartDate`	(Optional) Assigns the date to the first axis tick value. Enter as a string. The tick values are treated as serial date numbers. The default `StartDate` is the lower axis limit converted to the appropriate date number. For example, a tick value of 1 is converted to the date 01-Jan-0000. Entering `StartDate` as `'06-apr-1999'` assigns the date April 6, 1999 to the first tick value and the axis tick labels are set accordingly.

Description

dateaxis(Aksis, DateForm, StartDate) replaces axis tick labels with date labels on a graphic figure.

See the MATLAB set command for information on modifying the axis tick values and other axis parameters.

DateForm
Format
Description

0
01-Mar-1999 15:45:17
day-month-year hour:minute:second

1
01-mar-1999
day-month-year

2
03/01/99
month/day/year

3
Mar
month, three letters

4
M
month, single letter

5
3
month

6
03/01
month/day

7
1
day of month

8
Wed
day of week, three letters

9
W
day of week, single letter

10
1999
year, four digits

11
99
year, two digits

12
Mar99
month year

13
15:45:17
hour:minute:second

14
03:45:17 PM
hour:minute:second AM or PM

15
15:45
hour:minute

16
03:45 PM
hour:minute AM or PM

17
95/03/01
year month day

DateForm	Format	Description
`0`	`01-Mar-1999 15:45:17`	day-month-year hour:minute:second
`1`	`01-mar-1999`	day-month-year
`2`	`03/01/99`	month/day/year
`3`	`Mar`	month, three letters
`4`	`M`	month, single letter
`5`	`3`	month
`6`	`03/01`	month/day
`7`	`1`	day of month
`8`	`Wed`	day of week, three letters
`9`	`W`	day of week, single letter
`10`	`1999`	year, four digits
`11`	`99`	year, two digits
`12`	`Mar99`	month year
`13`	`15:45:17`	hour:minute:second
`14`	`03:45:17 PM`	hour:minute:second AM or PM
`15`	`15:45`	hour:minute
`16`	`03:45 PM`	hour:minute AM or PM
17	`95/03/01`	year month day

Examples

```
dateaxis('x') or dateaxis
```

converts the x-axis labels to an automatically determined date format.

```
dateaxis('y', 6)
```

converts the y-axis labels to the month/day format.

```
dateaxis('x', 2, '03/03/1999')
```

converts the x-axis labels to the month/day/year format. The minimum x-tick value is treated as March 3, 1999.

See Also

bolling, candle, datenum, datestr, highlow, movavg, pointfig

cur2str datedisp