SQL道場 日付時刻関数 DATENAME関数
SQLで日付要素を文字列で取得するDATENAME関数について記載しています。
対応データベース：SQLServer
DATENAME関数の文法
SELECT DATENAME(日付要素（datepart）,日付) FROM テーブル| 引数 | 日付要素 | 日付型 |
| 日付 | 文字列型 | |
| 返値 | nvarchar 日付要素が文字列で戻ります。 次のいずれかのデータ型に解決できる式。 ・date ・datetime ・datetimeoffset ・datetime2 ・smalldatetime ・time date の場合、DATENAME では、列式、式、文字列リテラル、ユーザー定義の変数が受け入れられます。 あいまいさの問題を排除するために、4 桁の西暦を使用してください。 2 桁の西暦については、「two digit year cutoff サーバー構成オプションの構成」を参照してください。 |
DATENAME関数は指定された日付の日付要素を文字列で戻します。SQL Server , 、DATENAME は、文字列リテラルを暗黙的にキャスト、 datetime2 型です。 つまり、DATENAME では、日付が文字列として渡される場合、YDM 形式がサポートされません。 文字列を明示的にキャストする必要があります、 datetime または smalldatetime YDM 形式を使用する型。
日付要素
| 和名 | datepart | 省略形 |
|---|---|---|
| 年 | year | yy、yyyy |
| 四半期 | quarter | qq, q |
| 月 | month | mm, m |
| 年始からの日数 | dayofyear | dy、y |
| 日 | day | dd, d |
| 週 | week | wk、ww |
| 曜日 | weekday | dw、w |
| 時 | hour | hh |
| 分 | minute | mi、n |
| 秒 | second | ss, s |
| ミリ秒 | millisecond | ms |
| マイクロ秒 | microsecond | mcs |
| ナノ秒 | nanosecond | ns |
| タイム ゾーン オフセット | TZoffset | tz |
| ISO_WEEK | ISOWK、ISOWW |
実行例
SQLServerの実行例
/* SQLServer 現在の日付と時刻を取得するサンプル */
SELECT DATENAME(WEEKDAY,'04-01-15');