TODATE

返回带格式的兼容模式日期。

您可以通过以下两种方式使用 TODATE：

  • 根据文本字段创建兼容模式日期。
  • 更改兼容模式日期的显示格式和粒度。

用法示例

TODATE(Text_Date,"%Y/%m/%d","%Y-%m-%d")

TODATE(Text_Date,"%Y/%m/%d","%Y-%m-%d")

TODATE(Response_Time, 'MILLIS', '%Y%m%d')

TODATE(Created_Time, 'DECIMAL_DATE', '%Y')

语法

TODATE(field_expression, input_date_format, output_date_format)

输入格式

如果 field_expression 正确配置为语义日期，则 input_date_format 是可选的。

TODATE 接受以下输入格式字符串。

  • 'BASIC': %Y/%m/%d-%H:%M:%S

  • 'DEFAULT_DASH': %Y-%m-%d [%H:%M:%S]

  • 'DEFAULT_SLASH': %Y/%m/%d [%H:%M:%S]

  • 'DEFAULT_DECIMAL': %Y%m%d [%H:%M:%S]

  • 'RFC_1123'：例如，Sat, 24 May 2008 20:09:47 GMT

  • 'RFC_3339'：例如，2008-05-24T20:09:47Z

  • “SECONDS”：自纪元以来的秒数

  • “MILLIS”：自 Epoch 以来的毫秒数

  • “MICROS”：自 Epoch 以来的微秒数

  • “NANOS”：自 Epoch 以来的纳秒数

  • 'JULIAN_DATE'：自纪元以来的天数

  • 'DECIMAL_DATE'：与 'DEFAULT_DECIMAL' 相同

  • 任何有效的 strptime 格式。如果值已是日期时间字段，则为可选。

输出格式

TODATE 接受以下输出格式字符串：

  • "%Y" 年
  • "%m" 个月
  • "%d" 天
  • "%W" - 年周数
  • "%w" - 星期几
  • "%H" 小时
  • "%M" 分钟

示例

Example formula Input Output
TODATE(Text_Date,"%Y/%m/%d","%Y-%m-%d") 2024/05/09 2024-05-09
TODATE(Response_Time, 'MILLIS', '%Y%m%d') 1715294861000 20240509
TODATE(Created_time, 'DECIMAL_DATE', '%Y') 20240509[11:34:12] 2024

备注

TODATE 会返回兼容模式的日期数据类型。