標準日時形式データに指定された単位で丸めを行い、標準日付形式で返却します。
書式
丸め単位
以下に、指定可能な丸め単位とその結果を示します。
丸め単位 | 意味 | 標準形式の日付 | 丸め結果 |
---|---|---|---|
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日 |
例
round_datetime($日時,"QUARTER")
復帰値
変換が正常に動作した場合は、日付型を返します。
注意
引数に指定した項目参照、または日時関数の結果が空の場合には、本関数の返却値は、空となります。
引数に指定した項目参照、または日時関数の結果の形式と関数が対応していない場合には、空が返却されます。
関数名に、指定可能な丸め単位が設定されていない場合には、構文エラーとなります。
本関数を実行した結果、「年」が「9999」の翌年となる場合には、空として扱われます。