メインコンテンツまでスキップ
バージョン: 26.x

Time Zone

time_zone設定がクエリ結果、ロード、およびSHOWコマンド、システムテーブル、ツールに表示される時刻にどのように影響するかについて説明します。

タイムゾーンはいくつかの場所に現れますが、すべてが同じルールに従うわけではありません。壁時計対瞬間という区別が、残りの部分を説明します。

壁時計と瞬間​

VeloDBは2種類の時刻値を扱います：

  • 壁時計: 2026-06-26 10:00:00のようなカレンダーの読み取り値で、ゾーンは付いていません。DATEとDATETIMEカラムがこれを保存します。これは書かれた通りに正確に表示され、time_zoneによって変更されることはありません。
  • 瞬間: 1970-01-01 00:00:00 UTCからの秒数として保存される、時間内の絶対的な点です。ゾーンを選ぶまで時間や分は持ちません。now()、ロードタイムスタンプ、ジョブ時刻は瞬間です。

ゾーンは2つの間で変換する際にのみ重要です。同じ瞬間でも、各ゾーンでは異なる壁時計になります：

SET time_zone = '+00:00';     SELECT from_unixtime(1000000000); -- 2001-09-09 01:46:40
SET time_zone = 'Asia/Tokyo'; SELECT from_unixtime(1000000000); -- 2001-09-09 10:46:40

保存されたinstantは同一です。表示される時刻のみが変更されます。

タイムゾーン変数​

変数書き込み可能機能
time_zoneはいアクティブなゾーン。instantと壁時計時刻を相互変換します。
system_time_zoneいいえ（読み取り専用）起動時に検出されたサーバー自身のゾーンを報告します。情報提供用。
SELECT @@time_zone;                 -- the active zone
SET time_zone = 'America/New_York'; -- this session only
SET GLOBAL time_zone = '+00:00';    -- default for future sessions

time_zoneはsystem_time_zoneから開始されますが、変更することができます。変更しても保存されたデータには影響しません。瞬間値の変換方法のみが変更されます。

保存されたテーブルデータ​

DATEとDATETIME列は壁時計です。2026-06-26 10:00:00を書き込むと、任意のセッション、任意のtime_zoneで2026-06-26 10:00:00が読み戻されます。time_zoneを変更しても、保存された値の書き換えや再解釈は行われません。

時間関数​

これらの関数は瞬間値を壁時計との間で変換するため、セッションのtime_zoneを使用します：

関数効果
now(), current_timestamp(), curdate()現在の瞬間値をあなたのゾーンの壁時計として表示
unix_timestamp(datetime)datetimeをあなたのゾーンの壁時計として読み取り、瞬間値を返す
from_unixtime(instant)瞬間値をあなたのゾーンの壁時計に変換
convert_tz(dt, from, to)指定した2つのゾーン間で変換；time_zoneを無視

now()はクエリごとに一度固定されるため、分散クエリではどこでも同じ値が返されます。

ロード​

ほとんどのロード方法は独自のtimezoneを受け入れるため、ロードは固定ゾーンで受信datetimeを解析できます。省略すると、ロードはセッションのtime_zoneを使用します。

ロード方法設定方法
Stream Loadtimezone HTTPヘッダー。Stream Loadを参照。
Broker Load / S3 LoadPROPERTIES内のtimezone。Broker Loadを参照。
Routine LoadジョブPROPERTIES内のtimezone。Routine Loadを参照。
MySQL Loadtimezoneプロパティ。MySQL Loadを参照。
curl --location-trusted -u <user>:<password> \
    -H "timezone: America/New_York" \
    -T data.csv \
    http://<host>:<port>/api/<db>/<table>/_stream_load

INSERT、SELECT INTO OUTFILE、および EXPORT にはロード毎のオプションがありません。最初にセッションで time_zone を設定してください。

SHOWコマンドとシステムテーブルでの時刻​

ジョブとロードメタデータ（作成時刻、一時停止時刻など）は瞬間的な値です。これらは表示するまでゾーンを持たず、ゾーンはどのように読み取るかによって決まります：

  • SHOW コマンドはセッションの time_zone を使用します。
  • システムテーブルとテーブル関数はグローバルの time_zone（SET GLOBAL time_zone）を使用し、セッション値は使用しません。

そのため、同じジョブの作成時刻が2つの方法で異なって見える場合があります：

SET time_zone = 'Asia/Tokyo';

SHOW ROUTINE LOAD;                                   -- create time in your session zone
SELECT * FROM information_schema.routine_load_jobs;  -- create time in the global zone
SELECT * FROM jobs("type"="insert");                 -- create time in the global zone

基盤となる瞬間は同じであり、表示される時刻のみが異なります。

Query audit​

audit_logテーブルは他のシステムテーブルと同じルールに従います：クエリ時刻はグローバルのtime_zoneを使用し、セッション値は使用しません。各行の時刻は一度だけテキストとして書き込まれるため、既存の行は後でグローバル設定を変更しても書き込まれた時のゾーンを保持します。

Time(ms)、CpuTimeMS、および類似の列は時刻ではなく、ミリ秒での期間です。

VeloDB Console​

Consoleは全ての時刻を閲覧者のブラウザゾーンで表示し、時間範囲ピッカーは同じゾーンでの選択を読み取ります。2つの結果：

  • 同じイベントが異なる地域の閲覧者には異なる時刻で表示されます。それでも同じ瞬間です。
  • Consoleはブラウザゾーンを使用し、SQLはtime_zoneを使用するため、Console時刻は同じ値のSQLクエリと異なる場合があります。

Consoleが表示する内容を変更するには、time_zoneではなくブラウザまたはOSゾーンを変更してください。

受け入れられるゾーン形式​

  • 名前付きゾーン: America/New_York、Europe/London、Asia/Tokyo。
  • 固定オフセット: +09:00、-05:30、+00:00。
  • エイリアス: UTCとGMTはUTCを意味します。CSTはUS CentralではなくAsia/Shanghai (+08:00)に解決されます；US Centralの場合はAmerica/Chicagoを使用してください。

名前付きゾーンは夏時間に従います。例えば、America/Los_Angelesは春に-08:00から-07:00にシフトし、秋に戻るため、同じ壁時計が年間を通して異なる瞬間にマップされます。一定のオフセットを固定してDSTをオプトアウトするには、名前付きゾーンではなく-08:00のような固定オフセットを使用してください。

一覧​

対象使用するゾーン
保存されたDATE/DATETIMEなし（書き込まれたまま表示）
now()、unix_timestamp、from_unixtimeセッションtime_zone
ロードロードのtimezone、なければセッションtime_zone
SHOWコマンドセッションtime_zone
システムテーブルとテーブル関数（routine_load_jobs、jobs()、audit_log）グローバルtime_zone
VeloDB Console閲覧者のブラウザゾーン

関連項目​