Hologres:日付および時刻関数

TO_CHAR

• 説明:

  • タイムスタンプを文字列に変換します。デフォルトでは、1925 年から 2282 年までの時点を表すタイムスタンプのみを変換できます。

    TO_CHAR(TIMESTAMP|TIMESTAMPTZ, TEXT)

    使用上の注意:

    • この関数を使用して、タイムスタンプを 24 時間制または 12 時間制の文字列に変換できます。HH24 は 24 時間制を、HH12 は 12 時間制を示します。デフォルトでは、12 時間制が使用されます。

    • YYYY は年に対応し、MM は月、DD は日、HH は時、MI は分、SS は秒に対応します。

    • Hologres V1.1.31 以降では、SQL 文の前に set hg_experimental_functions_use_pg_implementation = 'to_char'; または set hg_experimental_functions_use_pg_implementation = 'to_char,to_date,to_timestamp'; を実行して、すべての時間範囲をサポートできます。

      説明

      上記のステートメントのいずれかを実行して GUC パラメーターを設定すると、クエリのパフォーマンスが約 50% 低下します。Hologres V1.1.42 以降では、クエリのパフォーマンスが約 20% 低下します。

  • 整数を文字列に変換します。

    TO_CHAR(INT, TEXT)

  • 実数または倍精度浮動小数点数を文字列に変換します。

    TO_CHAR(DOUBLE PRECISION, TEXT)

• 戻り値:

  TEXT 型の値が返されます。

• 例:

  • タイムスタンプを 24 時間制の文字列に変換します。

    -- 戻り値: 13:48:30.
    SELECT TO_CHAR(current_timestamp, 'HH24:MI:SS');
    
    -- 戻り値: 2024-08-05.
    SELECT TO_CHAR(current_timestamp, 'YYYY-MM-DD');

  • タイムスタンプを 12 時間制の文字列に変換します。

    -- 戻り値: 01:50:42 PM.
    SELECT TO_CHAR(current_timestamp, 'HH12:MI:SS AM');
    
    -- 戻り値: 12:30:00 AM.
    SELECT TO_CHAR(time '00:30:00', 'HH12:MI:SS AM');

  • 次の結果が返されます。

    CREATE TABLE time_test(
      a text,
      b TIMESTAMPTZ );
    INSERT INTO time_test VALUES ('2001-09-28 03:00:00','2004-10-19 10:23:54+08');
    
    -- 戻り値：10:23:54。
    SELECT TO_CHAR(b, 'HH24:MI:SS') FROM time_test;
    
    -- TEXT 型の値を日付に変換します。戻り値：2001-09-28。
    SELECT TO_CHAR(to_timestamp(a, 'YYYY-MM-DD'),'YYYY-MM-DD')FROM time_test;

  • タイムスタンプを別のタイムゾーンの文字列に変換します。

    CREATE TABLE timestamptz_test(
      a TIMESTAMPTZ);
    
    INSERT INTO timestamptz_test VALUES ('2023-03-21 10:23:54+02');

    • タイムゾーンが指定されていない場合、a フィールドのタイムスタンプ値は UTC+8 タイムゾーンを使用する文字列に変換されます。

      -- 戻り値: 2023-03-21 16:23:54.
      SELECT TO_CHAR(a, 'YYYY-MM-DD HH24:MI:SS') FROM timestamptz_test;

    • a フィールドのタイムスタンプ値を UTC-5 タイムゾーンを使用する文字列に変換します。

      -- 戻り値: 2023-03-21 04:23:54.
      SELECT TO_CHAR(a at time zone 'US/Eastern', 'YYYY-MM-DD HH24:MI:SS') FROM timestamptz_test;

  • 整数を文字列に変換します。

    -- 戻り値: 125.
    SELECT TO_CHAR(125, '999');

  • 倍精度浮動小数点数を文字列に変換します。

    -- 戻り値: 125.8.
    SELECT TO_CHAR(125.8::real, '999D9');

TO_DATE

• 説明: 文字列を日付に変換します。デフォルトでは、1925 年から 2282 年までの日付を表す文字列のみを変換できます。

  TO_DATE(<text_date> TEXT, <format_mask> TEXT)

• 使用上の注意:

  Hologres V1.1.31 以降では、SQL 文の前に set hg_experimental_functions_use_pg_implementation = 'to_date'; または set hg_experimental_functions_use_pg_implementation = 'to_char,to_date,to_timestamp'; を実行して、すべての時間範囲をサポートできます。

  説明

  上記のステートメントのいずれかを実行して GUC パラメーターを設定すると、クエリのパフォーマンスが約 50% 低下します。Hologres V1.1.42 以降では、クエリのパフォーマンスが約 20% 低下します。

• パラメーター:

  • text_date: 必須。変換する文字列。

  • format_mask: 必須。日付形式。

• 戻り値:

  TEXT 型の値が返されます。

• 例:

  • 文字列を日付に変換します。

    -- 戻り値: 2000-12-05.
    SELECT TO_DATE('05 Dec 2000', 'DD Mon YYYY');
    
    -- 戻り値: 2001-03-24.
    SELECT TO_DATE('2001 03 24', 'YYYY-MM-DD');

  • TEXT データ型のフィールドの値を日付に変換します。

    CREATE TABLE time_test(a TEXT);
    INSERT INTO time_test VALUES ('2001-0928 03:00:00');
    SELECT TO_DATE(a, 'YYYY-MM-DD') FROM time_test;

    次の結果が返されます。

      to_date
    ------------
     2001-09-28

TO_TIMESTAMP

• 説明:

  • 文字列をタイムスタンプに変換します。デフォルトでは、1925 年から 2282 年までの時点を表す文字列のみを変換できます。

    TO_TIMESTAMP(<text_date> TEXT, <format_mask> TEXT)

    • 使用上の注意:

      • 戻り値には +08 が含まれます。

      • Hologres V1.1.31 以降では、SQL 文の前に set hg_experimental_functions_use_pg_implementation = 'to_timestamp'; または set hg_experimental_functions_use_pg_implementation = 'to_char,to_date,to_timestamp'; を実行して、すべての時間範囲をサポートできます。

        説明

        上記のステートメントのいずれかを実行して GUC パラメーターを設定すると、クエリのパフォーマンスが約 50% 低下します。Hologres V1.1.42 以降では、クエリのパフォーマンスが約 20% 低下します。

    • パラメーター:

      • text_date: 必須。タイムスタンプに変換する文字列。

      • format_mask: 必須。タイムスタンプ形式。

  • タイムスタンプを日付に変換します。

    TO_TIMESTAMP(DOUBLE PRECISION)

    説明

    UNIX タイムスタンプは、1970 年 1 月 1 日 00:00:00 から経過した秒数を表します。

• 戻り値:

  TIMESTAMPTZ 型の値が返されます。

• 例:

  • 文字列をタイムスタンプに変換します。

    SELECT TO_TIMESTAMP('05 Dec 2000', 'DD Mon YYYY');

    次の結果が返されます。

          to_timestamp
    ------------------------
     2000-12-05 00:00:00+08

  • TEXT データ型の文字列をタイムスタンプに変換します。

    CREATE TABLE time_test(a TEXT);
    INSERT INTO time_test VALUES ('2001-09-28 03:00:00');
    SELECT TO_TIMESTAMP(a, 'YYYY-MM-DD') FROM time_test;

    次の結果が返されます。

          to_timestamp
    ------------------------
     2001-09-28 00:00:00+08

  • 秒単位の UNIX タイムスタンプを日付に変換します。

    -- 戻り値: 1975-03-06 03:38:16+08.
    SELECT TO_TIMESTAMP(163280296);

  • ミリ秒単位の UNIX タイムスタンプを日付に変換します。

    -- 戻り値: 2021-09-28 12:22:41+08.
    SELECT TO_TIMESTAMP(1632802961000/1000);

MAKE_DATE

• 説明: 年、月、日で構成される日付を作成します。デフォルトでは、1925 年から 2282 年までの時点を表す日付と時刻の値のみがサポートされています。

  MAKE_DATE(<year> INT, <month> INT, <day> INT)

• 使用上の注意:

  Hologres V2.0.29 以降でこの関数がサポートされています。この関数は、入力パラメーターとして定数をサポートしていません。

• 戻り値:

  DATE 型の値が返されます。

• 例:

  -- 戻り値: 2013-07-15.
  SELECT MAKE_DATE(2013, 7, 15);

  次の結果が返されます。

  make_date
  ------------
   2013-07-15

DATEADD

• 説明: 指定された日付と時刻の値に、指定された時間単位に基づいて間隔を加算または減算します。デフォルトでは、1925 年から 2282 年までの時点を表す日付と時刻の値のみがサポートされています。

  DATEADD(<d> DATE|TIMESTAMP|TIMESTAMPTZ, <num> BIGINT, <str> TEXT)

• 使用上の注意:

  次のバージョンの Hologres インスタンスでこの関数がサポートされています。

  • V2.0.31 から V2.1.0

  • V2.1.13 以降

  説明

  この関数は、入力パラメーターとして定数をサポートしていません。

• パラメーター:

  • d: 必須。元の日付と時刻の値。

  • num: 必須。加算または減算する間隔。

  • str: 必須。指定された時間単位。有効な値: yyyy、year、mm、month、mon、dd、day、hh、hour、mi、ss。

• 戻り値:

  DATE、TIMESTAMP、または TIMESTAMPTZ 型の値が返されます。

• 例:

  CREATE TABLE test_dateadd (a TIMESTAMP);
  INSERT INTO test_dateadd VALUES ('2005-02-28 00:00:00');
  
  -- 指定された日付と時刻の値に 1 か月を追加します。
  SELECT DATEADD(a , 1, 'mm') FROM test_dateadd;

  次の結果が返されます。

         dateadd
  ---------------------
   2005-03-28 00:00:00

ADD_MONTHS

• 説明: 指定した日付と時刻の値に特定の月数を追加します。この関数は Oracle と互換性があります。この関数を使用する前に、Orafce 拡張機能をインストールする必要があります。詳細については、「サポートされている Oracle 関数」をご参照ください。

  ADD_MONTHS(<d> DATE, <month> INT)

• パラメーター:

  • d: 必須。元の日付。

  • month: 必須。元の日付に追加する整数。

• 戻り値:

  DATE 型の値が返されます。

• 例:

  SELECT ADD_MONTHS(current_date, 2);

  次の結果が返されます。

   add_months
  ------------
   2024-10-05

DATEDIFF

• 説明: 2 つの日付またはタイムスタンプの差を計算します。デフォルトでは、1925 年から 2282 年までの時点を表す日付と時刻の値のみがサポートされています。

  DATEDIFF(<d1> DATE|TIMESTAMP|TIMESTAMPTZ, <d2> DATE|TIMESTAMP|TIMESTAMPTZ, <str> TEXT)

• 使用上の注意:

  次のバージョンの Hologres インスタンスでこの関数がサポートされています。

  • V2.0.31 から V2.1.0

  • V2.1.13 以降

  説明

  この関数の入力パラメーターは、すべて定数にすることはできません。

• パラメーター:

  • d1: 必須。最初の日付またはタイムスタンプ。

  • d2: 必須。2 番目の日付またはタイムスタンプ。

  • str: 必須。時間差の計算の基になる時間単位。有効な値: yyyy、year、mm、month、mon、dd、day、hh、hour、mi、ss。

• 戻り値:

  BIGINT 型の値が返されます。指定された時間単位の時間差が 1 未満の場合、デフォルトで値 0 が返されます。

  たとえば、この関数を使用して、時間単位 year に基づいて 2023-12-31 と 2024-01-01 の差を計算すると、値 0 が返されます。

  説明

  前述のシナリオで関数が 1 を返すようにするには、SQL 文の前に set hg_experimental_datediff_use_presto_impl = off; を実行して、この GUC パラメーターを無効にします。

• 例:

  CREATE TABLE test_datediff (a TIMESTAMP);
  INSERT INTO test_datediff VALUES ('2005-02-28 00:00:00');
  
  -- 2 つの日付の差を分で計算します。
  SELECT DATEDIFF(a , '2005-03-02 00:00:00', 'mi') FROM test_datediff;

  次の結果が返されます。

   datediff
  ----------
      -2880

MONTHS_BETWEEN

• 説明: 2 つの日付の間の月数を返します。この関数は Oracle と互換性があります。この関数を使用する前に、Orafce 拡張機能をインストールする必要があります。詳細については、「サポートされている Oracle 関数」をご参照ください。

  MONTHS_BETWEEN(DATE, DATE)

• 戻り値:

  INT 型の値が返されます。

• 例:

  • 例 1:

    -- 戻り値: 2.
    SELECT MONTHS_BETWEEN('2022-01-01', '2021-11-01');

  • 例 2:

    -- 戻り値: -2.
    SELECT MONTHS_BETWEEN('2021-11-01', '2022-01-01');

NEXT_DAY

• 説明: 指定した日付より後の、指定した曜日の最初の日付を返します。この関数は Oracle と互換性があります。この関数を使用する前に、Orafce 拡張機能をインストールする必要があります。詳細については、「サポートされている Oracle 関数」をご参照ください。

  NEXT_DAY(<d> DATE, <str> TEXT|INT)

• パラメーター:

  • d: 必須。指定した日付。

  • str: 必須。曜日を表す文字列。例: Friday。このパラメーターは、曜日を表す数値に設定することもできます。数値の範囲は 1 から 7 です。値 1 は日曜日を、値 2 は月曜日を示します。同様に、値 7 は土曜日を示します。

• 戻り値:

  DATE 型の値が返されます。

• 例:

  • 例 1:

    -- 戻り値: 2022-05-06.
    SELECT NEXT_DAY('2022-05-01', 'FRIDAY');

  • 例 2:

    -- 戻り値: 2022-05-06.
    SELECT NEXT_DAY('2022-05-01', 5);

日付と時刻の加算: +

SELECT date '2001-09-28' + integer '7';

SELECT current_date+ integer '3 ';

SELECT to_char(current_date+ interval '1 day','yyyy-mm-dd');

SELECT date '2001-09-28' + time '03:00';

SELECT date '2001-09-28' + interval '1 hour';

SELECT now()+interval '1 day';

SELECT now()+interval '1 month';

 SELECT now()+interval '2 year';

日付と時刻の減算: -

SELECT date '2001-10-01' - date '2001-09-28';

SELECT date '2001-10-01' - integer '7';

SELECT date '2001-09-28' - time '03:00';

 SELECT date '2001-09-28' - interval '1 hour';

SELECT now()-interval '2 day';

日付と時刻の乗算: *

SELECT 21 * interval '3 day';

日付と時刻の除算: /

SELECT interval '1 hour' / double precision '1.5';

日付と時刻の切り捨て関数

CURRENT_DATE

• 説明: 現在の日付を返します。

  CURRENT_DATE

• 戻り値:

  DATE 型の値が返されます。

• 例:

  SELECT CURRENT_DATE;

  次の結果が返されます。

   current_date
  --------------
   2024-08-08

CURRENT_TIMESTAMP

• 説明: 現在のトランザクションの開始時刻を返します。この関数は TRANSACTION_TIMESTAMP 関数または NOW 関数と同等です。

  CURRENT_TIMESTAMP

  説明

  戻り値は、トランザクションのライフサイクル中は変更されません。

• 戻り値:

  TIMESTAMPTZ 型の値が返されます。

• 例:

  SELECT CURRENT_TIMESTAMP;

  次の結果が返されます。

         current_timestamp
  -------------------------------
   2024-08-08 14:55:11.006068+08

CLOCK_TIMESTAMP

• 説明: 現在の日付と時刻を返します。

  clock_timestamp()

  説明

  変更は、単一のコマンド内でも行うことができます。

• 戻り値:

  TIMESTAMPTZ 型の値が返されます。

• 例:

  SELECT clock_timestamp();

  次の結果が返されます。

          clock_timestamp
  -------------------------------
   2024-08-08 14:57:43.569109+08

LOCALTIMESTAMP

• 説明: タイムゾーン情報を含まない現在の時刻を返します。

  LOCALTIMESTAMP

• 戻り値:

  TIMESTAMPTZ 型の値が返されます。

• 例:

  SELECT LOCALTIMESTAMP;

  次の結果が返されます。

        localtimestamp
  ---------------------------
   2024-08-08 15:00:59.13245

NOW

• 説明: 現在のトランザクションの開始時刻を返します。この関数は TRANSACTION_TIMESTAMP 関数または CURRENT_TIMESTAMP 関数と同等です。

  NOW()

  説明

  戻り値は、トランザクションのライフサイクル中は変更されません。

• 戻り値:

  TIMESTAMPTZ 型の値が返されます。

• 例:

  SELECT NOW();

  次の結果が返されます。

                now
  -------------------------------
   2024-08-08 15:02:50.270501+08

STATEMENT_TIMESTAMP

• 説明: 現在のステートメントの開始時刻を返します。

  STATEMENT_TIMESTAMP()

  説明

  戻り値は、関数が使用されているトランザクションのステートメントによって異なります。

• 戻り値:

  TIMESTAMPTZ 型の値が返されます。

• 例:

  SELECT STATEMENT_TIMESTAMP();

  次の結果が返されます。

        statement_timestamp
  -------------------------------
   2024-08-08 15:06:14.772939+08

TIMEOFDAY

• 説明: 現在の日付と時刻を返します。この関数は CLOCK_TIMESTAMP 関数に似ています。TIMEOFDAY 関数によって返される値は、フォーマットされたテキスト文字列です。

  TIMEOFDAY()

• 戻り値:

  TEXT 型の値が返されます。

• 例:

  SELECT TIMEOFDAY();

  次の結果が返されます。

                timeofday
  -------------------------------------
   Thu Aug 08 15:08:16.599369 2024 CST

TRANSACTION_TIMESTAMP

• 説明: 現在のトランザクションの開始時刻を返します。この関数は CURRENT_TIMESTAMP 関数または NOW 関数と同等です。

  TRANSACTION_TIMESTAMP()

  説明

  戻り値は、トランザクションのライフサイクル中は変更されません。

• 戻り値:

  TIMESTAMPTZ 型の値が返されます。

• 例:

  SELECT TRANSACTION_TIMESTAMP();

  次の結果が返されます。

       transaction_timestamp
  -------------------------------
   2024-08-08 15:11:10.329005+08

ISFINITE

• 説明:

  • DATE 型の日付が有限数であるかどうかを確認します。

    ISFINITE(DATE)

  • タイムスタンプが有限数であるかどうかを確認します。

    ISFINITE(TIMESTAMP)

• 戻り値:

  BOOLEAN 型の値が返されます。日付またはタイムスタンプが有限数の場合、値 true（t）が返され、日付またはタイムスタンプが有限数でない場合、値 false（f）が返されます。

• 例:

  • 例 1:

    SELECT ISFINITE(date '2001-02-16');

    次の結果が返されます。

     isfinite
    ----------
     t

  • 例 2:

    SELECT ISFINITE(timestamp '2001-02-16 21:28:30');

    次の結果が返されます。

     isfinite
    ----------
     t