relativeTo

abstract val relativeTo: Any?(source)

The starting point to use when variable-length units (years, months, weeks depending on the calendar) are involved. This option is required if either of the durations has a nonzero value for weeks or larger units.

This value must be either a Temporal.PlainDateTime, a Temporal.ZonedDateTime, or a string or object value that can be passed to from() of those types. Examples:

  • '2020-01'01T00:00-08:00[America/Los_Angeles]'

  • '2020-01'01'

  • Temporal.PlainDate.from('2020-01-01')

Temporal.ZonedDateTime will be tried first because it's more specific, with Temporal.PlainDateTime as a fallback.

If the value resolves to a Temporal.ZonedDateTime, then operation will adjust for DST and other time zone transitions. Otherwise (including if this option is omitted), then the operation will ignore time zone transitions and all days will be assumed to be 24 hours long.