timestamp.get_timestamp

以下でサポートされています。
timestamp.get_timestamp(unix_seconds, optional timestamp_format/time_granularity, optional timezone)

説明

この関数は、タイムスタンプの日を表す YYYY-MM-DD 形式の文字列を返します。

  • unix_seconds は、$e.metadata.event_timestamp.seconds などの Unix エポックからの経過秒数を表す整数か、その値を含むプレースホルダです。
  • timestamp_format は省略可能で、タイムスタンプの形式を表す文字列です。省略した場合、デフォルトは %F %T です。形式は、日時形式文字列または次の時間粒度のいずれかを使用して指定できます。SECOND、MINUTE、HOUR、DATE、WEEK、MONTH、YEAR。その他の形式設定オプションについては、日付と時刻の部分の形式設定要素をご覧ください。
  • time_zone は省略可能で、タイムゾーンを表す文字列です。省略した場合、デフォルトは GMT です。文字列リテラルを使用してタイムゾーンを指定できます。以下のオプションがあります。

以下に、有効な time_zone 指定子の例を示します。これらは、時間抽出関数に 2 番目の引数として渡すことができます。

"America/Los_Angeles", or "-08:00". ("PST" is not supported)
"America/New_York", or "-05:00". ("EST" is not supported)
"Europe/London"
"UTC"
"GMT"

パラメータのデータ型

INT、STRING、STRING

戻り値の型

STRING

コードサンプル

例 1

この例では、time_zone 引数が省略されているため、デフォルトの GMT になります。

$ts = $e.metadata.collected_timestamp.seconds

timestamp.get_timestamp($ts) = "2024-02-22 10:43:51"
例 2

この例では、文字列リテラルを使用して time_zone を定義します。

$ts = $e.metadata.collected_timestamp.seconds

timestamp.get_timestamp($ts, "%F %T", "America/Los_Angeles") = "2024-02-22 10:43:51"
例 3

この例では、文字列リテラルを使用して timestamp_format を定義します。

$ts = $e.metadata.collected_timestamp.seconds

timestamp.get_timestamp($ts, "%Y-%m", "GMT") = "2024-02"
例 4

この例では、UNIX タイムスタンプを秒単位の文字列としてフォーマットします。

timestamp.get_timestamp(1708598631, "SECOND", "GMT") = "2024-02-22 10:43:51"
例 5

この例では、分単位で Unix タイムスタンプを文字列としてフォーマットします。

timestamp.get_timestamp(1708598631, "MINUTE", "GMT") = "2024-02-22 10:43"
例 6

この例では、Unix タイムスタンプを時間単位の文字列としてフォーマットします。

timestamp.get_timestamp(1708598631, "HOUR", "GMT") = "2024-02-22 10"
例 7

この例では、UNIX タイムスタンプを日単位の文字列としてフォーマットします。

timestamp.get_timestamp(1708598631, "DATE", "GMT") = "2024-02-22"
例 8

この例では、UNIX タイムスタンプを週単位の文字列としてフォーマットします。

timestamp.get_timestamp(1708598631, "WEEK", "GMT") = "2024-02-18"
例 9

この例では、Unix タイムスタンプを月単位の文字列としてフォーマットします。

timestamp.get_timestamp(1708598631, "MONTH", "GMT") = "2024-02"
例 10

この例では、UNIX タイムスタンプを年単位の文字列としてフォーマットします。

timestamp.get_timestamp(1708598631, "YEAR", "GMT") = "2024"