跳转至

日期和时间类型

本文介绍日期和时间的类型,包括DATETIMEDATETIMETIMESTAMPDURATION

注意事项

  • 在插入时间类型的属性值时,NebulaGraph 会根据配置文件timezone_name参数指定的时区,将该DATETIMEDATETIME转换成相应的世界协调时间(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获取传入时间的分钟数。

Note

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

openCypher 兼容性

  • 支持年、月、日、时、分、秒、毫秒、微秒,不支持纳秒。
  • 不支持函数localdatetime()
  • 不支持大部分字符串时间格式,支持YYYY-MM-DDThh:mm:ssYYYY-MM-DD hh:mm:ss
  • 支持单个数字的字符串时间格式,例如time("1:1:1")

DATE

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

date()支持的属性名称包括yearmonthdaydate()支持输入YYYYYYYY-MMYYYY-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   |
+---------------+

TIME

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

time()支持的属性名称包括hourminutesecond

DATETIME

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

datetime()支持的属性名称包括yearmonthdayhourminutesecond

TIMESTAMP

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

TIMESTAMP还有以下特点:

  • 以时间戳形式存储和显示。例如1615974839,表示2021-03-17T17:53:59
  • 查询TIMESTAMP的方式包括时间戳和timestamp()函数。
  • 插入TIMESTAMP的方式包括时间戳、timestamp()函数和now()函数。
  • timestamp()函数支持传入空值获取当前时区的时间戳,还接受 string 类型的参数。

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

    历史版本兼容性

    在 NebulaGraph 3.0.0 版本前,传入 timestamp() 函数的时间字符串可包含毫秒和微秒;从 3.0.0 版本起,传入 timestamp() 函数的时间字符串不支持包含毫秒和微秒。

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

DURATION

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

DURATION还有以下特点:

  • 不支持为DURATION类型数据创建索引。
  • 可以用于对指定时间进行计算。

示例

  1. 创建 Tag,名称为date1,包含DATETIMEDATETIME三种类型。

    nebula> CREATE TAG IF NOT EXISTS date1(p1 date, p2 time, p3 datetime);
    
  2. 插入点,名称为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]"));
    
  3. 获取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                |
    +------------------+
    
  4. 创建 Tag,名称为school,包含TIMESTAMP类型。

    nebula> CREATE TAG IF NOT EXISTS school(name string , found_time timestamp);
    
  5. 插入点,名称为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"));
    
  6. 插入点,名称为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 |
+------------+------------+

最后更新: February 23, 2023