Crosslink, and mention that these are not drop-in replacements

Author: DavisVaughan

R/date.R

@@ -135,11 +135,18 @@ as.Date.clock_zoned_time <- function(x, ...) {
 #' There are methods for converting date-times (POSIXct), calendars,
 #' time points, and zoned-times to dates.
 #'
+#' For converting to a date-time, see [as_date_time()].
+#'
 #' @details
 #' Note that clock always assumes that R's Date class is naive, so converting
 #' a POSIXct to a Date will always retain the printed year, month, and day
 #' value.
 #'
+#' This is not a drop-in replacement for `as.Date()`, as it only converts a
+#' limited set of types to Date. For parsing characters as dates, see
+#' [date_parse()]. For converting numerics to dates, see [vctrs::new_date()] or
+#' continue to use `as.Date()`.
+#'
 #' @param x `[vector]`
 #'
 #'   A vector.

R/posixt.R

@@ -167,6 +167,8 @@ as.POSIXlt.clock_zoned_time <- function(x, ...) {
 #' There are methods for converting dates (Date), calendars, time points, and
 #' zoned-times to date-times.
 #'
+#' For converting to a date, see [as_date()].
+#'
 #' @details
 #' Note that clock always assumes that R's Date class is naive, so converting
 #' a Date to a POSIXct will always attempt to retain the printed year, month,
@@ -175,6 +177,11 @@ as.POSIXlt.clock_zoned_time <- function(x, ...) {
 #' that issue ever arises, an error will be thrown, which can be resolved by
 #' explicitly supplying `nonexistent` or `ambiguous`.
 #'
+#' This is not a drop-in replacement for `as.POSIXct()`, as it only converts a
+#' limited set of types to POSIXct. For parsing characters as date-times, see
+#' [date_time_parse()]. For converting numerics to date-times, see
+#' [vctrs::new_datetime()] or continue to use `as.POSIXct()`.
+#'
 #' @inheritParams as-zoned-time-naive-time
 #'
 #' @param x `[vector]`