Get or Set the Publication Year of a Dataset Object

Access or assign the optional publication_year attribute to a semantically rich dataset object.

Usage

publication_year(x)

publication_year(x, overwrite = TRUE) <- value

Arguments

x

A dataset object created by dataset_df() or dataset::as_dataset_df().

overwrite

Logical. If TRUE (default), the existing publication_year attribute is replaced with value. If FALSE, the function returns a message and does not overwrite the existing value.

value

A character string specifying the publication year.

Value

The publication_year attribute as a character string.

Details

The publication_year represents the year when the dataset was or will be made publicly available, in YYYY format. For additional context, see DataCite: Publication Year-Additional Guidance.

See also

Other bibliographic helper functions: contributor(), creator(), dataset_format(), dataset_title(), description(), geolocation(), get_bibentry(), language, publisher(), relation(), rights(), subject()

Examples

publication_year(orange_df)
#> [1] "1998"
publication_year(orange_df) <- "1998"