ChengkaiYang2022 commented on code in PR #19964:
URL: https://github.com/apache/flink/pull/19964#discussion_r901187712
##########
docs/content.zh/docs/dev/table/types.md:
##########
@@ -686,55 +669,50 @@ TIME(p)
DataTypes.TIME(p)
```
-**Bridging to JVM Types**
+**JVM Types桥接**
-| Java Type | Input | Output | Remarks
|
-|:---------------------|:-----:|:------:|:----------------------------------------------------|
-|`java.time.LocalTime` | X | X | *Default*
|
-|`java.sql.Time` | X | X |
|
-|`java.lang.Integer` | X | X | Describes the number of milliseconds
of the day. |
-|`int` | X | (X) | Describes the number of milliseconds
of the day.<br>Output only if type is not nullable. |
-|`java.lang.Long` | X | X | Describes the number of nanoseconds
of the day. |
-|`long` | X | (X) | Describes the number of nanoseconds
of the day.<br>Output only if type is not nullable. |
+| Java Type | 输入 | 输出 | 备注
|
+|:---------------------|:-----:|:------:|:----------------------------------------------------------------------------------------|
+|`java.time.LocalTime` | X | X | *默认*
|
+|`java.sql.Time` | X | X |
|
+|`java.lang.Integer` | X | X | 描述一天中的毫秒数。
|
+|`int` | X | (X) | 描述一天中的毫秒数。<br>仅当类型不可为空时才输出。
|
+|`java.lang.Long` | X | X | 描述一天中的纳秒数。
|
+|`long` | X | (X) | 描述一天中的纳秒数。<br>仅当类型不可为空时才输出。 |
{{< /tab >}}
{{< tab "Python" >}}
```python
DataTypes.TIME(p)
```
-<span class="label label-danger">Attention</span> The `precision` specified in
`DataTypes.TIME(p)` must be `0` currently.
+<span class="label label-danger">请注意</span> 当前，`DataTypes.TIME(p)` 中指定的
`precision` 必须为 `0`。
{{< /tab >}}
{{< /tabs >}}
-The type can be declared using `TIME(p)` where `p` is the number of digits of
fractional
-seconds (*precision*). `p` must have a value between `0` and `9` (both
inclusive). If no
-precision is specified, `p` is equal to `0`.
+可以使用 `TIME(p)` 声明该类型，其中 `p` 是小数秒的位数（精度）。 p 的取值范围为[`0`,`9`]。 如果未指定精度，则 p 等于 0。
#### `TIMESTAMP`
-Data type of a timestamp *without* time zone consisting of `year-month-day
hour:minute:second[.fractional]`
-with up to nanosecond precision and values ranging from `0000-01-01
00:00:00.000000000` to
-`9999-12-31 23:59:59.999999999`.
+有时区的时间类型，由 `年-月-日 小时:分钟:秒[.fractional]`组成，具有高达纳秒的精度，范围从`0000-01-01
00:00:00.000000000`到 `9999-12-31 23:59:59.999999999`。
Review Comment:
how about 具有高达纳秒的精度 -> 可达到纳秒级别的精度 ?
##########
docs/content.zh/docs/dev/table/types.md:
##########
@@ -686,55 +669,50 @@ TIME(p)
DataTypes.TIME(p)
```
-**Bridging to JVM Types**
+**JVM Types桥接**
-| Java Type | Input | Output | Remarks
|
-|:---------------------|:-----:|:------:|:----------------------------------------------------|
-|`java.time.LocalTime` | X | X | *Default*
|
-|`java.sql.Time` | X | X |
|
-|`java.lang.Integer` | X | X | Describes the number of milliseconds
of the day. |
-|`int` | X | (X) | Describes the number of milliseconds
of the day.<br>Output only if type is not nullable. |
-|`java.lang.Long` | X | X | Describes the number of nanoseconds
of the day. |
-|`long` | X | (X) | Describes the number of nanoseconds
of the day.<br>Output only if type is not nullable. |
+| Java Type | 输入 | 输出 | 备注
|
+|:---------------------|:-----:|:------:|:----------------------------------------------------------------------------------------|
+|`java.time.LocalTime` | X | X | *默认*
|
+|`java.sql.Time` | X | X |
|
+|`java.lang.Integer` | X | X | 描述一天中的毫秒数。
|
+|`int` | X | (X) | 描述一天中的毫秒数。<br>仅当类型不可为空时才输出。
|
+|`java.lang.Long` | X | X | 描述一天中的纳秒数。
|
+|`long` | X | (X) | 描述一天中的纳秒数。<br>仅当类型不可为空时才输出。 |
{{< /tab >}}
{{< tab "Python" >}}
```python
DataTypes.TIME(p)
```
-<span class="label label-danger">Attention</span> The `precision` specified in
`DataTypes.TIME(p)` must be `0` currently.
+<span class="label label-danger">请注意</span> 当前，`DataTypes.TIME(p)` 中指定的
`precision` 必须为 `0`。
Review Comment:
precision? Maybe we should translate this term?
##########
docs/content.zh/docs/dev/table/types.md:
##########
@@ -826,42 +798,37 @@ Not supported.
{{< tabs "timestamps" >}}
{{< tab "SQL/Java/Scala" >}}
-The type can be declared using `TIMESTAMP(p) WITH TIME ZONE` where `p` is the
number of digits of
-fractional seconds (*precision*). `p` must have a value between `0` and `9`
(both inclusive). If no
-precision is specified, `p` is equal to `6`.
{{< /tab >}}
{{< tab "Python" >}}
{{< /tab >}}
{{< /tabs >}}
+可以使用 `TIMESTAMP(p) WITH TIME ZONE` 声明该类型，其中 `p` 是小数秒的位数（*精度*）。 `p`
取值范围为[`0`,`9`]。如果不指定精度，p 等于 6。
+
#### `TIMESTAMP_LTZ`
-Data type of a timestamp *with local* time zone consisting of `year-month-day
hour:minute:second[.fractional] zone`
-with up to nanosecond precision and values ranging from `0000-01-01
00:00:00.000000000 +14:59` to
-`9999-12-31 23:59:59.999999999 -14:59`.
+时间戳的数据类型 *带有本地*时区，格式为`年-月-日 时:分:秒[.fractional] zone` ，精度高达纳秒，值范围从 `0000-01-01
00:00:00.000000000 +14:59` 到 `9999-12-31 23:59:59.999999999 -14:59`。
Review Comment:
时间戳的数据类型 *带有本地*时区，格式为`年-月-日 时:分:秒[.fractional] zone`
->
*带有本地* 时区的时间戳数据类型 ，其格式为 `年-月-日 时:分:秒[.fractional] zone`
##########
docs/content.zh/docs/dev/table/types.md:
##########
@@ -826,42 +798,37 @@ Not supported.
{{< tabs "timestamps" >}}
{{< tab "SQL/Java/Scala" >}}
-The type can be declared using `TIMESTAMP(p) WITH TIME ZONE` where `p` is the
number of digits of
-fractional seconds (*precision*). `p` must have a value between `0` and `9`
(both inclusive). If no
-precision is specified, `p` is equal to `6`.
{{< /tab >}}
{{< tab "Python" >}}
{{< /tab >}}
{{< /tabs >}}
+可以使用 `TIMESTAMP(p) WITH TIME ZONE` 声明该类型，其中 `p` 是小数秒的位数（*精度*）。 `p`
取值范围为[`0`,`9`]。如果不指定精度，p 等于 6。
+
#### `TIMESTAMP_LTZ`
-Data type of a timestamp *with local* time zone consisting of `year-month-day
hour:minute:second[.fractional] zone`
-with up to nanosecond precision and values ranging from `0000-01-01
00:00:00.000000000 +14:59` to
-`9999-12-31 23:59:59.999999999 -14:59`.
+时间戳的数据类型 *带有本地*时区，格式为`年-月-日 时:分:秒[.fractional] zone` ，精度高达纳秒，值范围从 `0000-01-01
00:00:00.000000000 +14:59` 到 `9999-12-31 23:59:59.999999999 -14:59`。
{{< tabs "timestamps" >}}
{{< tab "SQL/Java/Scala" >}}
-Leap seconds (`23:59:60` and `23:59:61`) are not supported as the semantics
are closer to `java.time.OffsetDateTime`.
-Compared to `TIMESTAMP WITH TIME ZONE`, the time zone offset information is
not stored physically
-in every datum. Instead, the type assumes `java.time.Instant` semantics in UTC
time zone at
-the edges of the table ecosystem. Every datum is interpreted in the local time
zone configured in
-the current session for computation and visualization.
+不支持闰秒（`23:59:60` 和 `23:59:61`），其语义更接近 `java.time.OffsetDateTime`。
+
+与`TIMESTAMP WITH TIME ZONE`相比，时区偏移信息没有物理存储在每个数据中。 相反，该类型在 UTC 时区假定为
`java.time.Instant`的语义处于 Table生态系统的边缘。
+每个数据都在配置的本地时区中解释 当前会话用于计算和可视化。
Review Comment:
每个数据都在配置的本地时区中解释 当前会话用于计算和可视化。
This line is a little confusing and people who read it may find it hard to
understand, could you be more specific?
##########
docs/content.zh/docs/dev/table/types.md:
##########
@@ -657,22 +640,22 @@ DataTypes.DATE()
#### `TIME`
-Data type of a time *without* time zone consisting of
`hour:minute:second[.fractional]` with
-up to nanosecond precision and values ranging from `00:00:00.000000000` to
-`23:59:59.999999999`.
+无时区的时间类型，包括 `小时:分钟:秒[.fractional]`，精度可达纳秒，取值范围为` 00:00:00.000000000` 到
`23:59:59.999999999`。
+
{{< tabs "time" >}}
{{< tab "SQL/Java/Scala" >}}
-Compared to the SQL standard, leap seconds (`23:59:60` and `23:59:61`) are not
supported as
-the semantics are closer to `java.time.LocalTime`. A time *with* time zone is
not provided.
+与SQL标准相比，不支持leap秒（23:59:60和23:59:61），因为语义更接近java.time.LocalTime。没有提供带时区的时间。
Review Comment:
leap?
##########
docs/content.zh/docs/dev/table/types.md:
##########
@@ -826,42 +798,37 @@ Not supported.
{{< tabs "timestamps" >}}
{{< tab "SQL/Java/Scala" >}}
-The type can be declared using `TIMESTAMP(p) WITH TIME ZONE` where `p` is the
number of digits of
-fractional seconds (*precision*). `p` must have a value between `0` and `9`
(both inclusive). If no
-precision is specified, `p` is equal to `6`.
{{< /tab >}}
{{< tab "Python" >}}
{{< /tab >}}
{{< /tabs >}}
+可以使用 `TIMESTAMP(p) WITH TIME ZONE` 声明该类型，其中 `p` 是小数秒的位数（*精度*）。 `p`
取值范围为[`0`,`9`]。如果不指定精度，p 等于 6。
Review Comment:
小数秒？
##########
docs/content.zh/docs/dev/table/types.md:
##########
@@ -809,12 +781,12 @@ TIMESTAMP(p) WITH TIME ZONE
DataTypes.TIMESTAMP_WITH_TIME_ZONE(p)
```
-**Bridging to JVM Types**
+**JVM Types桥接**
-| Java Type | Input | Output | Remarks |
-|:--------------------------|:-----:|:------:|:---------------------|
-|`java.time.OffsetDateTime` | X | X | *Default* |
-|`java.time.ZonedDateTime` | X | | Ignores the zone ID. |
+| Java Type | 输入 | 输出 | 备注 |
+|:--------------------------|:-----:|:------:|:--------|
+|`java.time.OffsetDateTime` | X | X | *默认* |
+|`java.time.ZonedDateTime` | X | | 忽略时区ID. |
Review Comment:
. -> 。
##########
docs/content.zh/docs/dev/table/types.md:
##########
@@ -826,42 +798,37 @@ Not supported.
{{< tabs "timestamps" >}}
{{< tab "SQL/Java/Scala" >}}
-The type can be declared using `TIMESTAMP(p) WITH TIME ZONE` where `p` is the
number of digits of
-fractional seconds (*precision*). `p` must have a value between `0` and `9`
(both inclusive). If no
-precision is specified, `p` is equal to `6`.
{{< /tab >}}
{{< tab "Python" >}}
{{< /tab >}}
{{< /tabs >}}
+可以使用 `TIMESTAMP(p) WITH TIME ZONE` 声明该类型，其中 `p` 是小数秒的位数（*精度*）。 `p`
取值范围为[`0`,`9`]。如果不指定精度，p 等于 6。
+
#### `TIMESTAMP_LTZ`
-Data type of a timestamp *with local* time zone consisting of `year-month-day
hour:minute:second[.fractional] zone`
-with up to nanosecond precision and values ranging from `0000-01-01
00:00:00.000000000 +14:59` to
-`9999-12-31 23:59:59.999999999 -14:59`.
+时间戳的数据类型 *带有本地*时区，格式为`年-月-日 时:分:秒[.fractional] zone` ，精度高达纳秒，值范围从 `0000-01-01
00:00:00.000000000 +14:59` 到 `9999-12-31 23:59:59.999999999 -14:59`。
{{< tabs "timestamps" >}}
{{< tab "SQL/Java/Scala" >}}
-Leap seconds (`23:59:60` and `23:59:61`) are not supported as the semantics
are closer to `java.time.OffsetDateTime`.
-Compared to `TIMESTAMP WITH TIME ZONE`, the time zone offset information is
not stored physically
-in every datum. Instead, the type assumes `java.time.Instant` semantics in UTC
time zone at
-the edges of the table ecosystem. Every datum is interpreted in the local time
zone configured in
-the current session for computation and visualization.
+不支持闰秒（`23:59:60` 和 `23:59:61`），其语义更接近 `java.time.OffsetDateTime`。
+
+与`TIMESTAMP WITH TIME ZONE`相比，时区偏移信息没有物理存储在每个数据中。 相反，该类型在 UTC 时区假定为
`java.time.Instant`的语义处于 Table生态系统的边缘。
+每个数据都在配置的本地时区中解释 当前会话用于计算和可视化。
+
{{< /tab >}}
{{< tab "Python" >}}
-Leap seconds (`23:59:60` and `23:59:61`) are not supported.
-Compared to `TIMESTAMP WITH TIME ZONE`, the time zone offset information is
not stored physically
-in every datum.
-Every datum is interpreted in the local time zone configured in the current
session for computation and visualization.
+不支持闰秒（`23:59:60` 和 `23:59:61`）。
+与`TIMESTAMP WITH TIME ZONE`相比，时区偏移信息没有物理存储
在每个数据中。每个数据都在当前会话中配置的本地时区进行解释，以进行计算和可视化。
Review Comment:
时区偏移信息没有物理存储 在每个数据中。
->
时区偏移信息没有物理存储在每条数据中。
##########
docs/content.zh/docs/dev/table/types.md:
##########
@@ -1095,22 +1049,17 @@ DataTypes.ARRAY(t)
{{< /tab >}}
{{< /tabs >}}
-The type can be declared using `ARRAY<t>` where `t` is the data type of the
contained
-elements.
-`t ARRAY` is a synonym for being closer to the SQL standard. For example, `INT
ARRAY` is
-equivalent to `ARRAY<INT>`.
+可以使用 `ARRAY<t>` 声明类型，其中 `t` 是包含的数据类型元素。
Review Comment:
其中 `t` 是包含的数据类型元素。
->
`t` 是其中元素的数据类型。
##########
docs/content.zh/docs/dev/table/types.md:
##########
@@ -1095,22 +1049,17 @@ DataTypes.ARRAY(t)
{{< /tab >}}
{{< /tabs >}}
-The type can be declared using `ARRAY<t>` where `t` is the data type of the
contained
-elements.
-`t ARRAY` is a synonym for being closer to the SQL standard. For example, `INT
ARRAY` is
-equivalent to `ARRAY<INT>`.
+可以使用 `ARRAY<t>` 声明类型，其中 `t` 是包含的数据类型元素。
+`t ARRAY` 是更接近 SQL 标准的同义词。 例如，`INT ARRAY` 是相当于`ARRAY<INT>`。
Review Comment:
`t ARRAY` 是更接近 SQL 标准的同义词。 例如，`INT ARRAY` 是相当于`ARRAY<INT>`。
->
为了更接近 SQL 标准，也可以使用 `t ARRAY` 的写法表达，比如，`INT ARRAY` 等同于 `ARRAY<INT>`。
##########
docs/content.zh/docs/dev/table/types.md:
##########
@@ -751,51 +729,45 @@ TIMESTAMP(p) WITHOUT TIME ZONE
DataTypes.TIMESTAMP(p)
```
-**Bridging to JVM Types**
+**JVM Types桥接**
-| Java Type | Input | Output | Remarks
|
+| Java Type | 输入 | 输出 | 备注 |
|:-------------------------------------------|:-----:|:------:|:-------------------------|
-|`java.time.LocalDateTime` | X | X | *Default*
|
+|`java.time.LocalDateTime` | X | X | *默认*
|
|`java.sql.Timestamp` | X | X |
|
-|`org.apache.flink.table.data.TimestampData` | X | X | Internal data
structure. |
+|`org.apache.flink.table.data.TimestampData` | X | X | 内部数据结构。 |
{{< /tab >}}
{{< tab "Python" >}}
```python
DataTypes.TIMESTAMP(p)
```
-<span class="label label-danger">Attention</span> The `precision` specified in
`DataTypes.TIMESTAMP(p)` must be `3` currently.
+<span class="label label-danger">请注意</span> 当前，`DataTypes.TIMESTAMP(p)` 中指定的
`precision` 必须为 `3`。
{{< /tab >}}
{{< /tabs >}}
-The type can be declared using `TIMESTAMP(p)` where `p` is the number of
digits of fractional
-seconds (*precision*). `p` must have a value between `0` and `9` (both
inclusive). If no precision
-is specified, `p` is equal to `6`.
+可以使用 `TIMESTAMP(p)` 声明该类型，其中 `p` 是小数秒的位数（*精度*）。 `p` 的取值范围为[`0`,`9`]。如果没有指定精度，p
等于 6。
-`TIMESTAMP(p) WITHOUT TIME ZONE` is a synonym for this type.
+`TIMESTAMP(p) WITHOUT TIME ZONE` 是这种类型的同义词。
#### `TIMESTAMP WITH TIME ZONE`
-Data type of a timestamp *with* time zone consisting of `year-month-day
hour:minute:second[.fractional] zone`
-with up to nanosecond precision and values ranging from `0000-01-01
00:00:00.000000000 +14:59` to
-`9999-12-31 23:59:59.999999999 -14:59`.
+包含时区的时间戳的数据类型，格式为 `年-月-日 时：分：秒[.fractional]`，精度可达纳秒，取值范围为 `0000-01-01
00:00:00.000000000 +14:59` 至 `9999 -12-31 23:59:59.999999999 -14:59`。
{{< tabs "timestamps" >}}
{{< tab "SQL/Java/Scala" >}}
-Compared to the SQL standard, leap seconds (`23:59:60` and `23:59:61`) are not
supported as the semantics
-are closer to `java.time.OffsetDateTime`.
+与 SQL 标准相比，不支持闰秒（`23:59:60` 和 `23:59:61`），其语义更接近`java.time.OffsetDateTime`。
{{< /tab >}}
{{< tab "Python" >}}
-Compared to the SQL standard, leap seconds (`23:59:60` and `23:59:61`) are not
supported.
+与 SQL 标准相比，不支持闰秒（`23:59:60` 和 `23:59:61`）。
{{< /tab >}}
{{< /tabs >}}
-Compared to `TIMESTAMP_LTZ`, the time zone offset information is physically
-stored in every datum. It is used individually for every computation,
visualization, or communication
-to external systems.
+与 `TIMESTAMP_LTZ` 相比，时区偏移信息物理存储在每个数据中。 它单独用于每次计算、可视化或与外部系统的通信。
Review Comment:
与 `TIMESTAMP_LTZ` 相比，时区偏移信息物理存储在每条数据中，便于每一次计算、数据显示、与外部系统进行通信。
##########
docs/content.zh/docs/dev/table/types.md:
##########
@@ -686,55 +669,50 @@ TIME(p)
DataTypes.TIME(p)
```
-**Bridging to JVM Types**
+**JVM Types桥接**
-| Java Type | Input | Output | Remarks
|
-|:---------------------|:-----:|:------:|:----------------------------------------------------|
-|`java.time.LocalTime` | X | X | *Default*
|
-|`java.sql.Time` | X | X |
|
-|`java.lang.Integer` | X | X | Describes the number of milliseconds
of the day. |
-|`int` | X | (X) | Describes the number of milliseconds
of the day.<br>Output only if type is not nullable. |
-|`java.lang.Long` | X | X | Describes the number of nanoseconds
of the day. |
-|`long` | X | (X) | Describes the number of nanoseconds
of the day.<br>Output only if type is not nullable. |
+| Java Type | 输入 | 输出 | 备注
|
+|:---------------------|:-----:|:------:|:----------------------------------------------------------------------------------------|
+|`java.time.LocalTime` | X | X | *默认*
|
+|`java.sql.Time` | X | X |
|
+|`java.lang.Integer` | X | X | 描述一天中的毫秒数。
|
+|`int` | X | (X) | 描述一天中的毫秒数。<br>仅当类型不可为空时才输出。
|
+|`java.lang.Long` | X | X | 描述一天中的纳秒数。
|
+|`long` | X | (X) | 描述一天中的纳秒数。<br>仅当类型不可为空时才输出。 |
{{< /tab >}}
{{< tab "Python" >}}
```python
DataTypes.TIME(p)
```
-<span class="label label-danger">Attention</span> The `precision` specified in
`DataTypes.TIME(p)` must be `0` currently.
+<span class="label label-danger">请注意</span> 当前，`DataTypes.TIME(p)` 中指定的
`precision` 必须为 `0`。
{{< /tab >}}
{{< /tabs >}}
-The type can be declared using `TIME(p)` where `p` is the number of digits of
fractional
-seconds (*precision*). `p` must have a value between `0` and `9` (both
inclusive). If no
-precision is specified, `p` is equal to `0`.
+可以使用 `TIME(p)` 声明该类型，其中 `p` 是小数秒的位数（精度）。 p 的取值范围为[`0`,`9`]。 如果未指定精度，则 p 等于 0。
#### `TIMESTAMP`
-Data type of a timestamp *without* time zone consisting of `year-month-day
hour:minute:second[.fractional]`
-with up to nanosecond precision and values ranging from `0000-01-01
00:00:00.000000000` to
-`9999-12-31 23:59:59.999999999`.
+有时区的时间类型，由 `年-月-日 小时:分钟:秒[.fractional]`组成，具有高达纳秒的精度，范围从`0000-01-01
00:00:00.000000000`到 `9999-12-31 23:59:59.999999999`。
{{< tabs "timestamps" >}}
{{< tab "SQL/Java/Scala" >}}
-Compared to the SQL standard, leap seconds (`23:59:60` and `23:59:61`) are not
supported as
-the semantics are closer to `java.time.LocalDateTime`.
+与 SQL 标准相比，不支持闰秒（`23:59:60` 和 `23:59:61`）这种语义更接近`java.time.LocalDateTime`。
+
+不支持从和到 `BIGINT`（JVM `long` 类型）的转换，因为这将暗示时区。 但是，这种类型是无时区限制。
有关更多类似“java.time.Instant”的语义，请使用`TIMESTAMP_LTZ`。
Review Comment:
从和到?Is there something missing here? It doesn't feel very fluent and seems a
little confusing.
##########
docs/content.zh/docs/dev/table/types.md:
##########
@@ -657,22 +640,22 @@ DataTypes.DATE()
#### `TIME`
-Data type of a time *without* time zone consisting of
`hour:minute:second[.fractional]` with
-up to nanosecond precision and values ranging from `00:00:00.000000000` to
-`23:59:59.999999999`.
+无时区的时间类型，包括 `小时:分钟:秒[.fractional]`，精度可达纳秒，取值范围为` 00:00:00.000000000` 到
`23:59:59.999999999`。
Review Comment:
Missing fractional?
##########
docs/content.zh/docs/dev/table/types.md:
##########
@@ -898,33 +865,26 @@ DataTypes.TIMESTAMP_LTZ(p)
DataTypes.TIMESTAMP_WITH_LOCAL_TIME_ZONE(p)
```
-<span class="label label-danger">Attention</span> The `precision` specified in
`DataTypes.TIMESTAMP_LTZ(p)` must be `3` currently.
+<span class="label label-danger">请注意</span> 当前，`DataTypes.TIMESTAMP_LTZ(p)`
中指定的 `precision` 必须为 `3`。
Review Comment:
precision -> 精度
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscr...@flink.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
