1# 日期与时间
2
3## 概述
4
5### 简介
6提供一些时间的相关操作的能力增强接口。包括时间转换，获取天数和获取时区等函数。
7
8## 接口说明
9|返回类型           |名称           |
10| :------------ | :------------ |
11|int64_t   |**SecToNanosec**(int64_t sec) <br>将秒数转换为纳秒数。   |
12|int64_t   |**MillisecToNanosec**(int64_t millise)<br>将毫秒数转换为纳秒数。   |
13|int64_t   |**MicrosecToNanosec**(int64_t microsec)<br>将微秒数转换为纳秒数。   |
14|int64_t   |**NanosecToSec**(int64_t nanosec)<br>将纳秒数转换为秒数。   |
15|int64_t   |**NanosecToMillisec**(int64_t nanosec)<br>将纳秒数转换为毫秒数。   |
16|int64_t   |**NanosecToMicrosec**(int64_t nanosec)<br>将纳秒数转换为微秒数。   |
17|int64_t   |**GetSecondsSince1970ToNow**()<br>获取从 1970 年到现在的秒数。   |
18|int64_t   |**GetSecondsSince1970ToPointTime**(struct tm inputTm)<br>获取从 1970 到输入时间的秒数。   |
19|int64_t   |**GetSecondsBetween**(struct tm inputTm1, struct tm inputTm2)<br>获取 inputTm1 和 inputTm2 之间的秒数。   |
20|int64_t   |**GetDaysSince1970ToNow**()<br>获取从 1970 年到现在的天数。   |
21|bool      |**GetLocalTimeZone**(int& timezone)<br>获取当前时区。   |
22|bool      |**GetSystemCurrentTime**(struct tm* curTime) <br>获取当前时间。   |
23|int64_t  |**GetTickCount**()<br>获取自系统启动以来的毫秒数。   |
24|int64_t  |**GetMicroTickCount**()<br>获取自系统启动以来的微秒数。   |
25
26## 使用示例
271. 测试用例编译运行方法
28
29- 测试用例代码参见base/test/unittest/common/utils_datetime_test.cpp
30
31- 使用开发者自测试框架，使用方法参见：[开发自测试执行框架-测试用例执行](https://gitee.com/openharmony/testfwk_developer_test#%E6%B5%8B%E8%AF%95%E7%94%A8%E4%BE%8B%E6%89%A7%E8%A1%8C)
32
33- 使用以下具体命令以运行`datetime_ex.h`对应测试用例
34
35```bash
36run -t UT -tp utils -ts UtilsDateTimeTest
37```