R ggplot2 scale_date 日期/时间数据的位置刻度

这些是三个日期/时间类的默认比例。这些通常会自动添加。要手动覆盖，请使用 scale_*_date 表示日期(类 Date )，使用 scale_*_datetime 表示日期时间(类 POSIXct )，使用 scale_*_time 表示时间(类 hms )。

用法

scale_x_date(
  name = waiver(),
  breaks = waiver(),
  date_breaks = waiver(),
  labels = waiver(),
  date_labels = waiver(),
  minor_breaks = waiver(),
  date_minor_breaks = waiver(),
  limits = NULL,
  expand = waiver(),
  oob = censor,
  guide = waiver(),
  position = "bottom",
  sec.axis = waiver()
)

scale_y_date(
  name = waiver(),
  breaks = waiver(),
  date_breaks = waiver(),
  labels = waiver(),
  date_labels = waiver(),
  minor_breaks = waiver(),
  date_minor_breaks = waiver(),
  limits = NULL,
  expand = waiver(),
  oob = censor,
  guide = waiver(),
  position = "left",
  sec.axis = waiver()
)

scale_x_datetime(
  name = waiver(),
  breaks = waiver(),
  date_breaks = waiver(),
  labels = waiver(),
  date_labels = waiver(),
  minor_breaks = waiver(),
  date_minor_breaks = waiver(),
  timezone = NULL,
  limits = NULL,
  expand = waiver(),
  oob = censor,
  guide = waiver(),
  position = "bottom",
  sec.axis = waiver()
)

scale_y_datetime(
  name = waiver(),
  breaks = waiver(),
  date_breaks = waiver(),
  labels = waiver(),
  date_labels = waiver(),
  minor_breaks = waiver(),
  date_minor_breaks = waiver(),
  timezone = NULL,
  limits = NULL,
  expand = waiver(),
  oob = censor,
  guide = waiver(),
  position = "left",
  sec.axis = waiver()
)

scale_x_time(
  name = waiver(),
  breaks = waiver(),
  minor_breaks = waiver(),
  labels = waiver(),
  limits = NULL,
  expand = waiver(),
  oob = censor,
  na.value = NA_real_,
  guide = waiver(),
  position = "bottom",
  sec.axis = waiver()
)

scale_y_time(
  name = waiver(),
  breaks = waiver(),
  minor_breaks = waiver(),
  labels = waiver(),
  limits = NULL,
  expand = waiver(),
  oob = censor,
  na.value = NA_real_,
  guide = waiver(),
  position = "left",
  sec.axis = waiver()
)

参数

name

秤的名称。用作轴或图例标题。如果 waiver() (默认值)，则比例名称取自用于该美学的第一个映射。如果是 NULL ，则图例标题将被省略。

breaks

之一：

NULL 不间断
waiver() 用于 date_breaks 指定的中断
给出中断位置的 Date /POSIXct 向量
将限制作为输入并返回中断作为输出的函数

date_breaks

给出中断之间距离的字符串，例如“2 周”或“10 年”。如果同时指定了breaks 和date_breaks，则date_breaks 获胜。有效规范为'sec', 'min', 'hour', 'day', 'week', 'month' 或'year'，可选地后跟's'。

labels

之一：

NULL 无标签
waiver() 用于由转换对象计算的默认标签
给出标签的字符向量(必须与 breaks 长度相同)
表达向量(必须与中断长度相同)。有关详细信息，请参阅？plotmath。
将中断作为输入并返回标签作为输出的函数。还接受 rlang lambda 函数表示法。

date_labels

给出标签格式规范的字符串。代码在 strftime() 中定义。如果同时指定了 labels 和 date_labels，则 date_labels 获胜。

minor_breaks

之一：

NULL 不间断
waiver() 用于 date_minor_breaks 指定的中断
给出小中断位置的 Date /POSIXct 向量
将限制作为输入并返回次要中断作为输出的函数

date_minor_breaks

给出小中断之间距离的字符串，例如“2 周”或“10 年”。如果同时指定了minor_breaks 和date_minor_breaks，则date_minor_breaks 获胜。有效规范为'sec', 'min', 'hour', 'day', 'week', 'month' 或'year'，可选地后跟's'。

limits

之一：

NULL 使用默认比例范围
长度为 2 的数值向量，提供尺度限制。使用NA来引用现有的最小值或最大值
接受现有(自动)限制并返回新限制的函数。还接受 rlang lambda 函数表示法。请注意，对位置比例设置限制将删除限制之外的数据。如果目的是缩放，请使用坐标系中的 limit 参数(请参阅 coord_cartesian() )。

expand

对于位置刻度，范围扩展常量的向量，用于在数据周围添加一些填充，以确保它们放置在距轴一定距离的位置。使用便捷函数expansion() 生成expand 参数的值。默认情况下，对于连续变量，每侧扩展 5%，对于离散变量，每侧扩展 0.6 个单位。

oob

之一：

处理超出范围限制(越界)的函数。还接受 rlang lambda 函数表示法。
默认值 ( scales::censor() ) 将超出范围的值替换为 NA 。
scales::squish() 用于将超出范围的值压缩到范围内。
scales::squish_infinite() 用于将无限值压缩到范围内。

guide

用于创建指南或其名称的函数。有关详细信息，请参阅guides()。

position

对于位置刻度，轴的位置。 left 或 right 表示 y 轴，top 或 bottom 表示 x 轴。

sec.axis

sec_axis() 用于指定辅助轴。

timezone

用于在轴上显示的时区。默认值 ( NULL ) 使用数据中编码的时区。

na.value

缺失值将替换为该值。

也可以看看

sec_axis() 了解如何指定辅助轴

其他位置刻度：scale_x_binned()、scale_x_continuous()、scale_x_discrete()

例子

last_month <- Sys.Date() - 0:29
set.seed(1)
df <- data.frame(
  date = last_month,
  price = runif(30)
)
base <- ggplot(df, aes(date, price)) +
  geom_line()

# The date scale will attempt to pick sensible defaults for
# major and minor tick marks. Override with date_breaks, date_labels
# date_minor_breaks arguments.
base + scale_x_date(date_labels = "%b %d")

base + scale_x_date(date_breaks = "1 week", date_labels = "%W")

base + scale_x_date(date_minor_breaks = "1 day")


# Set limits
base + scale_x_date(limits = c(Sys.Date() - 7, NA))
#> Warning: Removed 22 rows containing missing values (`geom_line()`).

源代码：R/scale-date.R

相关用法

注：本文由纯净天空筛选整理自Hadley Wickham等大神的英文原创作品 Position scales for date/time data。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。