temporalParse

temporalParse(X, format)

别名：datetimeParse

X 是一个字符串。

format 是表示时间序列对象格式的字符串。

把字符串转换成 DolphinDB 中的时序类型数据。如果系统不能识别时序格式，将返回 NULL。

DolphinDB 具有以下时序格式：

temporalParse 函数中的 format 参数有以下两种表示方式：

• 使用分隔符

  对于 format 参数 ，除了 y, M, d, H, h, m, s, a, S, n 以外的符号的字符都可以作为分隔符。format 参数中的分隔符需要与输入字符串中的分隔符一致。

  temporalParse("14-02-2018","dd-MM-yyyy");
  // output
  2018.02.14
  
  temporalParse("14-02-2018","dd/MM/yyyy");
  // output
  00d
  
  temporalParse("14//02//2018","dd//MM//yyyy");
  // output
  2018.02.14
  
  temporalParse("14//02//2018","dd/MM/yyyy");
  // output
  00d
  
  temporalParse("14//02//2018","dd..MM..yyyy");
  // output
  00d

  我们可以使用单个字母来简化格式。例如，使用 "y/M/d" 代替 "yyyy/MM/dd"。因为 "y" 可以表示 "yyyy" 和 "yy", 系统会根据数字的个数采用 "yyyy" 或 "yy"。

  temporalParse("14-02-18","d-M-y");
  // output
  2018.02.14
  
  temporalParse("2018/2/6 02:33:01 PM","y/M/d h:m:s a");
  // output
  2018.02.06T14:33:01

  "MMM","SSS", "nnnnnn" , "nnnnnnnnn" 不能使用单个字母。

  temporalParse("02-FEB-2018","d-MMM-y");
  // output
  2018.02.02
  
  temporalParse("02-FEB-2018","d-M-y");
  // output
  00d
  
  temporalParse("13:30:10.001","H:m:s.SSS");
  // output
  13:30:10.001
  
  temporalParse("13:30:10.001","H:m:s.S");
  // output
  Invalid temporal format: 'H:m:s.S'. Millisecond (S) must have three digits.
  
  temporalParse("13:30:10.008001","H:m:s.nnnnnn");
  // output
  13:30:10.008001000
  
  temporalParse("13:30:10.008001","H:m:s.n");
  // output
  Invalid temporal format: 'H:m:s.n'. Nanosecond (n) must have six or nine digits.

  temporalParse 函数解释输入字符串中数字个数的方式是非常灵活的。

  temporalParse("2-4-18","d-M-y");
  // output
  2018.04.02
  
  temporalParse("2-19-6","H-m-s");
  // output
  02:19:06
  
  temporalParse("002-019-006","H-m-s");
  // output
  02:19:06

  对于毫秒，微秒和纳秒，对应的数字位个数必须是3, 6, 9。

  temporalParse("2018/2/6 13:30:10.001","y/M/d H:m:s.SSS");
  // output
  2018.02.06T13:30:10.001
  
  temporalParse("2018/2/6 13:30:10.01","y/M/d H:m:s.SSS");
  // output
  00T
  
  temporalParse("2018/2/6 13:30:10.000001","y/M/d H:m:s.nnnnnn");
  // output
  2018.02.06T13:30:10.000001000
  
  temporalParse("2018/2/6 13:30:10.0000010","y/M/d H:m:s.nnnnnn");
  // output
  00N

• 不使用分隔符

  对于这种表示方式，format 参数必须与上述表格中的格式对应，不能使用单个字母来表示格式。

  temporalParse("20180214","yyyyMMdd");
  // output
  2018.02.14
  
  temporalParse("122506","MMddyy");
  // output
  2006.12.25
  
  temporalParse("155950","HHmmss");
  // output
  15:59:50
  
  temporalParse("035901PM","hhmmssaa");
  // output
  15:59:01
  
  temporalParse("02062018155956001000001","MMddyyyyHHmmssnnnnnnnnn");
  // output
  2018.02.06T15:59:56.001000001