round_datetime関数は、標準日時形式データに指定された単位で丸めを行い、標準日付形式で返却します。
round_datetime関数の書式を以下の図に示します。
図4.25 round_datetime関数の書式
以下に、指定可能な丸め単位とその結果を示します。
丸め単位 | 意味 | 標準形式の日付 | 丸め結果 |
|---|---|---|---|
YEAR | 年で丸め | 1月1日 ～ 6月30日 | 当年の1月1日 |
7月1日 ～ 12月31日 | 翌年の1月1日 | ||
JYEAR | 年度で丸め | 4月1日 ～ 9月30日 | 当年度の4月1日 |
10月1日 ～ 3月31日 | 翌年度の4月1日 | ||
MONTH | 月で丸め | 1日 ～ 15日 | 当月の1日 |
16日 ～ 31日 | 翌月の1日 | ||
HALF | 半期で丸め | 1月1日 ～ 3月31日 | 当年の1月1日 |
4月1日 ～ 9月30日 | 当年の7月1日 | ||
10月1日 ～ 12月31日 | 翌年の1月1日 | ||
JHALF | 年度の半期で丸め | 4月1日 ～ 6月30日 | 当年の4月1日 |
7月1日 ～ 12月31日 | 当年の10月1日 | ||
翌年の1月1日 ～ 3月31日 | 翌年の4月1日 | ||
QUARTER | 四半期で丸め | 1月1日 ～ 2月15日 | 当年の1月1日 |
2月16日 ～ 5月15日 | 当年の4月1日 | ||
5月16日 ～ 8月15日 | 当年の7月1日 | ||
8月16日 ～ 11月15日 | 当年の10月1日 | ||
11月16日 ～ 12月31日 | 翌年の1月1日 |
注意
引数に指定した項目参照、または日時関数の結果が空の場合には、本関数の返却値は、空となります。
引数に指定した項目参照、または日時関数の結果の形式と関数が対応していない場合には、空が返却されます。
関数名に、指定可能な丸め単位が設定されていない場合には、構文エラーとなります。
本関数を実行した結果、「年」が「9999」の翌年となる場合には、空として扱われます。
参照
項目参照については、“3.1.9 項目参照”を参照してください。
convert_datetime関数については、“4.4.5 convert_datetime関数”を参照してください。
変換が正常に動作した場合は、日付型を返します。
$日時１“2009-12-24 09:00:00”を四半期で丸める場合
round_datetime($日時１, "QUARTER")
結果として、“2010-01-01”を出力します。
