> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# date_time_* フォーマット設定

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

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["バージョン", "デフォルト値", "コメント"];
  const border = "1px solid rgba(128, 128, 128, 0.3)";
  const cell = {
    border,
    padding: "0.25rem 0.5rem",
    textAlign: "start",
    verticalAlign: "top"
  };
  return <details className="not-prose" style={{
    border,
    borderRadius: "0.5rem",
    margin: "0.5rem 0",
    padding: "0.5rem 0.75rem",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <summary style={{
    cursor: "pointer",
    fontWeight: 600,
    opacity: 0.72
  }}>
        バージョン履歴
      </summary>
      <table style={{
    borderCollapse: "collapse",
    width: "100%",
    margin: "0.5rem 0 0"
  }}>
        <thead>
          <tr>
            {headers.map(header => <th key={header} style={{
    ...cell,
    fontWeight: 600,
    opacity: 0.72
  }}>
                {header}
              </th>)}
          </tr>
        </thead>
        <tbody>
          {rows.map((row, row_index) => <tr key={row.id ?? row_index}>
              {(row.items ?? []).map((item, item_index) => <td key={item_index} style={{
    ...cell,
    overflowWrap: "anywhere"
  }}>
                  {item?.label}
                </td>)}
            </tr>)}
        </tbody>
      </table>
    </details>;
};

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" />

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

この設定は、[日付と時刻を扱う関数](/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](/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 データ型。](/ja/reference/data-types/datetime)
* [日付と時刻を扱う関数。](/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 データ型](/ja/reference/data-types/datetime)
* [日付と時刻を扱う関数](/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](/ja/reference/data-types/date)、[Date32](/ja/reference/data-types/date32)、[DateTime](/ja/reference/data-types/datetime)、[DateTime64](/ja/reference/data-types/datetime64)、または整数を Date、Date32、DateTime、DateTime64 に変換する際、値を変換後の型で表現できない場合の動作を定義します。

設定可能な値:

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

デフォルト値: `ignore`。