日付フィールドタイプ

JSONには日付データ型がないため、Elasticsearchの日時は次のいずれかになります：

  • フォーマットされた日付を含む文字列、例："2015-01-01"または"2015/01/01 12:10:30"。
  • エポックからのミリ秒を表す数値。
  • エポックからの秒を表す数値（設定）。

内部的には、日付はUTCに変換され（タイムゾーンが指定されている場合）、エポックからのミリ秒を表す長い数値として保存されます。

ナノ秒の解像度が期待される場合は、date_nanosフィールドタイプを使用してください。

日付に対するクエリは、内部的にこの長い表現に対する範囲クエリに変換され、集約の結果や保存されたフィールドは、フィールドに関連付けられた日付フォーマットに応じて文字列に戻されます。

日付は常に文字列として表示されます。たとえ最初にJSONドキュメントで長い数値として提供されていた場合でもです。

日付フォーマットはカスタマイズ可能ですが、formatが指定されていない場合はデフォルトが使用されます：

Js

  1. "strict_date_optional_time||epoch_millis"

これは、strict_date_optional_timeでサポートされているフォーマットまたはエポックからのミリ秒に準拠したオプションのタイムスタンプを持つ日付を受け入れることを意味します。

例えば：

Python

  1. resp = client.indices.create(
  2.    index="my-index-000001",
  3.    mappings={
  4.    "properties": {
  5.    "date": {
  6.    "type": "date"
  7.    }
  8.    }
  9.    },
  10. )
  11. print(resp)
  13. resp1 = client.index(
  14.    index="my-index-000001",
  15.    id="1",
  16.    document={
  17.    "date": "2015-01-01"
  18.    },
  19. )
  20. print(resp1)
  22. resp2 = client.index(
  23.    index="my-index-000001",
  24.    id="2",
  25.    document={
  26.    "date": "2015-01-01T12:10:30Z"
  27.    },
  28. )
  29. print(resp2)
  31. resp3 = client.index(
  32.    index="my-index-000001",
  33.    id="3",
  34.    document={
  35.    "date": 1420070400001
  36.    },
  37. )
  38. print(resp3)
  40. resp4 = client.search(
  41.    index="my-index-000001",
  42.    sort={
  43.    "date": "asc"
  44.    },
  45. )
  46. print(resp4)

Ruby

  1. response = client.indices.create(
  2.   index: 'my-index-000001',
  3.   body: {
  4.    mappings: {
  5.    properties: {
  6.    date: {
  7.    type: 'date'
  8.    }
  9.    }
  10.    }
  11.   }
  12. )
  13. puts response
  15. response = client.index(
  16.   index: 'my-index-000001',
  17.   id: 1,
  18.   body: {
  19.    date: '2015-01-01'
  20.   }
  21. )
  22. puts response
  24. response = client.index(
  25.   index: 'my-index-000001',
  26.   id: 2,
  27.   body: {
  28.    date: '2015-01-01T12:10:30Z'
  29.   }
  30. )
  31. puts response
  33. response = client.index(
  34.   index: 'my-index-000001',
  35.   id: 3,
  36.   body: {
  37.    date: 1_420_070_400_001
  38.   }
  39. )
  40. puts response
  42. response = client.search(
  43.   index: 'my-index-000001',
  44.   body: {
  45.    sort: {
  46.    date: 'asc'
  47.    }
  48.   }
  49. )
  50. puts response

Go

  1. {
  2.     res, err := es.Indices.Create(
  3.         "my-index-000001",
  4.         es.Indices.Create.WithBody(strings.NewReader(`{
  5.       "mappings": {
  6.       "properties": {
  7.       "date": {
  8.       "type": "date"
  9.       }
  10.       }
  11.       }
  12.     }`)),
  13.     )
  14.     fmt.Println(res, err)
  15. }
  17. {
  18.     res, err := es.Index(
  19.         "my-index-000001",
  20.         strings.NewReader(`{
  21.       "date": "2015-01-01"
  22.     } `),
  23.         es.Index.WithDocumentID("1"),
  24.         es.Index.WithPretty(),
  25.     )
  26.     fmt.Println(res, err)
  27. }
  29. {
  30.     res, err := es.Index(
  31.         "my-index-000001",
  32.         strings.NewReader(`{
  33.       "date": "2015-01-01T12:10:30Z"
  34.     } `),
  35.         es.Index.WithDocumentID("2"),
  36.         es.Index.WithPretty(),
  37.     )
  38.     fmt.Println(res, err)
  39. }
  41. {
  42.     res, err := es.Index(
  43.         "my-index-000001",
  44.         strings.NewReader(`{
  45.       "date": 1420070400001
  46.     } `),
  47.         es.Index.WithDocumentID("3"),
  48.         es.Index.WithPretty(),
  49.     )
  50.     fmt.Println(res, err)
  51. }
  53. {
  54.     res, err := es.Search(
  55.         es.Search.WithIndex("my-index-000001"),
  56.         es.Search.WithBody(strings.NewReader(`{
  57.       "sort": {
  58.       "date": "asc"
  59.       }
  60.     }`)),
  61.         es.Search.WithPretty(),
  62.     )
  63.     fmt.Println(res, err)
  64. }

Js

  1. const response = await client.indices.create({
  2.   index: "my-index-000001",
  3.   mappings: {
  4.    properties: {
  5.    date: {
  6.    type: "date",
  7.    },
  8.    },
  9.   },
  10. });
  11. console.log(response);
  13. const response1 = await client.index({
  14.   index: "my-index-000001",
  15.   id: 1,
  16.   document: {
  17.    date: "2015-01-01",
  18.   },
  19. });
  20. console.log(response1);
  22. const response2 = await client.index({
  23.   index: "my-index-000001",
  24.   id: 2,
  25.   document: {
  26.    date: "2015-01-01T12:10:30Z",
  27.   },
  28. });
  29. console.log(response2);
  31. const response3 = await client.index({
  32.   index: "my-index-000001",
  33.   id: 3,
  34.   document: {
  35.    date: 1420070400001,
  36.   },
  37. });
  38. console.log(response3);
  40. const response4 = await client.search({
  41.   index: "my-index-000001",
  42.   sort: {
  43.    date: "asc",
  44.   },
  45. });
  46. console.log(response4);

コンソール

  1. PUT my-index-000001
  2. {
  3.   "mappings": {
  4.    "properties": {
  5.    "date": {
  6.    "type": "date"
  7.    }
  8.    }
  9.   }
  10. }
  12. PUT my-index-000001/_doc/1
  13. { "date": "2015-01-01" }
  15. PUT my-index-000001/_doc/2
  16. { "date": "2015-01-01T12:10:30Z" }
  18. PUT my-index-000001/_doc/3
  19. { "date": 1420070400001 }
  21. GET my-index-000001/_search
  22. {
  23.   "sort": { "date": "asc"}
  24. }
dateフィールドはデフォルトのformatを使用します。
このドキュメントはプレーンな日付を使用しています。
このドキュメントには時間が含まれています。
このドキュメントはエポックからのミリ秒を使用しています。
返されるsortの値はすべてエポックからのミリ秒です。

日付は{"date": 1618249875.123456}のように小数点を含む数値を受け入れますが、いくつかのケース（[#70085](https://github.com/elastic/elasticsearch/issues/70085））では、これらの日付の精度が失われるため、避けるべきです。

複数の日付フォーマット

複数のフォーマットは、||を区切りとして指定できます。各フォーマットは、マッチするフォーマットが見つかるまで順番に試されます。最初のフォーマットがエポックからのミリ秒値を文字列に戻すために使用されます。

Python

  1. resp = client.indices.create(
  2.    index="my-index-000001",
  3.    mappings={
  4.    "properties": {
  5.    "date": {
  6.    "type": "date",
  7.    "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
  8.    }
  9.    }
  10.    },
  11. )
  12. print(resp)

Ruby

  1. response = client.indices.create(
  2.   index: 'my-index-000001',
  3.   body: {
  4.    mappings: {
  5.    properties: {
  6.    date: {
  7.    type: 'date',
  8.    format: 'yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis'
  9.    }
  10.    }
  11.    }
  12.   }
  13. )
  14. puts response

Go

  1. res, err := es.Indices.Create(
  2.     "my-index-000001",
  3.     es.Indices.Create.WithBody(strings.NewReader(`{
  4.       "mappings": {
  5.       "properties": {
  6.       "date": {
  7.       "type": "date",
  8.       "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
  9.       }
  10.       }
  11.       }
  12.     }`)),
  13. )
  14. fmt.Println(res, err)

Js

  1. const response = await client.indices.create({
  2.   index: "my-index-000001",
  3.   mappings: {
  4.    properties: {
  5.    date: {
  6.    type: "date",
  7.    format: "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis",
  8.    },
  9.    },
  10.   },
  11. });
  12. console.log(response);

コンソール

  1. PUT my-index-000001
  2. {
  3.   "mappings": {
  4.    "properties": {
  5.    "date": {
  6.    "type":   "date",
  7.    "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
  8.    }
  9.    }
  10.   }
  11. }

日付フィールドのパラメータ

次のパラメータはdateフィールドで受け入れられます：

doc_values フィールドはディスクにカラムストライド方式で保存され、後でソート、集計、またはスクリプトに使用されるべきですか？true（デフォルト）またはfalseを受け入れます。
format 解析可能な日付フォーマット。デフォルトは`````strict_date_optional_time epoch_millis`````です。
locale 日付を解析する際に使用するロケール。月の名前や略称はすべての言語で同じではないため。デフォルトはROOTロケールです。
ignore_malformed trueの場合、誤った数値は無視されます。false（デフォルト）の場合、誤った数値は例外をスローし、ドキュメント全体を拒否します。このパラメータがscriptパラメータが使用されている場合は設定できません。
index フィールドは迅速に検索可能であるべきですか？true（デフォルト）およびfalseを受け入れます。doc_valuesが有効な日付フィールドもクエリ可能ですが、遅くなります。
null_value フィールドの明示的なnull値の代わりに、設定されたformatの1つの日時値を受け入れます。デフォルトはnullで、これはフィールドが欠落していると見なされます。このパラメータがscriptパラメータが使用されている場合は設定できません。
on_script_error scriptパラメータによって定義されたスクリプトがインデックス作成時にエラーをスローした場合の処理方法を定義します。fail（デフォルト）を受け入れ、これによりドキュメント全体が拒否され、continueは、ドキュメントの_ignoredメタデータフィールドにフィールドを登録し、インデックス作成を続行します。このパラメータはscriptフィールドが設定されている場合にのみ設定できます。
script このパラメータが設定されている場合、フィールドはこのスクリプトによって生成された値をインデックス化し、ソースから直接値を読み取るのではなくなります。このフィールドに入力ドキュメントで値が設定されている場合、ドキュメントはエラーで拒否されます。スクリプトはそのruntime equivalentと同じ形式であり、長い値のタイムスタンプを出力する必要があります。
store フィールド値は_sourceフィールドから別々に保存および取得可能であるべきですか？trueまたはfalse（デフォルト）を受け入れます。
meta フィールドに関するメタデータ。

エポック秒

日付をエポックからの秒として送信する必要がある場合は、formatがepoch_secondをリストしていることを確認してください：

Python

  1. resp = client.indices.create(
  2.    index="my-index-000001",
  3.    mappings={
  4.    "properties": {
  5.    "date": {
  6.    "type": "date",
  7.    "format": "strict_date_optional_time||epoch_second"
  8.    }
  9.    }
  10.    },
  11. )
  12. print(resp)
  14. resp1 = client.index(
  15.    index="my-index-000001",
  16.    id="example",
  17.    refresh=True,
  18.    document={
  19.    "date": 1618321898
  20.    },
  21. )
  22. print(resp1)
  24. resp2 = client.search(
  25.    index="my-index-000001",
  26.    fields=[
  27.    {
  28.    "field": "date"
  29.    }
  30.    ],
  31.    source=False,
  32. )
  33. print(resp2)

Ruby

  1. response = client.indices.create(
  2.   index: 'my-index-000001',
  3.   body: {
  4.    mappings: {
  5.    properties: {
  6.    date: {
  7.    type: 'date',
  8.    format: 'strict_date_optional_time||epoch_second'
  9.    }
  10.    }
  11.    }
  12.   }
  13. )
  14. puts response
  16. response = client.index(
  17.   index: 'my-index-000001',
  18.   id: 'example',
  19.   refresh: true,
  20.   body: {
  21.    date: 1_618_321_898
  22.   }
  23. )
  24. puts response
  26. response = client.search(
  27.   index: 'my-index-000001',
  28.   body: {
  29.    fields: [
  30.    {
  31.    field: 'date'
  32.    }
  33.    ],
  34.    _source: false
  35.   }
  36. )
  37. puts response

Js

  1. const response = await client.indices.create({
  2.   index: "my-index-000001",
  3.   mappings: {
  4.    properties: {
  5.    date: {
  6.    type: "date",
  7.    format: "strict_date_optional_time||epoch_second",
  8.    },
  9.    },
  10.   },
  11. });
  12. console.log(response);
  14. const response1 = await client.index({
  15.   index: "my-index-000001",
  16.   id: "example",
  17.   refresh: "true",
  18.   document: {
  19.    date: 1618321898,
  20.   },
  21. });
  22. console.log(response1);
  24. const response2 = await client.search({
  25.   index: "my-index-000001",
  26.   fields: [
  27.    {
  28.    field: "date",
  29.    },
  30.   ],
  31.   _source: false,
  32. });
  33. console.log(response2);

コンソール

  1. PUT my-index-000001
  2. {
  3.   "mappings": {
  4.    "properties": {
  5.    "date": {
  6.    "type":   "date",
  7.    "format": "strict_date_optional_time||epoch_second"
  8.    }
  9.    }
  10.   }
  11. }
  13. PUT my-index-000001/_doc/example?refresh
  14. { "date": 1618321898 }
  16. POST my-index-000001/_search
  17. {
  18.   "fields": [ {"field": "date"}],
  19.   "_source": false
  20. }

次のような日付が返されます：

コンソール-結果

  1. {
  2.   "hits": {
  3.    "hits": [
  4.    {
  5.    "_id": "example",
  6.    "_index": "my-index-000001",
  7.    "_score": 1.0,
  8.    "fields": {
  9.    "date": ["2021-04-13T13:51:38.000Z"]
  10.    }
  11.    }
  12.    ]
  13.   }
  14. }

合成 _source

合成_sourceは、一般的にTSDBインデックス（index.modeがtime_seriesに設定されているインデックス）でのみ利用可能です。他のインデックスでは、合成_sourceは技術プレビュー中です。技術プレビューの機能は、将来のリリースで変更または削除される可能性があります。Elasticは問題を修正するために努力しますが、技術プレビューの機能は公式GA機能のサポートSLAの対象ではありません。 

  2. 合成ソースは常に`````date`````フィールドをソートします。例えば：
  5. #### Python
  7. ``````python
  8. resp = client.indices.create(
  9.    index="idx",
  10.    mappings={
  11.    "_source": {
  12.    "mode": "synthetic"
  13.    },
  14.    "properties": {
  15.    "date": {
  16.    "type": "date"
  17.    }
  18.    }
  19.    },
  20. )
  21. print(resp)
  23. resp1 = client.index(
  24.    index="idx",
  25.    id="1",
  26.    document={
  27.    "date": [
  28.    "2015-01-01T12:10:30Z",
  29.    "2014-01-01T12:10:30Z"
  30.    ]
  31.    },
  32. )
  33. print(resp1)
  34. `

Ruby

  1. response = client.indices.create(
  2.   index: 'idx',
  3.   body: {
  4.    mappings: {
  5.    _source: {
  6.    mode: 'synthetic'
  7.    },
  8.    properties: {
  9.    date: {
  10.    type: 'date'
  11.    }
  12.    }
  13.    }
  14.   }
  15. )
  16. puts response
  18. response = client.index(
  19.   index: 'idx',
  20.   id: 1,
  21.   body: {
  22.    date: [
  23.    '2015-01-01T12:10:30Z',
  24.    '2014-01-01T12:10:30Z'
  25.    ]
  26.   }
  27. )
  28. puts response

Js

  1. const response = await client.indices.create({
  2.   index: "idx",
  3.   mappings: {
  4.    _source: {
  5.    mode: "synthetic",
  6.    },
  7.    properties: {
  8.    date: {
  9.    type: "date",
  10.    },
  11.    },
  12.   },
  13. });
  14. console.log(response);
  16. const response1 = await client.index({
  17.   index: "idx",
  18.   id: 1,
  19.   document: {
  20.    date: ["2015-01-01T12:10:30Z", "2014-01-01T12:10:30Z"],
  21.   },
  22. });
  23. console.log(response1);

コンソール

  1. PUT idx
  2. {
  3.   "mappings": {
  4.    "_source": { "mode": "synthetic" },
  5.    "properties": {
  6.    "date": { "type": "date" }
  7.    }
  8.   }
  9. }
  10. PUT idx/_doc/1
  11. {
  12.   "date": ["2015-01-01T12:10:30Z", "2014-01-01T12:10:30Z"]
  13. }

次のようになります：

コンソール-結果

  1. {
  2.   "date": ["2014-01-01T12:10:30.000Z", "2015-01-01T12:10:30.000Z"]
  3. }