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'：例如 Sat, 24 May 2008 20:09:47 GMT

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

  • 'SECONDS'：自 Epoch 起算的秒數

  • 'MILLIS'：自 Epoch 起算的毫秒

  • 'MICROS'：自 Epoch 起算的微秒

  • 'NANOS'：自 Epoch 起算的奈秒

  • 'JULIAN_DATE'：自 Epoch 起算的天數

  • '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 會傳回相容性模式 Date 資料類型。