# 时间戳 Timestamp

> For the complete documentation index, see [llms.txt](https://simbot.forte.love/v4/llms.txt).

> **TL;DR**
> 针对“时间戳”的简单值包装类型, 以屏蔽时间戳不同单位带来的影响。
>
>
>
> 不是一种日期API, 而是类似于时间单位的转化。
>
>
>
> 平台： 多平台实现

## 创建

你可以使用 `Timestamp.now()` 获取当前的 Unix 时间戳值, 或使用 `Timestamp.ofMilliseconds(...)` 基于毫秒值获取一个结果。

Kotlin:

```KOTLIN
val now = Timestamp.now()
val time = Timestamp.ofMilliseconds(123456L)
```

> **Warning:**
> 非 JVM 平台（尤其是 native 平台）的 `Timestamp.now` 尚在实验中, 可能不稳定、或产生预期外的行为和结果。

Java:

```JAVA
var now = Timestamp.now();
var time = Timestamp.ofMilliseconds(123456L);
```

## 使用

`Timestamp` 通常用于获取各种单位下的时间戳数值结果。 它是对“时间戳值”的统一包装，不负责日期格式化、时区转换或字符串解析。

Kotlin:

```KOTLIN
val milliseconds = timestamp.milliseconds
val seconds = timestamp.timeAs(TimeUnit.SECONDS)
```

Java:

```JAVA
long milliseconds = timestamp.getMilliseconds();
long seconds = timestamp.timeAs(TimeUnit.SECONDS);
```

> **Note:**
> 如果你需要的是日期时间格式化、时区换算等能力， 请在具体平台上配合对应日期 API 使用， 例如 JVM 上的 `java.time`。