Export datetime_scale() (#5174)

* Export `datetime_scale()`

* Reoxygenate

Author: teunbrand

DESCRIPTION

@@ -80,7 +80,7 @@ Config/testthat/edition: 3
 Encoding: UTF-8
 LazyData: true
 Roxygen: list(markdown = TRUE)
-RoxygenNote: 7.2.1
+RoxygenNote: 7.2.3
 Collate: 
     'ggproto.r'
     'ggplot-global.R'

NAMESPACE

@@ -316,6 +316,7 @@ export(coord_trans)
 export(cut_interval)
 export(cut_number)
 export(cut_width)
+export(datetime_scale)
 export(derive)
 export(discrete_scale)
 export(draw_key_abline)

NEWS.md

@@ -1,5 +1,7 @@
 # ggplot2 (development version)
 
+* The `datetime_scale()` scale constructor is now exported for use in extension
+  packages (@teunbrand, #4701).
 * `geom_text()` drops observations where `angle = NA` instead of throwing an
   error (@teunbrand, #2757).
 * Using two ordered factors as facetting variables in 

R/scale-date.r

@@ -275,7 +275,16 @@ scale_y_time <- function(name = waiver(),
   )
 }
 
-## rename to datetime_scale
+#' Date/time scale constructor
+#'
+#' @inheritParams scale_x_datetime
+#' @inheritParams continuous_scale
+#' @param trans For date/time scales, the name of a date/time transformation or
+#'   the object itself. Built-in transformations include "hms", "date" and "time".
+#' @inheritDotParams continuous_scale -aesthetics -trans -palette -breaks -minor_breaks -labels -guide
+#'
+#' @export
+#' @keywords internal
 datetime_scale <- function(aesthetics, trans, palette,
                            breaks = pretty_breaks(), minor_breaks = waiver(),
                            labels = waiver(), date_breaks = waiver(),