日期和时间类型¶

本文介绍日期和时间的类型，包括DATE、TIME、DATETIME、TIMESTAMP和DURATION。

注意事项¶

在插入时间类型的属性值时，NebulaGraph 会根据配置文件中timezone_name参数指定的时区，将该DATE、TIME、DATETIME转换成相应的世界协调时间（UTC）时间。

Note

如需修改当前时区，请同时修改所有服务的配置文件中的timezone_name参数。

函数date()、time()和datetime()可以指定时区进行转换，例如datetime("2017-03-04 22:30:40.003000+08:00")或datetime("2017-03-04T22:30:40.003000[Asia/Shanghai]")。

函数date()、time()、datetime()和timestamp()可以用空值获取当前的日期或时间。

函数date()、time()、datetime()和duration()可以用属性名称获取自身的某一个具体属性值，例如date().month获取当前月份、time("02:59:40").minute获取传入时间的分钟数。

进行时间运算时建议使用duration()计算时刻的偏移。此外还支持date()和date()的加减、timestamp()和timestamp()的加减。

设置时间的年份为负数时，需要使用 Map 类型数据。

openCypher 兼容性¶

支持年、月、日、时、分、秒、毫秒、微秒，不支持纳秒。

不支持函数localdatetime()。

不支持大部分字符串时间格式，支持YYYY-MM-DDThh:mm:ss和YYYY-MM-DD hh:mm:ss。

支持单个数字的字符串时间格式，例如time("1:1:1")。

DATE¶

DATE包含日期，但是不包含时间。 NebulaGraph 检索和显示DATE的格式为YYYY-MM-DD。支持的范围是-32768-01-01到32767-12-31。

date()支持的属性名称包括year、month和day。date()支持输入YYYY、YYYY-MM或YYYY-MM-DD，未输入的月份或日期默认为01。

nebula> RETURN DATE({year:-123, month:12, day:3});
+------------------------------------+
| date({year:-(123),month:12,day:3}) |
+------------------------------------+
| -123-12-03                         |
+------------------------------------+

nebula> RETURN DATE("23333");
+---------------+
| date("23333") |
+---------------+
| 23333-01-01   |
+---------------+

nebula> RETURN DATE("2023-12-12") - DATE("2023-12-11");
+-----------------------------------------+
| (date("2023-12-12")-date("2023-12-11")) |
+-----------------------------------------+
| 1                                       |
+-----------------------------------------+

TIME¶

TIME包含时间，但是不包含日期。 NebulaGraph 检索和显示TIME的格式为hh:mm:ss.msmsmsususus。支持的范围是00:00:00.000000到23:59:59.999999。

time()支持的属性名称包括hour、minute和second。

DATETIME¶

DATETIME包含日期和时间。 NebulaGraph 检索和显示DATETIME的格式为YYYY-MM-DDThh:mm:ss.msmsmsususus。支持的范围是-32768-01-01T00:00:00.000000到32767-12-31T23:59:59.999999。

datetime()支持的属性名称包括year、month、day、hour、minute和second。

datetime()可将TIMESTAMP类型的日期值转换成DATETIME类型的日期值。TIMESTAMP类型的日期值取值范围：0~9223372036。

datetime()支持int类型的参数，该int参数表示时间戳。

# 获取当前时间。
nebula> RETURN datetime();
+----------------------------+
| datetime()                 |
+----------------------------+
| 2022-08-29T06:37:08.933000 |
+----------------------------+

# 获取当前时间的小时。
nebula> RETURN datetime().hour;
+-----------------+
| datetime().hour |
+-----------------+
| 6               |
+-----------------+

# 将时间戳转换成 DATETIME 类型的格式。
nebula> RETURN datetime(timestamp(1625469277));
+---------------------------------+
| datetime(timestamp(1625469277)) |
+---------------------------------+
| 2021-07-05T07:14:37.000000      |
+---------------------------------+

nebula> RETURN datetime(1625469277);
+----------------------------+
| datetime(1625469277)       |
+----------------------------+
| 2021-07-05T07:14:37.000000 |
+----------------------------+

TIMESTAMP¶

TIMESTAMP包含日期和时间。支持的范围是 UTC 时间的1970-01-01T00:00:01到2262-04-11T23:47:16。

TIMESTAMP还有以下特点：

以时间戳形式存储和显示。例如1615974839，表示2021-03-17T17:53:59。

查询TIMESTAMP类型属性值的方式包括时间戳整数和timestamp()函数。

插入TIMESTAMP类型属性值的方式包括时间戳整数、timestamp()函数和now()函数。

timestamp()函数支持传入空值获取当前时间戳；同时支持传入整数以标识该整数为时间戳，整数取值：0~9223372036。

timestamp()函数可将DATETIME类型的日期值转换成TIMESTAMP类型的日期值，且传入的DATETIME类型的日期值为string类型。

底层存储的数据格式为 64 位 int。

# 传入当前时间。
nebula> RETURN timestamp();
+-------------+
| timestamp() |
+-------------+
| 1625469277  |
+-------------+

# 传入指定时间。
nebula> RETURN timestamp("2022-01-05T06:18:43");
+----------------------------------+
| timestamp("2022-01-05T06:18:43") |
+----------------------------------+
| 1641363523                       |
+----------------------------------+

# 传入 datetime()。
nebula> RETURN timestamp(datetime("2022-08-29T07:53:10.939000"));
+---------------------------------------------------+
| timestamp(datetime("2022-08-29T07:53:10.939000")) |
+---------------------------------------------------+
| 1661759590                                        |
+---------------------------------------------------+

Note

传入timestamp()函数的时间字符串不支持包含毫秒和微秒，但是通过timestamp(datetime())传入的时间字符串支持包含毫秒和微秒。

DURATION¶

DURATION是一段连续的时间，由years、months、days、hours、minutes、seconds六个Key自由组合成的Map类型数据表示。例如duration({years: 12, months: 5, days: 14, hours: 16, minutes: 12, seconds: 70})。

DURATION还有以下特点：

不支持为DURATION类型数据创建索引。

可以用于对指定时间进行计算。

示例¶

创建 Tag，名称为date1，包含DATE、TIME和DATETIME三种类型。
```
nebula> CREATE TAG IF NOT EXISTS date1(p1 date, p2 time, p3 datetime);
```

插入点，名称为test1。

nebula> INSERT VERTEX date1(p1, p2, p3) VALUES "test1":(date("2021-03-17"), time("17:53:59"), datetime("2017-03-04T22:30:40.003000[Asia/Shanghai]"));

查询test1的属性p1是否为2021-03-17。

nebula> MATCH (v:date1) RETURN v.date1.p1 == date("2021-03-17");
+----------------------------------+
| (v.date1.p1==date("2021-03-17")) |
+----------------------------------+
| true                             |
+----------------------------------+

获取test1的属性p1的月份。

nebula> CREATE TAG INDEX IF NOT EXISTS date1_index ON date1(p1);
nebula> REBUILD TAG INDEX date1_index;
nebula> MATCH (v:date1) RETURN v.date1.p1.month;
+------------------+
| v.date1.p1.month |
+------------------+
| 3                |
+------------------+

查找 Tag date1中属性p3小于2023-01-01T00:00:00.000000的值。

nebula> MATCH (v:date1)  \
WHERE v.date1.p3 < datetime("2023-01-01T00:00:00.000000") \
RETURN v.date1.p3;
+----------------------------+
| v.date1.p3                 |
+----------------------------+
| 2017-03-04T14:30:40.003000 |
+----------------------------+

创建 Tag，名称为school，包含TIMESTAMP类型。

nebula> CREATE TAG IF NOT EXISTS school(name string , found_time timestamp);

插入点，名称为DUT，存储时间为"1988-03-01T08:00:00"。

# 时间戳形式插入，1988-03-01T08:00:00 对应的时间戳为 573177600，转换为 UTC 时间为 573206400。
nebula> INSERT VERTEX school(name, found_time) VALUES "DUT":("DUT", 573206400);

# 日期和时间格式插入。
nebula> INSERT VERTEX school(name, found_time) VALUES "DUT":("DUT", timestamp("1988-03-01T08:00:00"));

插入点，名称为dut，用now()或timestamp()函数存储时间。

# 用 now() 函数存储时间
nebula> INSERT VERTEX school(name, found_time) VALUES "dut":("dut", now());

# 用 timestamp() 函数存储时间
nebula> INSERT VERTEX school(name, found_time) VALUES "dut":("dut", timestamp());

还可以使用WITH语句设置具体日期时间或进行计算，例如：

nebula> WITH time({hour: 12, minute: 31, second: 14, millisecond:111, microsecond: 222}) AS d RETURN d;
+-----------------+
| d               |
+-----------------+
| 12:31:14.111222 |
+-----------------+

nebula> WITH date({year: 1984, month: 10, day: 11}) AS x RETURN x + 1;
+------------+
| (x+1)      |
+------------+
| 1984-10-12 |
+------------+

nebula> WITH date('1984-10-11') as x, duration({years: 12, days: 14, hours: 99, minutes: 12}) as d \
        RETURN x + d AS sum, x - d AS diff;
+------------+------------+
| sum        | diff       |
+------------+------------+
| 1996-10-29 | 1972-09-23 |
+------------+------------+

最后更新: September 6, 2024