ROUND (日付/時刻)
2 つの入力引数を指定すると、この形式の ROUND 関数は、2 番目の入力引数 (形式) で指定された値に丸められた最初の入力引数の値を返します。
構文
ROUND (input_arg, format)
備考
| • | 入力引数は、キーワード DATE または TIME または TIMESTAMP に、切り捨てる日付/時刻式を含む引用符で囲まれた文字列を加えたものです。 |
| • | format 引数が存在しない場合、次のようになります。 |
| — | TIMESTAMP は、時刻が 00:00:00 の日に切り上げまたは切り捨てます。 |
| — | DATE または TIMESTAMP の日付部分は変更されません。 |
| — | TIME または TIMESTAMP の時間部分は、00:00 の分と秒を使用して、指定された時間または次の時間に切り捨てられます。 |
| • | オプションの 2 番目の引数 format は STRING です。その値を下の表に示します。この引数では大文字と小文字が区別されません。 |
|
フォーマット引数 |
出力とコメント |
|
CC |
xx50 の 1 月 1 日から始まり、次の世紀の初日に切り上げられます。xx49 の 12 月 31 日までは、現在の世紀の初日に切り捨てられます。たとえば、2050-01-01 は 2101-01-01 に丸められます。2049-12-31 は 2001-01-01 に丸められます。 |
|
SYEAR, SYYYY |
年。7 月 1 日から翌年に切り上げます。 |
|
IYYY、IYY、IY、I |
ISO 年の初日の日付。ISO 年 (ISO 8601 標準) は、1 月の第1 木曜日を含む週の月曜日に始まります。早ければ前年の 12/29 から、遅くとも今年の 01/04 まで開始できます。 |
|
Q |
現在の四半期の最初の日の日付 (四半期の 2番目の月の 15 日まで)。四半期の第2 月の 16 日から始まり、次の四半期の初日に切り上げられます。 |
|
MONTH、MON、MM、RM |
当月の初日の日付 (15 日目まで)。その月の 16 日から始まり、翌月の 1 日に切り上げられます。 |
|
WW |
年の最初の日と同じ曜日の日付。 |
|
IW |
ISO 年は常に月曜日に始まるため、最初の引数が月曜日から水曜日の場合、現在の週の月曜日の日付。最初の引数が木曜日から日曜日の場合は、翌週の月曜日の日付。 |
|
W |
月の最初の日と同じ曜日の日付。 |
|
DDD、DD、J |
12:00:00 (正午) 以降は、翌日の日付に切り上げます。11:59:59 以前の場合、または DATE の場合は、現在の日付に切り捨てられます。 |
|
DAY、DY、D |
週の開始日。つまり、現在の日付が含まれている週の日曜日の日付です。 |
|
IDDD |
ISO の年の日。年の 1 日目は最初の ISO 週の月曜日です。範囲は 001〜371 です。 |
|
ID |
ISO の曜日。月曜日= 1 および日曜日= 7。 |
|
HH、HH12、HH24 |
1 時間プラス 30 分以降の場合は、次の 1 時間に切り上げられます。 |
|
MI |
分プラス 30秒以降の場合、次の分に切り上げられます。 |
例
この表は、ROUND の例と、そのフォーマット定義および結果の一部を示しています。
|
SELECT Statement |
結果 |
ROUND (TIMESTAMP '1949-12-31 00:00:00', 'cc') |
1901-01-01 00:00:00 |
ROUND (DATE '1950-01-01', 'cc') |
2001-01-01 |
ROUND (timestamp '1983-07-01 15:59:31','Y') |
1984-01-01 00:00:00 |
ROUND (date '1983-06-30', 'y') |
1983-01-01 |
ROUND (timestamp '2015-03-06 15:59:31','i') |
2014-12-29 00:00:00 |
ROUND (date '2015-03-06', 'i') |
2014-12-29 |
ROUND (timestamp '1983-03-06 15:59:31','q') |
1983-01-01 00:00:00 |
ROUND (date '1983-03-06', 'Q') |
1983-01-01 |
ROUND (timestamp '1983-03-06 12:34:56', 'mm') |
1983-03-01 00:00:00 |
ROUND (date '1983-03-06', 'mm') |
1983-03-01 |
ROUND (timestamp '2015-06-08 12:34:56', 'ww') |
2015-06-11 00:00:00 |
ROUND (date '2015-06-08', 'ww') |
2015-06-11 |
ROUND (timestamp '2015-06-07 12:34:56', 'ww') |
2015-06-04 00:00:00 |
ROUND (date '2015-06-107', 'ww') |
2015-06-04 |
ROUND (timestamp '2015-06-10 12:34:56', 'ddd') |
2015-06-10 00:00:00 |
ROUND (date '2015-06-10', 'ddd') |
2015-06-10 |
ROUND (TIMESTAMP '2015-06-10 12:34:56', 'hh') |
2015-06-10 12:00:00 |
ROUND (time '12:34:56', 'hh') |
12:00:00 |
ROUND (TIMESTAMP '2015-06-10 12:34:56', 'mi') |
2015-06-10 12:34:00 |
ROUND (time '12:34:56', 'mi') |
12:34:00 |