TODATE

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

您可以通过以下 2 种方式使用 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'：例如，2008 年 5 月 24 日（星期六）20:09:47（格林尼治标准时间）

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

  • “SECONDS”：自公元纪年起算的秒数

  • 'MILLIS'：自公元纪年以来的毫秒数

  • 'MICROS'：自公元纪年以来的微秒数

  • 'NANOS'：自公元纪年以来的纳秒数

  • '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 会返回兼容模式日期数据类型。