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

MILLISECONDS_SUB

デスクリプション

datetime値から指定されたミリ秒数を減算し、新しいdatetime値を返します。

Syntax

MILLISECONDS_SUB(<basetime>, <delta>)

パラメータ

パラメータ説明
<basetime>DATETIMEV2型の入力datetime値
<delta>減算するミリ秒数、INT型; 1秒 = 1,000ミリ秒 = 1,000,000マイクロ秒

戻り値

入力datetimeから指定されたミリ秒数を減算した後の時刻値を表すDATETIMEV2型の値を返します。戻り値の精度は、入力パラメータbasetimeの精度と同じです。

SELECT MILLISECONDS_SUB('2023-09-08 16:02:08.435123', 1);
+--------------------------------------------------------------------------+
| milliseconds_sub(cast('2023-09-08 16:02:08.435123' as DATETIMEV2(6)), 1) |
+--------------------------------------------------------------------------+
| 2023-09-08 16:02:08.434123 |
+--------------------------------------------------------------------------+
1 row in set (0.11 sec)

注記:

  • この例では、1ミリ秒を減算した後、時刻は.435123から.434123に減少します。
  • 1ミリ秒は1000マイクロ秒に相当します。
  • この関数の結果は入力時刻の精度に依存します。この例では小数点以下6桁の精度を使用しています。
  • 結果はマイクロ秒レベルの精度を保持します。