以下是 Kotlin 中常用时间类（基于 java.time 包）的核心方法及使用示例，参考数组方法的表格形式，按类分类展示：
一、LocalDate（日期：年/月/日）
| 方法签名 | 返回值 | 说明 | 示例 |
|---|---|---|---|
now(): LocalDate |
LocalDate |
获取当前日期 | LocalDate.now() → 2023-10-05 |
of(year: Int, month: Int, day: Int): LocalDate |
LocalDate |
创建指定日期 | LocalDate.of(2023, 10, 5) → 2023-10-05 |
of(year: Int, month: Month, day: Int): LocalDate |
LocalDate |
用Month枚举创建 | LocalDate.of(2023, Month.OCTOBER, 5) |
getYear(): Int |
Int |
获取年份 | LocalDate.now().getYear() → 2023 |
getMonth(): Month |
Month |
获取月份（枚举） | LocalDate.now().getMonth() → OCTOBER |
getMonthValue(): Int |
Int |
获取月份（数字1-12） | LocalDate.now().getMonthValue() → 10 |
getDayOfMonth(): Int |
Int |
获取当月第几天 | LocalDate.now().getDayOfMonth() → 5 |
getDayOfWeek(): DayOfWeek |
DayOfWeek |
获取星期几（枚举） | LocalDate.now().getDayOfWeek() → THURSDAY |
plusYears(years: Long): LocalDate |
LocalDate |
增加年份 | LocalDate.of(2023,10,5).plusYears(1) → 2024-10-05 |
plusMonths(months: Long): LocalDate |
LocalDate |
增加月份 | LocalDate.of(2023,10,5).plusMonths(1) → 2023-11-05 |
plusDays(days: Long): LocalDate |
LocalDate |
增加天数 | LocalDate.of(2023,10,5).plusDays(1) → 2023-10-06 |
minusYears(years: Long): LocalDate |
LocalDate |
减少年份 | LocalDate.of(2023,10,5).minusYears(1) → 2022-10-05 |
minusMonths(months: Long): LocalDate |
LocalDate |
减少月份 | LocalDate.of(2023,10,5).minusMonths(1) → 2023-09-05 |
minusDays(days: Long): LocalDate |
LocalDate |
减少天数 | LocalDate.of(2023,10,5).minusDays(1) → 2023-10-04 |
isAfter(other: LocalDate): Boolean |
Boolean |
是否在指定日期之后 | LocalDate.of(2023,10,6).isAfter(LocalDate.of(2023,10,5)) → true |
isBefore(other: LocalDate): Boolean |
Boolean |
是否在指定日期之前 | LocalDate.of(2023,10,4).isBefore(LocalDate.of(2023,10,5)) → true |
isEqual(other: LocalDate): Boolean |
Boolean |
是否与指定日期相等 | LocalDate.of(2023,10,5).isEqual(LocalDate.of(2023,10,5)) → true |
atTime(time: LocalTime): LocalDateTime |
LocalDateTime |
结合时间生成LocalDateTime | LocalDate.now().atTime(12,30) → 2023-10-05T12:30 |
parse(text: CharSequence): LocalDate |
LocalDate |
从字符串解析日期（默认格式yyyy-MM-dd） | LocalDate.parse("2023-10-05") → 2023-10-05 |
二、LocalTime（时间：时/分/秒）
| 方法签名 | 返回值 | 说明 | 示例 |
|---|---|---|---|
now(): LocalTime |
LocalTime |
获取当前时间 | LocalTime.now() → 15:30:45.123 |
of(hour: Int, minute: Int): LocalTime |
LocalTime |
创建指定时分 | LocalTime.of(12, 30) → 12:30 |
of(hour: Int, minute: Int, second: Int): LocalTime |
LocalTime |
创建指定时分秒 | LocalTime.of(12,30,45) → 12:30:45 |
getHour(): Int |
Int |
获取小时（0-23） | LocalTime.now().getHour() → 15 |
getMinute(): Int |
Int |
获取分钟（0-59） | LocalTime.now().getMinute() → 30 |
getSecond(): Int |
Int |
获取秒（0-59） | LocalTime.now().getSecond() → 45 |
getNano(): Int |
Int |
获取纳秒（0-999,999,999） | LocalTime.now().getNano() → 123456789 |
plusHours(hours: Long): LocalTime |
LocalTime |
增加小时 | LocalTime.of(12,30).plusHours(1) → 13:30 |
plusMinutes(minutes: Long): LocalTime |
LocalTime |
增加分钟 | LocalTime.of(12,30).plusMinutes(30) → 13:00 |
plusSeconds(seconds: Long): LocalTime |
LocalTime |
增加秒 | LocalTime.of(12,30).plusSeconds(60) → 12:31 |
minusHours(hours: Long): LocalTime |
LocalTime |
减少小时 | LocalTime.of(12,30).minusHours(1) → 11:30 |
minusMinutes(minutes: Long): LocalTime |
LocalTime |
减少分钟 | LocalTime.of(12,30).minusMinutes(30) → 12:00 |
isAfter(other: LocalTime): Boolean |
Boolean |
是否在指定时间之后 | LocalTime.of(13,0).isAfter(LocalTime.of(12,30)) → true |
isBefore(other: LocalTime): Boolean |
Boolean |
是否在指定时间之前 | LocalTime.of(12,0).isBefore(LocalTime.of(12,30)) → true |
atDate(date: LocalDate): LocalDateTime |
LocalDateTime |
结合日期生成LocalDateTime | LocalTime.now().atDate(LocalDate.now()) → 2023-10-05T15:30:45 |
parse(text: CharSequence): LocalTime |
LocalTime |
从字符串解析时间（默认格式HH:mm:ss） | LocalTime.parse("12:30:45") → 12:30:45 |
三、LocalDateTime（日期+时间）
| 方法签名 | 返回值 | 说明 | 示例 |
|---|---|---|---|
now(): LocalDateTime |
LocalDateTime |
获取当前日期时间 | LocalDateTime.now() → 2023-10-05T15:30:45 |
of(date: LocalDate, time: LocalTime): LocalDateTime |
LocalDateTime |
结合日期和时间 | LocalDateTime.of(LocalDate.now(), LocalTime.now()) |
of(year: Int, month: Int, day: Int, hour: Int, minute: Int): LocalDateTime |
LocalDateTime |
直接创建 | LocalDateTime.of(2023,10,5,12,30) → 2023-10-05T12:30 |
toLocalDate(): LocalDate |
LocalDate |
提取日期部分 | LocalDateTime.now().toLocalDate() → 2023-10-05 |
toLocalTime(): LocalTime |
LocalTime |
提取时间部分 | LocalDateTime.now().toLocalTime() → 15:30:45 |
plusYears(years: Long): LocalDateTime |
LocalDateTime |
增加年份 | LocalDateTime.now().plusYears(1) |
minusMonths(months: Long): LocalDateTime |
LocalDateTime |
减少月份 | LocalDateTime.now().minusMonths(1) |
isAfter(other: LocalDateTime): Boolean |
Boolean |
是否在指定日期时间之后 | LocalDateTime.now().isAfter(LocalDateTime.now().minusHours(1)) → true |
atZone(zone: ZoneId): ZonedDateTime |
ZonedDateTime |
转换为带时区的时间 | LocalDateTime.now().atZone(ZoneId.of("Asia/Shanghai")) |
四、ZonedDateTime（带时区的日期时间）
| 方法签名 | 返回值 | 说明 | 示例 |
|---|---|---|---|
now(zone: ZoneId): ZonedDateTime |
ZonedDateTime |
获取指定时区的当前时间 | ZonedDateTime.now(ZoneId.of("UTC")) |
now(): ZonedDateTime |
ZonedDateTime |
获取系统默认时区的当前时间 | ZonedDateTime.now() → 2023-10-05T15:30:45+08:00[Asia/Shanghai] |
getZone(): ZoneId |
ZoneId |
获取时区 | ZonedDateTime.now().getZone() → Asia/Shanghai |
withZoneSameInstant(zone: ZoneId): ZonedDateTime |
ZonedDateTime |
转换到另一个时区（时间点不变） | ZonedDateTime.now().withZoneSameInstant(ZoneId.of("UTC")) |
toLocalDateTime(): LocalDateTime |
LocalDateTime |
转换为本地日期时间（无时区） | ZonedDateTime.now().toLocalDateTime() |
toInstant(): Instant |
Instant |
转换为时间戳 | ZonedDateTime.now().toInstant() |
五、Instant（时间戳，UTC）
| 方法签名 | 返回值 | 说明 | 示例 |
|---|---|---|---|
now(): Instant |
Instant |
获取当前UTC时间戳 | Instant.now() → 2023-10-05T07:30:45.123Z |
toEpochMilli(): Long |
Long |
转换为毫秒级时间戳（1970年起） | Instant.now().toEpochMilli() → 1696507845123 |
plusMillis(millis: Long): Instant |
Instant |
增加毫秒 | Instant.now().plusMillis(1000) |
minusSeconds(seconds: Long): Instant |
Instant |
减少秒 | Instant.now().minusSeconds(60) |
atZone(zone: ZoneId): ZonedDateTime |
ZonedDateTime |
转换为指定时区的时间 | Instant.now().atZone(ZoneId.of("Asia/Shanghai")) |
六、Duration（时间间隔：时/分/秒）
| 方法签名 | 返回值 | 说明 | 示例 |
|---|---|---|---|
between(start: T, end: T): Duration |
Duration |
计算两个时间的间隔 | Duration.between(LocalTime.of(12,0), LocalTime.of(13,30)) → PT1H30M |
ofHours(hours: Long): Duration |
Duration |
创建指定小时的间隔 | Duration.ofHours(2) → PT2H |
plusMinutes(minutes: Long): Duration |
Duration |
增加分钟 | Duration.ofHours(1).plusMinutes(30) → PT1H30M |
toMinutes(): Long |
Long |
转换为总分钟数 | Duration.ofHours(1).toMinutes() → 60 |
isNegative(): Boolean |
Boolean |
是否为负间隔 | Duration.ofHours(-1).isNegative() → true |
七、Period（日期间隔：年/月/日）
| 方法签名 | 返回值 | 说明 | 示例 |
|---|---|---|---|
between(start: LocalDate, end: LocalDate): Period |
Period |
计算两个日期的间隔 | Period.between(LocalDate.of(2023,1,1), LocalDate.of(2023,10,5)) → P9M4D |
ofYears(years: Int): Period |
Period |
创建指定年数的间隔 | Period.ofYears(1) → P1Y |
plusMonths(months: Int): Period |
Period |
增加月数 | Period.ofYears(1).plusMonths(3) → P1Y3M |
getDays(): Int |
Int |
获取天数部分 | Period.between(LocalDate.of(2023,10,1), LocalDate.of(2023,10,5)).getDays() → 4 |
综合示例
kotlin
import java.time.*
import java.time.format.DateTimeFormatter
fun main() {
// 1. 获取当前日期并加1天
val tomorrow = LocalDate.now().plusDays(1)
println("明天: $tomorrow")
// 2. 解析字符串为日期并比较
val deadline = LocalDate.parse("2023-12-31")
println("是否过期: ${LocalDate.now().isAfter(deadline)}")
// 3. 计算两个时间的间隔
val start = LocalTime.of(9, 0)
val end = LocalTime.of(18, 30)
val workDuration = Duration.between(start, end)
println("工作时长(小时): ${workDuration.toHours()}")
// 4. 带时区的时间转换
val shanghaiTime = ZonedDateTime.now(ZoneId.of("Asia/Shanghai"))
val newYorkTime = shanghaiTime.withZoneSameInstant(ZoneId.of("America/New_York"))
println("上海时间: $shanghaiTime")
println("纽约时间: $newYorkTime")
// 5. 格式化输出
val formatter = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH:mm:ss")
val formatted = LocalDateTime.now().format(formatter)
println("格式化时间: $formatted")
}以上涵盖了 Kotlin 中处理时间的核心类及常用方法，实际开发中可根据需求选择合适的类（如仅处理日期用 LocalDate，带时区用 ZonedDateTime 等）。