RETAIL

構文

目的

これらのファンクションは、National Retail Federation (NRF)の4-5-4カレンダを使用して、指定されたレベルのメンバーを一意に識別するVARCHAR2値を戻します。

各小売ファンクションは、特定のレベルの暗黙的階層内のメンバーを一意に識別するVARCHAR2値を戻します。このため、NLS_DATE_FORMAT、NLS_TIMESTAMP_FORMATおよびNLS_TIMESTAMP_TZ_FORMATはこれらのファンクションには適用されません。それぞれに独自のデフォルト書式があります。これらのファンクションは、NLS_DATE_LANGUAGEの設定を尊重します。

dtexprは、DATE、TIMESTAMP、TIMESTAMP WITH TIME ZONE、TIMESTAMP WITH LOCAL TIME ZONEのいずれかの型(または暗黙的にDATEに変換できる任意の値)を持つ日時式です。
fmtは、書式文字列を表すテキスト式です。すべての場合で、書式指定子の大文字と小文字の区別は、TO_CHARと同じ動作に従います。たとえば、MONは省略形式の月を大文字で指定し(例: JAN)、monは省略形式の月名を小文字で指定し(例: jan)、Monは省略形式の月名を先頭大文字(例: Jan)で指定します。
すべての小売ファンクションには、53週間が必要な年の処理方法を制御するオプションのis_restatedパラメータがあります。

is_restatedパラメータは、 RESTATEDまたはNOT RESTATED (大/小文字を区別しない)に解決する必要があるテキスト式です。通常、小売年には52週(364日)のみが含まれます。したがって、5年または6年ごとに53週目が追加されます。これは、修正再表示されていないカレンダであり、is_restatedパラメータがNOT RESTATED (デフォルト)の場合に生成されます。一部のユーザーは、比較目的で52週間を含むすべての年を希望します。このようなカレンダは、修正再表示されたカレンダと呼ばれ、is_restatedパラメータがRESTATEDの場合に生成されます。
nlsparamは、NLSパラメータ設定を表すテキスト式です。現在サポートされているパラメータはNLS_DATE_LANGUAGEのみで、TO_CHARおよびTO_DATEと同じ方法で指定されます。

小売ファンクションの書式

次の表に、各ファンクションの書式文字列を示します。必要な書式は書式文字列のどこかに指定する必要があり、存在しない場合はエラーが発生します。オプションの書式は、書式文字列で指定できます。他のすべての書式指定子は禁止されており、含まれる場合はエラーが発生します。デフォルトの書式文字列は、RYという接頭辞が付いた年を持つカレンダ階層の文字列と似ています。小売カレンダは日曜日から始まる週によって意図的に定義されるため、デフォルトの日書式では日と月ではなく曜日と週番号が使用されます。

表7-8 小売ファンクションの書式

ファンクション	必要な書式	オプションの書式	デフォルト書式文字列
`RETAIL_YEAR`	`YYYY`または`SYYYY`	なし	`"RY"SYYYY` 例: `RY2024`
`RETAIL_QUARTER`	`YYYY`または`SYYYY` `Q`	なし	`"Q"Q-"RY"SYYYY` 例: `Q1-RY2024`
`RETAIL_MONTH`	`YYYY`または`SYYYY` `MM、mon、MONTH`のいずれか	`Q`	`MON-"RY"SYYYY` 例: `JAN-RY2024`
`RETAIL_WEEK`	`YYYY`または`SYYYY` `WW`	なし	`"W"WW-"RY"SYYYY` 例: `W01-RY2024`
`RETAIL_DAY`	`YYYY`または`SYYYY` `WW`および次のいずれか: `DY` `DAY` `DD`および次のいずれか `MM` `MON` `MONTH` `DDD`	`Q`	`DY-"W"WW-"RY"SYYYY` 例: `SUN-W01-RY2024`

小売ファンクションの書式の説明

次の表に、小売階層の書式指定子の解釈を示します。すべての数値書式は小売年内で相対的であることに注意してください。年と月は、NRF 4-5-4カレンダによって定義されます。MON、MONTH、DYおよびDAYの大文字化ルールは、すべて小文字(month => juneなど)、大文字(MONTH => JUNEなど)および先頭大文字(Month => Juneなど)に関して他の場所(TO_CHARなど)での使用方法に従います。

表7-9 小売ファンクションの書式の説明

書式指定子	説明
`YYYY`	4桁の小売年(正の年のみサポート)
`SYYYY`	4桁の小売年、BC年は負数
`Q`	小売年の四半期(1から4)
`MM`	小売年の月(1から12)。小売月のカレンダ年に対応します。たとえば、小売年2025では、2月(小売年の最初の月)は2月2日に始まり、3月1日に終了します。その月のすべての日の`MON`/`MONTH`は`FEB`/`FEBRUARY`であるため、`MM`は`Feb`に対応する`02`です。カレンダの詳細は、NRFを参照してください。
`MON`	月の名前の省略形
`MONTH`	月の名前
`WW`	週番号(1から53)、2桁。4-5-4カレンダは7*52=364日の年になるため、53週目を追加することが必要になる場合があります。カレンダの詳細は、NRFを参照してください。
`DY`	曜日の省略形
`DAY`	曜日
`D`	曜日(1から7)。`NLS_TERRITORY`によって異なります
`DD`	小売月内の日付(1から31)、2桁。たとえば、小売年2025は2月2日に開始します。これは月の最初の日であるため、その日のDD値は01になります。
`DDD`	小売年内の年(1から371)、3桁