関数早見表 | 統計解析ソフト Stata

日付と時間の関数

　データをインポートした際に日付値が文字列型で読み込まれた時や日次の日付値を月次に変換したい場合など日付値を操作するには日時関数を使用します。
　日次の日付値は1960年1月1日からの経過日数が格納されます。このため、関数の戻り値をそのまま出力した場合、整数値が表示されます。日付を確認する場合は、表示形式を指定する必要があります。
　使用例では、displayコマンドで表示形式を指定していますが、変数に対して表示形式を指定するにはformatコマンドを使用します。

項番	関数	説明	使用例
1	`date`(引数1 , 引数2)	年月日の文字列から日次の日付値を算出します。引数1: 年月日を表す文字列引数2: 年月日の並びを指定する文字列	`display date("2023/1/1", "YMD") display %td_CCYY/NN/DD date("2023/1/1", "YMD")`
2	`mdy`(引数1 , 引数2 , 引数3)	月、日、年の順に数値を指定して、日付値を算出します。引数1: 月(1~12) 引数2: 日(1~12) 引数3: 年(1800~2100)	`display mdy(1,2,2023) display %td_CCYY/NN/DD mdy(1,2,2023)`
3	`age`(引数1 , 引数2 )	生年月日と基準日を指定して、基準日における年齢（整数）を返します。引数1: 生年月日引数2: 基準日	`display age(dmy(10,10,2000), dmy(11,11,2020))`
4	`age_frac`(引数1 , 引数2 )	生年月日と基準日を指定して、基準日における年齢（実数）を返します。引数1: 生年月日引数2: 基準日	`display age_frac(dmy(10,10,2000), dmy(11,11,2020))`
5	`Clock`(引数1 , 引数2 )	年月日と時間を指定してうるう秒を考慮した日時値を算出します。引数1: 年月日と時間を表す文字列引数2: 年月日と時間の並びを指定する文字列	`display Clock("2023/12/31 23:59:59","YMDhms") display %tC Clock("2023/12/31 23:59:59","YMDhms")`
6	`clock`(引数1 , 引数2 )	年月日と時間を指定してうるう秒を考慮していない日時値を算出します。引数1: 年月日と時間を表す文字列引数2: 年月日と時間の並びを指定する文字列	`display clock("2023/12/31 23:59:59","YMDhms") display %tc clock("2023/12/31 23:59:59","YMDhms")`
7	`Cofc`(引数1)	うるう秒を考慮していない日時値を指定して、うるう秒を考慮した日時値を算出します。引数1: 日時値	`display %tC Cofc(clock("2023/12/31 23:59:59","YMDhms"))`
8	`Cofd`(引数1)	日付値を指定して、うるう秒を考慮した日時値を算出します。引数1: 日次の日付値	`display %tC Cofd(date("2023/12/1","YMD"))`
9	`day`(引数1)	日付値を指定して、日を取り出します。引数1: 日次の日付値	`display day(date("2023/12/15","YMD"))`
10	`dow`(引数1)	日付値を指定して、曜日を返します。日曜日: 0, 月曜日: 1, …, 土曜日:6 引数1: 日次の日付値	`display dow(date("2023/11/15","YMD"))`
11	`doy`(引数1)	日付値を指定して、その年の何日目かを返します。引数1: 日次の日付値	`display doy(date("2023/12/30","YMD"))`
12	`hh`(引数1)	日時値を指定して、時間を返します。引数1: うるう秒を考慮していない日時値 ※うるう秒を考慮した日時値に対してはhhC関数を使用します。	`display hh(clock("2023/12/31 23:59:59","YMDhms")) display hhC(Clock("2023/12/31 23:59:59","YMDhms"))`
13	`mdyhms`(引数1, 引数2, …, 引数6)	年、月、日、時、分、秒を指定して、日時値を返します。引数1: 月引数2: 日引数3: 年引数4: 時引数5: 分引数6: 秒	`display %tc mdyhms(9,25,2025,12,45,30)`
14	`mm`(引数1)	日時値を指定して、分を返します。引数1: うるう秒を考慮していない日時値 ※うるう秒を考慮した日時値に対してはmmC関数を使用します。	`display mm(clock("2023/12/31 23:59:59","YMDhms")) display mmC(Clock("2023/12/31 23:59:59","YMDhms"))`
15	`mofd`(引数1)	日次の日付値を指定して、月次の日付値を返します。引数1:日次の日付値	`display %tm mofd(date("2024/2/20","YMD"))`
16	`month`(引数1)	日次の日付値を指定して、月を返します。引数1: 日次の日付値	`display month(date("2024/2/20","YMD"))`

数学関数

　変数を対数変換する場合や四捨五入の処理など数学的な処理を行うには数学関数を使用します。

項番	関数	説明	使用例
1	`abs`(引数1)	xの絶対値を返します。引数1: x (実数)	`display abs(1.5) display abs(-1.5)`
2	`ceil`(引数1)	xの値以上の最小の整数を返します。引数1: x (実数)	`display ceil(1.5) display ceil(99)`
3	`comb`(引数1, 引数2)	異なるn個からk個を選ぶときの組合せの総数を返します。引数1: n (正の整数) 引数2: k (0以上n以下の整数)	`display comb(5,2)`
4	`exp`(引数1)	指数関数 e^x の値を返します。引数1: x (実数)	`display exp(2)`
5	`expm1`(引数1)	e^x - 1 の値を返します。引数1: x (実数)	`display expm1(2)`
6	`floor`(引数1)	xの値以下の最大の整数を返します。引数1: x (実数)	`display floor(2.5)`
7	`ln`(引数1)	xの自然対数を返します。引数1: x (0より大きい実数)	`display ln(7)`
8	`ln1p`(引数1)	x + 1 の自然対数を返します。引数1: x (-1より大きい実数)	`display ln1p(7)`
9	`log10`(引数1)	xの常用対数を返します。引数1: x (0より大きい実数)	`display log10(7)`
10	`max`(引数1, 引数2, ...)	指定した複数の引数の中で欠損値を除いて最大の値を返します。引数: 実数	`display max(3,7,1,-4,0,10,.,2)`
11	`min`(引数1, 引数2, ...)	指定した複数の引数の中で欠損値を除いて最小の値を返します。引数: 実数	`display min(3,7,1,-4,0,10,.,2)`
12	`mod`(引数1, 引数2)	xをyで割ったときの余りを返します。引数1: x (実数) 引数2: y (0以上の実数)	`display mod(100, 3)`
13	`round`(引数1, 引数2)	xをyの単位で丸めた値を返します。引数1: x (実数) 引数2: y (実数)	`display round(1.4142, 0.01)`
14	`sign`(引数1)	xが負であれば-1、xが0であれば0、xが正であれば1、 xが欠損値であれば欠損値を返します。引数1: x (実数)	`display sign(-300) display sign(600)`
15	`sqrt`(引数1)	xの平方根を返します。引数1: x (0以上の実数)	`display sqrt(100)`
16	`sum`(引数1)	generateコマンドで使用します。例：generate y = sum(x) 変数yにはxの累積和が格納されます。引数1: 変数名 ※egenコマンドのsum関数は総和を格納します。	`sysuse auto generate y = sum(price) browse price y`

項番

関数

説明

使用例

abs(引数1)

xの絶対値を返します。
引数1: x (実数)

display abs(1.5)
display abs(-1.5)

ceil(引数1)

xの値以上の最小の整数を返します。
引数1: x (実数)

display ceil(1.5)
display ceil(99)

comb(引数1, 引数2)

異なるn個からk個を選ぶときの組合せの総数を返します。
引数1: n (正の整数)
引数2: k (0以上n以下の整数)

display comb(5,2)

exp(引数1)

指数関数 e^x の値を返します。
引数1: x (実数)

display exp(2)

expm1(引数1)

e^x - 1 の値を返します。
引数1: x (実数)

display expm1(2)

floor(引数1)

xの値以下の最大の整数を返します。
引数1: x (実数)

display floor(2.5)

ln(引数1)

xの自然対数を返します。
引数1: x (0より大きい実数)

display ln(7)

ln1p(引数1)

x + 1 の自然対数を返します。
引数1: x (-1より大きい実数)

display ln1p(7)

log10(引数1)

xの常用対数を返します。
引数1: x (0より大きい実数)

display log10(7)

max(引数1, 引数2, ...)

指定した複数の引数の中で欠損値を除いて最大の値を返します。
引数: 実数

display max(3,7,1,-4,0,10,.,2)

min(引数1, 引数2, ...)

指定した複数の引数の中で欠損値を除いて最小の値を返します。
引数: 実数

display min(3,7,1,-4,0,10,.,2)

mod(引数1, 引数2)

xをyで割ったときの余りを返します。
引数1: x (実数)
引数2: y (0以上の実数)

display mod(100, 3)

round(引数1, 引数2)

xをyの単位で丸めた値を返します。
引数1: x (実数)
引数2: y (実数)

display round(1.4142, 0.01)

sign(引数1)

xが負であれば-1、xが0であれば0、xが正であれば1、
xが欠損値であれば欠損値を返します。
引数1: x (実数)

display sign(-300)
display sign(600)

sqrt(引数1)

xの平方根を返します。
引数1: x (0以上の実数)

display sqrt(100)

sum(引数1)

generateコマンドで使用します。
例：generate y = sum(x)
変数yにはxの累積和が格納されます。
引数1: 変数名
※egenコマンドのsum関数は総和を格納します。

sysuse auto
generate y = sum(price)
browse price y

文字列関数

　文字列から一部の文字を抽出したり、文字数をカウントするなど文字列を操作するには文字列関数を使用します。

項番	関数	説明	使用例
1	`real`(引数1)	引数1で指定した文字列を数値または欠損値に変換します。引数1: 文字列	`display real("123") display real("abc")`
2	`string`(引数1)	引数1で指定した数値を文字列に変換します。引数1: 数値	`display string(123)`
3	`strlen`(引数1)	引数1で指定した文字列(ASCII)の文字数またはバイト単位の長さを返します。引数1: 文字列	`display strlen("abcdefg")`
4	`ustrlen`(引数1)	引数1で指定した文字列(Unicode)の文字数を返します。引数1: 文字列	`display ustrlen("あいうえお")`
5	`stritrim`(引数1)	引数1で指定した文字列の連続する空白を1つの空白に置換した文字列を返します。引数1: 文字列	`display stritrim("hello there")`
6	`strmatch`(引数1, 引数2)	引数1で指定した文字列が引数2で指定した文字列のパターンに合っていれば１を、合っていなければ0を返します。引数1: 文字列引数2: 文字列 ※引数2では任意の一字を「?」で、　空白を含む任意の文字列を「*」で表して　パターンを指定します。	`display strmatch("17.4","1??4") display strmatch("17.4","1*4")`
7	strpos(引数1, 引数2)	引数1で指定した文字列(ASCII)において引数2で指定した文字列(ASCII)が始めに現れる位置を返します。引数1: 文字列引数2: 文字列	`display strpos("this","is")`
8	ustrpos(引数1, 引数2)	引数1で指定した文字列(Unicode)において引数2で指定した文字列(Unicode)が始めに現れる位置を返します。引数1: 文字列引数2: 文字列	`display ustrpos("引数1と引数2には文字列を指定します。","引数")`
9	strrpos(引数1, 引数2)	引数1で指定した文字列(ASCII)において引数2で指定した文字列(ASCII)が最後に現れる位置を返します。引数1: 文字列引数2: 文字列	`display strrpos("this is","is")`
10	ustrrpos(引数1, 引数2)	引数1で指定した文字列(Unicode)において引数2で指定した文字列(Unicode)が最後に現れる位置を返します。引数1: 文字列引数2: 文字列	`display ustrrpos("引数1と引数2には文字列を指定します。","引数")`
11	strrtrim(引数1)	引数1で指定した文字列(ASCII)の空白を除外します。引数1: 文字列	`display strrtrim("this ")`
12	ustrrtrim(引数1)	引数1で指定した文字列(Unicode)の空白を除外します。引数1: 文字列	`display ustrrtrim("引数1と引数2には文字列を指定します。　　")`
13	subinstr(引数1, 引数2, 引数3, 引数4)	引数1で指定した文字列において、引数2で指定した文字列を検索し、引数3で指定した文字列に置き換えます。引数1の文字列の先頭から検索を始め、引数4で指定した回数だけ置換します。引数1: 文字列	`display subinstr("引数1と引数2と引数3と引数4","引数","index",3)`

項番

関数

説明

使用例

real(引数1)

引数1で指定した文字列を数値または欠損値に変換します。
引数1: 文字列

display real("123")
display real("abc")

string(引数1)

引数1で指定した数値を文字列に変換します。
引数1: 数値

display string(123)

strlen(引数1)

引数1で指定した文字列(ASCII)の文字数または
バイト単位の長さを返します。
引数1: 文字列

display strlen("abcdefg")

ustrlen(引数1)

引数1で指定した文字列(Unicode)の文字数を返します。
引数1: 文字列

display ustrlen("あいうえお")

stritrim(引数1)

引数1で指定した文字列の連続する空白を1つの空白に
置換した文字列を返します。
引数1: 文字列

display stritrim("hello     there")

strmatch(引数1, 引数2)

引数1で指定した文字列が引数2で指定した文字列のパターンに
合っていれば１を、合っていなければ0を返します。
引数1: 文字列
引数2: 文字列
※引数2では任意の一字を「?」で、
　空白を含む任意の文字列を「*」で表して
　パターンを指定します。

display strmatch("17.4","1??4")
display strmatch("17.4","1*4")

strpos(引数1, 引数2)

引数1で指定した文字列(ASCII)において引数2で指定した
文字列(ASCII)が始めに現れる位置を返します。
引数1: 文字列
引数2: 文字列

display strpos("this","is")

ustrpos(引数1, 引数2)

引数1で指定した文字列(Unicode)において引数2で指定した
文字列(Unicode)が始めに現れる位置を返します。
引数1: 文字列
引数2: 文字列

display ustrpos("引数1と引数2には文字列を指定します。","引数")

strrpos(引数1, 引数2)

引数1で指定した文字列(ASCII)において引数2で指定した
文字列(ASCII)が最後に現れる位置を返します。
引数1: 文字列
引数2: 文字列

display strrpos("this is","is")

ustrrpos(引数1, 引数2)

引数1で指定した文字列(Unicode)において引数2で指定した
文字列(Unicode)が最後に現れる位置を返します。
引数1: 文字列
引数2: 文字列

display ustrrpos("引数1と引数2には文字列を指定します。","引数")

strrtrim(引数1)

引数1で指定した文字列(ASCII)の空白を除外します。
引数1: 文字列

display strrtrim("this ")

ustrrtrim(引数1)

引数1で指定した文字列(Unicode)の空白を除外します。
引数1: 文字列

display ustrrtrim("引数1と引数2には文字列を指定します。　　")

subinstr(引数1, 引数2, 引数3, 引数4)

引数1で指定した文字列において、
引数2で指定した文字列を検索し、
引数3で指定した文字列に置き換えます。
引数1の文字列の先頭から検索を始め、
引数4で指定した回数だけ置換します。
引数1: 文字列

display subinstr("引数1と引数2と引数3と引数4","引数","index",3)

プログラム関数

　Stataでは推定コマンドを実行する際にif条件文で観測行を制限できます。その際に知っておくと便利な2つの関数をご紹介します。

項番	関数	説明	使用例
1	`inlist`(引数1, 引数2, ...)	引数1で指定した変数の値が、 2番目以降の引数に含まれる場合に1を返し、含まれない場合0を返します。引数1: 変数名引数2以降: 値	`webuse auto gen repair = inlist(rep78, 1,2,3) table rep78 repair`
2	`inrange`(引数1, 引数2, 引数3)	引数1で指定した変数において、引数2以上かつ引数3以下の値の場合に1を返し、それ以外の場合0を返します。引数1: 変数名引数2: 下限値引数3: 上限値	`webuse auto gen repair = inrange(rep78, 2, 4) table rep78 repair`

項番

関数

説明

使用例

inlist(引数1, 引数2, ...)

引数1で指定した変数の値が、
2番目以降の引数に含まれる場合に1を返し、
含まれない場合0を返します。
引数1: 変数名
引数2以降: 値

webuse auto
gen repair = inlist(rep78, 1,2,3)
table rep78 repair

inrange(引数1, 引数2, 引数3)

引数1で指定した変数において、
引数2以上かつ引数3以下の値の場合に1を返し、
それ以外の場合0を返します。
引数1: 変数名
引数2: 下限値
引数3: 上限値

webuse auto
gen repair = inrange(rep78, 2, 4)
table rep78 repair

統計関数

　さまざまな確率分布における密度関数、累積分布関数、逆関数をご紹介します。

項番	関数	説明	使用例
1	`betaden`(引数1, 引数2, 引数3)	引数1と2にベータ分布の母数を指定します。引数3に0以上1以下の値を指定します。引数3で指定した値の確率密度を返します。引数1: 正の実数引数2: 正の実数引数3: 0以上1以下の値	`display betaden(1,5, 0.5) twoway function y = betaden(2,2,x)`
2	`ibeta`(引数1, 引数2, 引数3)	引数1と2にベータ分布の母数を指定します。引数3で指定した値における累積ベータ分布の値を返します。引数1: 正の実数引数2: 正の実数引数3: 0以上1以下の値	`display ibeta(2,2, 0.5) twoway function y = ibeta(2,2,x)`
3	`ibetatail`(引数1, 引数2, 引数3)	引数1と2にベータ分布の母数を指定します。引数3で指定した値におけるベータ分布の上側確率を返します。引数1: 正の実数引数2: 正の実数引数3: 0以上1以下の値	`display ibetatail(2,2, 0.6)`
4	`invibeta`(引数1, 引数2, 引数3)	引数1と2にベータ分布の母数を指定します。引数3で指定した確率に対応する値を返します。引数1: 正の実数引数2: 正の実数引数3: 確率	`display invibeta(2,2, 0.95)`
5	`normalden`(引数1, 引数2, 引数3)	引数2と3に正規分布の母数を指定します。引数1に値を指定します。引数1で指定した値の確率密度を返します。引数1: 値引数2: 期待値引数3: 標準偏差	`display normalden(1.96, 0, 1) twoway function y = betaden(2,2,x)`
6	`normal`(引数1)	引数1で指定した値における累積標準正規分布の値を返します。引数1: 値	`display normal(1.96)`
7	`invnormal`(引数1)	累積標準正規分において、引数1で指定した確率に対応する値を返します。引数1: 確率	`display invnormal(0.975)`

項番

関数

説明

使用例

betaden(引数1, 引数2, 引数3)

引数1と2にベータ分布の母数を指定します。
引数3に0以上1以下の値を指定します。
引数3で指定した値の確率密度を返します。
引数1: 正の実数
引数2: 正の実数
引数3: 0以上1以下の値

display betaden(1,5, 0.5)
twoway function y = betaden(2,2,x)

ibeta(引数1, 引数2, 引数3)

引数1と2にベータ分布の母数を指定します。
引数3で指定した値における累積ベータ分布の値を返します。
引数1: 正の実数
引数2: 正の実数
引数3: 0以上1以下の値

display ibeta(2,2, 0.5)
twoway function y = ibeta(2,2,x)

ibetatail(引数1, 引数2, 引数3)

引数1と2にベータ分布の母数を指定します。
引数3で指定した値におけるベータ分布の上側確率を返します。
引数1: 正の実数
引数2: 正の実数
引数3: 0以上1以下の値

display ibetatail(2,2, 0.6)

invibeta(引数1, 引数2, 引数3)

引数1と2にベータ分布の母数を指定します。
引数3で指定した確率に対応する値を返します。
引数1: 正の実数
引数2: 正の実数
引数3: 確率

display invibeta(2,2, 0.95)

normalden(引数1, 引数2, 引数3)

引数2と3に正規分布の母数を指定します。
引数1に値を指定します。
引数1で指定した値の確率密度を返します。
引数1: 値
引数2: 期待値
引数3: 標準偏差

display normalden(1.96, 0, 1)
twoway function y = betaden(2,2,x)

normal(引数1)

引数1で指定した値における累積標準正規分布の値を返します。
引数1: 値

display normal(1.96)

invnormal(引数1)

累積標準正規分において、
引数1で指定した確率に対応する値を返します。
引数1: 確率

display invnormal(0.975)

Stata関数早見表

日付と時間の関数

数学関数

文字列関数

プログラム関数

統計関数