> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# date_time_* フォーマット設定

> 自動生成された date_time_* グループ内の ClickHouse フォーマット設定。

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>型</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>デフォルト値</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          再起動せずに変更可能
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

これらの設定は、[ソースコード](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/FormatFactorySettings.h) から自動生成されています。

<div id="date_time_64_output_format_cut_trailing_zeros_align_to_groups_of_thousands">
  ## date\_time\_64\_output\_format\_cut\_trailing\_zeros\_align\_to\_groups\_of\_thousands
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

datetime64値の末尾のゼロを動的に削除し、出力スケールを \[0, 3, 6] に調整します。
これはそれぞれ 'seconds'、'milliseconds'、'microseconds' に対応します

<div id="date_time_input_format">
  ## date\_time\_input\_format
</div>

<SettingsInfoBlock type="DateTimeInputFormat" default_value="best_effort" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "best_effort"},{"label": "使い勝手の向上"}]}]} />

日付と時刻のテキスト表現を解釈するパーサーを選択できます。

この設定は、[日付と時刻を扱う関数](/docs/ja/reference/functions/regular-functions/date-time-functions)には適用されません。

設定可能な値:

* `'best_effort'` — 拡張パースを有効にします。

  ClickHouse は、基本的な `YYYY-MM-DD HH:MM:SS` フォーマットと、すべての [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) の日付・時刻フォーマットをパースできます。たとえば、`'2018-06-08T01:02:03.000Z'` です。

* `'best_effort_us'` — `best_effort` に似ています (違いについては [parseDateTimeBestEffortUS](/docs/ja/reference/functions/regular-functions/type-conversion-functions#parseDateTimeBestEffortUS) を参照)

* `'basic'` — 基本パーサーを使用します。

  ClickHouse がパースできるのは、基本的な `YYYY-MM-DD HH:MM:SS` または `YYYY-MM-DD` フォーマットだけです。たとえば、`2019-08-20 10:18:56` または `2019-08-20` です。

関連項目:

* [DateTime データ型。](/docs/ja/reference/data-types/datetime)
* [日付と時刻を扱う関数。](/docs/ja/reference/functions/regular-functions/date-time-functions)

<div id="date_time_output_format">
  ## date\_time\_output\_format
</div>

<SettingsInfoBlock type="DateTimeOutputFormat" default_value="simple" />

日付と時刻のテキスト表現に対して、異なる出力フォーマットを選択できます。

設定可能な値:

* `simple` - シンプルな出力フォーマット。

  ClickHouse は日付と時刻を `YYYY-MM-DD hh:mm:ss` フォーマットで出力します。たとえば、`2019-08-20 10:18:56` です。計算は、データ型のタイムゾーン (存在する場合) またはサーバーのタイムゾーンに従って行われます。

* `iso` - ISO 出力フォーマット。

  ClickHouse は日付と時刻を [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) の `YYYY-MM-DDThh:mm:ssZ` フォーマットで出力します。たとえば、`2019-08-20T10:18:56Z` です。出力は UTC であることに注意してください (`Z` は UTC を意味します) 。

* `unix_timestamp` - Unix timestamp 出力フォーマット。

  ClickHouse は日付と時刻を [Unix timestamp](https://en.wikipedia.org/wiki/Unix_time) フォーマットで出力します。たとえば、`1566285536` です。

関連項目:

* [DateTime データ型](/docs/ja/reference/data-types/datetime)
* [日付と時刻を扱う関数](/docs/ja/reference/functions/regular-functions/date-time-functions)

<div id="date_time_overflow_behavior">
  ## date\_time\_overflow\_behavior
</div>

<SettingsInfoBlock type="DateTimeOverflowBehavior" default_value="ignore" />

[Date](/docs/ja/reference/data-types/date)、[Date32](/docs/ja/reference/data-types/date32)、[DateTime](/docs/ja/reference/data-types/datetime)、[DateTime64](/docs/ja/reference/data-types/datetime64)、または整数を Date、Date32、DateTime、DateTime64 に変換する際、値を変換後の型で表現できない場合の動作を定義します。

設定可能な値:

* `ignore` — オーバーフローを暗黙的に無視します。結果は未定義です。
* `throw` — オーバーフロー時に例外をスローします。
* `saturate` — 結果を飽和させます。値が対象の型で表現可能な最小値より小さい場合、結果には表現可能な最小値が設定されます。値が対象の型で表現可能な最大値より大きい場合、結果には表現可能な最大値が設定されます。

デフォルト値: `ignore`。
