tencent cloud

Cloud Log Service

ドキュメントCloud Log Service操作ガイドデータ処理データ加工データ加工関数時間値処理関数

時間値処理関数

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-12 15:02:20
AI翻訳

概要

ログ内の時間処理関数には、Date型をString型に変換すること、時間系フィールド値とUTC時間の相互変換、および現在時刻の取得が含まれます。

dt_str関数

関数定義

時間系のフィールド値（特定形式の日付文字列またはタイムスタンプ）を、指定したタイムゾーンと形式の対象日付文字列に変換します。

構文記述

dt_str(値, format="フォーマット文字列", zone="")

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
data
フィールド値でサポートされる解析形式については、dateparserを参照してください。
string
はい
-
-
format
日付形式のフォーマットについては、DateTimeFormatterを参照してください。
string
いいえ
-
-
zone
デフォルトはUTC時間で、タイムゾーンは指定されません。タイムゾーンの定義については、ZoneIdを参照してください。
string
いいえ
UTC+00:00
-

例

元のログ：
{"date":"2014-04-26 13:13:44 +09:00"}
加工ルール：
fields_set("result", dt_str(v("date"), format="yyyy-MM-dd HH:mm:ss", zone="UTC+8"))
加工結果：
{"date":"2014-04-26 13:13:44 +09:00","result":"2014-04-26 12:13:44"}

dt_to_timestamp関数

関数定義

時間系のフィールド値（特定形式の日付文字列）を、フィールドに対応するタイムゾーンを指定した上で、UTCタイムスタンプに変換します。

構文記述

dt_to_timestamp(値, zone="")

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
data
フィールド値でサポートされる解析形式については、dateparserを参照してください。
string
はい
-
-
zone
デフォルトはUTC時間で、タイムゾーンは指定されません。この値を指定する場合は、時間フィールド値と対応している必要があります。対応していないと、タイムゾーンエラーが発生します。タイムゾーンの定義については、ZoneIdを参照してください。
string
いいえ
UTC+00:00
-

例

元のログ：
{"date":"2021-10-26 15:48:15"}
加工ルール：
fields_set("result", dt_to_timestamp(v("date"), zone="UTC+8"))
加工結果：
{"date":"2021-10-26 15:48:15","result":"1635234495000"}

dt_from_timestamp関数

関数定義

時間系のタイムスタンプフィールドを、対象タイムゾーンを指定した後、時間文字列に変換します。

構文記述

dt_from_timestamp(値, zone="")

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
data
フィールド値でサポートされる解析形式については、dateparserを参照してください。
string
はい
-
-
zone
デフォルトはUTC時間で、タイムゾーンは指定されません。タイムゾーンの定義については、ZoneIdを参照してください。
string
いいえ
UTC+00:00
-

例

元のログ：
{"date":"1635234495000"}
加工ルール：
fields_set("result", dt_from_timestamp(v("date"), zone="UTC+8"))
加工結果：
{"date":"1635234495000","result":"2021-10-26 15:48:15"}

dt_now関数

関数定義

加工計算時のローカル時間を取得します。

構文記述

dt_now(format="フォーマット文字列", zone="")

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
format
日付形式をフォーマットします。詳細はDateTimeFormatterを参照してください。
string
いいえ
-
-
zone
デフォルトはUTC時間で、タイムゾーンは指定されません。タイムゾーンの定義については、ZoneIdを参照してください。
string
いいえ
UTC+00:00
-

例

元のログ：
{"date":"1635234495000"}
加工ルール：
fields_set("now", dt_now(format="yyyy-MM-dd HH:mm:ss", zone="UTC+8"))
加工結果は参考のみです。具体的な結果はシステム時間に関連します：
{"date":"1635234495000","now":"2021-MM-dd HH:mm:ss"}

custom_cls_log_time関数

関数定義

カスタムログ時間は、お客様の加工ルールに従って新しいログ時間を生成します。秒、ミリ秒、マイクロ秒、ナノ秒をサポートします。プレビューを実行をクリックすると、加工結果で__TIMESTAMP__フィールドの値が期待どおりの結果に変更されたかどうかを確認できます。

構文記述

custom_cls_log_time(time)

パラメータ説明

パラメータ名
パラメータ説明
パラメータタイプ
必須かどうか
パラメータのデフォルト値
パラメータの値の範囲
time
UTCタイムスタンプ。タイムゾーン定義はZoneIdを参照できます。秒、ミリ秒、マイクロ秒、ナノ秒をサポートします。例えば1565064739000です。
string
はい
-
-

戻り値

UTCタイムスタンプ、例えば1565064739000です。

例

元のログ：
{"field1": "1","time":"06/Aug/2019 12:12:19"}
加工ルール：
custom_cls_log_time(dt_to_timestamp(v("time"), zone="UTC+8"))
加工結果は参考のみです。具体的な結果はシステム時間に関連します：
{"__TIMESTAMP__":"1565064739000", "field1":"1", "time":"06/Aug/2019 12:12:19"}

前の記事へ: 正規表現処理関数次の記事へ: 文字列処理関数

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック

キーワードで検索
    Enter keywords to search documentation