Функция getBaseUnit

Функция getBaseUnit интерфейса TemporalField возвращает базовую единицу измерения, которая используется для измерения значения временного поля. Базовая единица является неизменяемой и определяет тип единицы измерения (например, дни, часы, минуты).

Импорт

kotlinimport java.time.temporal.TemporalField
import java.time.temporal.ChronoField
import java.time.temporal.ChronoUnit

Синтаксис

kotlinfun getBaseUnit(): TemporalUnit

Пример

Получим базовую единицу измерения для поля ChronoField.DAY_OF_MONTH:

kotlinval field = ChronoField.DAY_OF_MONTH
val baseUnit = field.baseUnit
println(baseUnit)

Результат выполнения кода:

kotlinString "Days"

Пример

Получим базовые единицы измерения для различных временных полей:

kotlinval fields = listOf(
  ChronoField.HOUR_OF_DAY,
  ChronoField.MINUTE_OF_HOUR,
  ChronoField.SECOND_OF_MINUTE,
  ChronoField.MONTH_OF_YEAR,
  ChronoField.YEAR
)

for (field in fields) {
  val unit = field.baseUnit
  println("${field.name}: $unit")
}

Результат выполнения кода:

kotlinString "HOUR_OF_DAY: Hours"
String "MINUTE_OF_HOUR: Minutes"
String "SECOND_OF_MINUTE: Seconds"
String "MONTH_OF_YEAR: Months"
String "YEAR: Years"

Пример

Сравним базовые единицы измерения для полей времени и даты:

kotlinval timeField = ChronoField.HOUR_OF_DAY
val dateField = ChronoField.DAY_OF_MONTH

val timeUnit = timeField.baseUnit
val dateUnit = dateField.baseUnit

println("Time field unit: $timeUnit")
println("Date field unit: $dateUnit")
println("Units are equal: ${timeUnit == dateUnit}")

Результат выполнения кода:

kotlinString "Time field unit: Hours"
String "Date field unit: Days"
String "Units are equal: false"

Смотрите также

  • функцию getRangeUnit интерфейса TemporalField,
    которая возвращает единицу диапазона временного поля
  • функцию range интерфейса TemporalField,
    которая возвращает диапазон допустимых значений для поля
  • функцию isDateBased интерфейса TemporalField,
    которая проверяет, основано ли поле на дате
  • функцию isTimeBased интерфейса TemporalField,
    которая проверяет, основано ли поле на времени