INTTEST関数

時間間隔が有効な場合は1、時間間隔が無効な場合は0を返します。

カテゴリ:

日付と時間

構文

必須引数

詳細

例

構文

INTTEST(interval <<multiple.<shift-index>>>)

必須引数

interval

WEEK、MONTHまたはQTRなどの間隔名を含む文字定数、変数または式を指定します。intervalは、大文字または小文字で表示できます。intervalに使用可能な値のリストについては、Intervals Used with Date and Time Functions (SAS言語リファレンス: 解説編)を参照してください。

より複雑な間隔を指定するには、基本間隔名に乗数とシフトインデックスを組み合わせて使用できます。間隔名の一般的な形式を次に示します。

interval<multiple.shift-index>

間隔名の3つの部分は次のとおりです。

interval

基本間隔の種類の名前を指定します。たとえば、YEARで年間隔を指定します。

multiple

乗数を指定します(省略可能)。基本タイプの間隔の期間に対する倍数と同等の間隔を設定します。たとえば、YEAR2は2年の期間で構成されます。

参照項目	乗数とシフト間隔を使用した日時の増分詳細については、を参照してください。

shift-index

シフトインデックスを指定します(省略可能)。間隔の開始時点を指定したサブ期間にシフトします。たとえば、YEAR.3では、各カレンダ年の3月1日に開始して翌年の2月末に終了するようにシフトされた年間隔を指定します。

制限事項	シフトインデックスは、間隔全体のサブ期間の数以下にする必要があります。たとえば、2年間隔では25番目の月は存在しないため、YEAR2.24は使用できますがYEAR2.25は無効です。
制限事項	デフォルトのシフト期間が間隔の種類と同じ場合、複数期間の間隔のみを任意のシフトインデックスでシフトできます。たとえば、MONTHの種類の間隔はデフォルトではMONTHのサブ期間でシフトされるため、シフトインデックスで月間隔をシフトできません。ただし、各MONTH2間隔には2つのMONTH間隔が含まれるため、シフトインデックスで2か月間隔をシフトできます。たとえば、間隔名MONTH2.2では、偶数月の1日目に開始する2か月の期間が指定されます。
参照項目	乗数とシフト間隔を使用した日時の増分詳細については、を参照してください。

詳細

INTTEST関数は、有効な間隔名を確認します。この関数は、multipleとshift-indexの有効な値を確認するときに役立ちます。詳細については、Multi-Unit Intervals (SAS言語リファレンス: 解説編)を参照してください。

INTTEST関数は、小売業界によるカレンダの間隔でも使用できます。これらの間隔はISO 8601に準拠します。詳細については、Retail Calendar Intervals: ISO 8601 Compliant (SAS言語リファレンス: 解説編)を参照してください。

例

次の例では、SASはinterval引数が有効な場合は1、interval引数が無効な場合は0を返します。

SASステートメント	結果
test1=inttest('month'); put test1;	1
test2=inttest('week6.13'); put test2;	1
test3=inttest('tenday'); put test3;	1
test4=inttest('twoweeks'); put test4;	0
var1='hour2.2'; test5=inttest(var1); put test5;	1