Функция getBaseUnit

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

Импорт

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

Синтаксис

fun getBaseUnit(): TemporalUnit

Пример

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

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

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

String "Days"

Пример

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

val 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")
}

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

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

Пример

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

val 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}")

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

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

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

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