関数早見表 | 統計解析ソフト 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には文字列を指定します。　　")`

項番

関数

説明

使用例

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には文字列を指定します。　　")

Stata関数早見表

日付と時間の関数

数学関数

文字列関数