注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

文字列を日付に変換

サポート対象:バッチ、高速、ストリーミング

Java DateTimeFormatter に従って書式設定された文字列から日付を返します。デフォルトの書式は yyyy-MM-dd と yyyy-MM-dd'T'HH:mm:ss.SSSXXX です。書式は順番に適用され、最初に一致した書式による結果が返されます。

式のカテゴリー: 型変換、日時

引数

  • 文字列: 日付にパースする文字列の列。
    Expression<String>
  • 任意 書式: 日付の書式を入力します(例: yyyy-MM-dd または MM/dd/yyyy)。
    List<Literal<String>>

出力タイプ: Date

例

例1:基本ケース

説明: 日付の書式は任意です。

引数の値:

  • 文字列: 2020-04-28
  • 書式: null

出力: 2020-04-28


例2:基本ケース

説明: 日付の書式は任意です。

引数の値:

  • 文字列: 2020-04-28T01:00:00.000Z
  • 書式: null

出力: 2020-04-28


例3:基本ケース

説明: 単一の書式で日付をパースします。

引数の値:

  • 文字列: 28-2020-04
  • 書式: [dd-yyyy-MM]

出力: 2020-04-28


例4:基本ケース

説明: 複数の書式を使用して日付をパースします。

引数の値:

  • 文字列: 28-2020-04
  • 書式: [yyyy-MM-dd, dd-yyyy-MM]

出力: 2020-04-28


例5:基本ケース

説明: 日付の先頭のゼロがない場合でも、この「yyyy-M-d」書式を使用すると正しくパースされます。

引数の値:

  • 文字列: date
  • 書式: [yyyy-M-d]
date出力
2020-04-082020-04-08
2020-4-82020-04-08
2020-10-102020-10-10

例6:基本ケース

説明: 文字列にはタイムスタンプを含めることができます。

引数の値:

  • 文字列: 28-2020-04 10:12:00 +01
  • 書式: [dd-yyyy-MM HH:mm X]

出力: 2020-04-28


例7:基本ケース

説明: タイムゾーンによって日付が変わることがあります。

引数の値:

  • 文字列: 28-2020-04 10:12:00 +11
  • 書式: [dd-yyyy-MM HH:mm X]

出力: 2020-04-27


例8:null のケース

説明: null の列は null のままです。

引数の値:

  • 文字列: null
  • 書式: [dd-yyyy-MM]

出力: null


例9:エッジケース

説明: 無効なデータは null にパースされます。

引数の値:

  • 文字列: 28-20201-14
  • 書式: [dd-yyyy-MM]

出力: null


例10:エッジケース

説明: 書式が正しくない場合、すべて null にパースされます。

引数の値:

  • 文字列: 04-2020-28
  • 書式: [dd-yyyy-MM]

出力: null


例11:エッジケース

説明: 年内の通算日を表す書式では、年はデフォルトで1970年になります。

引数の値:

  • 文字列: 300
  • 書式: [D]

出力: 1970-10-27


例12:エッジケース

説明: 年内の通算日を3桁で表す書式では、年はデフォルトで1970年になります。

引数の値:

  • 文字列: 365
  • 書式: [DDD]

出力: 1970-12-31


例13:エッジケース

説明: 年を含まない書式では、年はデフォルトで1970年になります。

引数の値:

  • 文字列: 12-25
  • 書式: [MM-dd]

出力: 1970-12-25


例14:エッジケース

説明: 月のみの書式では、年はデフォルトで1970年、日は1日になります。

引数の値:

  • 文字列: 03
  • 書式: [MM]

出力: 1970-03-01


例15:エッジケース

説明: 年を1桁で表す書式では、月はデフォルトで1月、日は1日になります。

引数の値:

  • 文字列: 1
  • 書式: [y]

出力: 0001-01-01


例16:エッジケース

説明: 時刻のみの書式では、日付はデフォルトで Unix エポック (1970-01-01) になります。

引数の値:

  • 文字列: 1
  • 書式: [m]

出力: 1970-01-01


例17:エッジケース

説明: 年を2桁で表す書式では、月はデフォルトで1月、日は1日になります。

引数の値:

  • 文字列: 99
  • 書式: [yy]

出力: 2099-01-01


例18:エッジケース

説明: 年のみの書式では、月はデフォルトで1月、日は1日になります。

引数の値:

  • 文字列: 2020
  • 書式: [yyyy]

出力: 2020-01-01