Dimnames of an xts Object

Get or set dimnames of an xts object.

Usage

# S3 method for class 'xts'
dimnames(x)

# S3 method for class 'xts'
dimnames(x) <- value

Arguments

x: An xts object.
value: A two element list. See Details.

Value

A list or character string containing coerced row names and/or actual column names.

Attempts to set rownames on xts objects via rownames or dimnames will silently fail.

Details

For efficienty, xts objects do not have rownames (unlike zoo objects). Attempts to set rownames on an xts object will silently set them to NULL. This is done for internal compatibility reasons, as well as to provide consistency in performance regardless of object use.

Note

Unlike zoo, all xts objects have dimensions. xts objects cannot be plain vectors.

Author

Jeffrey A. Ryan

Examples


x <- xts(1:10, Sys.Date()+1:10)
dimnames(x)
#> NULL
rownames(x)
#> NULL
rownames(x) <- 1:10
rownames(x)
#> NULL
str(x)
#> An xts object on 2026-03-06 / 2026-03-15 containing: 
#>   Data:    integer [10, 1]
#>   Index:   Date [10] (TZ: "UTC")