From 3e82cd6c66f7861dc604c1a61174d0b9648ace03 Mon Sep 17 00:00:00 2001 From: "mark.zhu" Date: Fri, 28 Apr 2023 22:07:32 +0800 Subject: [PATCH] =?UTF-8?q?docs=20(utime):=20EC200A=E5=B9=B3=E5=8F=B0?= =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E5=A2=9E=E5=BC=BA=E5=9E=8B=E6=97=B6=E5=8C=BA?= =?UTF-8?q?=E8=AE=BE=E7=BD=AE=E3=80=81=E8=AF=BB=E5=8F=96=E6=8E=A5=E5=8F=A3?= =?UTF-8?q?=E7=9A=84=E4=BB=8B=E7=BB=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit EC200A平台添加增强型时区设置、读取接口的介绍,本接口拥有更高的精度,支持最小到0.25h的时区设置和读取。 固件版本: EC200A R01_Helios分支全型号 是否需要文案翻译: 是 --- .../utime.md" | 32 +++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git "a/docs/API_reference/zh/QuecPython\346\240\207\345\207\206\345\272\223/utime.md" "b/docs/API_reference/zh/QuecPython\346\240\207\345\207\206\345\272\223/utime.md" index 5bc3df48..16bcd35f 100644 --- "a/docs/API_reference/zh/QuecPython\346\240\207\345\207\206\345\272\223/utime.md" +++ "b/docs/API_reference/zh/QuecPython\346\240\207\345\207\206\345\272\223/utime.md" @@ -135,6 +135,38 @@ utime.setTimeZone(offset) - int类型,成功返回0,失败抛异常。 +### `utime.getTimeZoneEx` + +```python +utime.getTimeZoneEx() +``` + +获取当前时区(增强型),精度更高,可获取非整数时区。 + +**返回值描述:** + +- float类型,单位小时,范围[-12.0, 12.0],负值表示西时区,正值表示东时区,0.0表示零时区。 + +> 增强型时区读取/设置接口须成对使用,如使用原有的时区接口读取非整数时区,会造成精度丢失。当前仅 EC200A 系列支持该功能。 + +### `utime.setTimeZoneEx` + +```python +utime.setTimeZoneEx(offset) +``` + +设置时区(增强型),精度更高,可设置非整数时区。设置时区后,本地时间会随之变化为对应时区的时间。 + +**参数描述:** + +- float类型,单位小时,范围[-12.0, 12.0],最大精度为0.25小时(即参数须为0.25的整数倍)负值表示西时区,正值表示东时区,0.0表示零时区。 + +**返回值描述:** + +- int类型,成功返回0,失败抛异常。 + +> 增强型时区读取/设置接口须成对使用,如使用原有的时区接口读取非整数时区,会造成精度丢失。当前仅 EC200A 系列支持该功能。 + ## 测量时间间隔相关功能 ### `utime.ticks_ms` -- Gitee