Project デスクトップのユーザー設定フィールドの Project の関数

これらの関数は、ユーザー設定フィールドの値を計算するために計算式で使用します。

Project の関数の概要

Microsoft Project を使用するときは、フィールドに直接格納されない値の操作が必要になる場合があります。 計算式を使うと、フィールドを操作して、これらの新しい値を作成することができます。

次の例では、ユーザー設定フィールドで計算式を使用する方法について説明します。

• ユーザー設定の数値フィールドに追加すると、次の式では、スケジュール内のタスクの現在の日付と終了日の間の日数を示す数値が返されます。

DateDiff("d",NOW(),[Finish])

• ユーザー設定の数値フィールドに追加すると、次の式では、"No baseline"、"Overbudget by 20% or more" または "Under budget" の値が返されます。

  Switch(Len(CStr([Baseline Finish]))<3, "No baseline", ([Cost]+1)/ ([Baseline Cost]+1)>1.2,"Overbudget by 20% or more", ([Cost]+1)/([Baseline Cost]+1)>1, "Overbudget",True,"Under budget")
  The CStr function in the above formula works only if the [Baseline Finish] field is defined.
  
  

変換関数

Asc

文字列内にある先頭文字に対応する文字コードを示す整数型 (Integer) の値を返します。

構文

Asc(文字列)

文字列 任意の有効な文字列式。

CBool

式をブール型 (Boolean) に変換します。

構文

CBool(式)

式 任意の有効な文字列式または数値式。

CByte

式をバイト型 (Byte) に変換します。

構文

CByte(式)

式 0 から 255 までの任意の 整数 。

CCur

式を通貨型 (Currency) に変換します。

構文

CCur(式)

式 -922,337,203,685,477.5808 から 922,337,203,685,477.5807 までの数値式。

CDate

式を日付型 (Date) に変換します。

構文

CDate(式)

式 任意の有効な日付式。

CDbl

式を倍精度浮動小数点数型 (Double) に変換します。

構文

CDbl(式)

式 負の値の -1.79769313486232E308 から -4.94065645841247E-324 までの数値式。正の値の場合は 4.94065645841247E-324 から 1.79769313486232E308 になります。

CDec

式を 10 進型 (Decimal) に変換します。

構文

CDec(式)

式 +/-79,228,162,514,264,337,593,543,950,335 の範囲の数値式 (スケール ゼロの数、つまり小数点以下の桁数がない数値)。 小数点以下 28 桁の数値の場合、-7.9228162514264337593543950335 ～ 7.9228162514264337593543950335。 最小値は 0 を除いた場合、0.0000000000000000000000000001 です。

Chr

指定した文字コードに対応する文字を示す文字列型 (String) の値を返します。

構文

Chr(文字コード)

charcode 文字を識別する Long 。

CInt

式を整数型 (Integer) に変換します。

構文

CInt(式)

式 -32,768 から 32,767 までの数値式。分数は丸められます。

CLng

式を長整数型 (Long) に変換します。

構文

CLng(式)

式 -2,147,483,648 から 2,147,483,647 までの数値式。分数は丸められます。

CSng

式を単精度浮動小数点数型 (Single) に変換します。

構文

CSng(式)

式 負の値の場合は -3.402823E38 から -1.401298E-45 までの任意の数値式。正の値の場合は 1.401298E-45 から 3.402823E38 になります。

CStr

式を文字列型 (String) に変換します。

構文

CStr(式)

式 任意の有効な文字列式または数値式。

CVar

式をバリアント型 (Variant) に変換します。

構文

CVar(式)

式 数値の Double と同じ範囲。 数値以外の場合は文字列型の範囲と同じです。

DateSerial

指定した年、月、日に対応するバリアント型 (内部処理形式 Date の Variant) の値を返します。

構文

DateSerial( year, month, day )

year 必須; 整数。 年を表す 100 ～ 9999 の範囲の数値または数式を指定します。

month 必須; 整数。 任意の数式を指定します。

day 必須; 整数。 任意の数式を指定します。

DateValue

日付を表すバリアント型 (内部処理形式 Date の Variant) の値を返します。

構文

DateValue( date )

日付 必須;通常、100 年 1 月 1 日から 9999 年 12 月 31 日までの日付を表す文字列式。 また、日付には、この範囲内の日付か時刻、またはその両方を表す任意の式を指定することもできます。

Day

月の何日かを表す 1 ～ 31 の範囲の整数をバリアント型 (内部処理形式 Integer の Variant) で返します。

構文

Day(日付)

日付 必須;日付を表すことができる任意の バリアント、数値式、文字列式、または任意の組み合わせ。 日付が Null の場合は、Null 値が返されます。

Hex

数値を 16 進で表した文字列型 (String) の値を返します。

構文

Hex(数値)

number 必須;任意の有効な文字列または数値式。

Hour

1 日の時刻を表す 0 ～ 23 の範囲の整数をバリアント型 (内部処理形式 Integer の Variant) で返します。

構文

Hour( time )

time 必須;時間を表すことができる任意の バリアント、数値式、文字列式、または任意の組み合わせ。 時刻が Null の場合は、Null 値が返されます。

Minute

時刻の分を表す 0 ～ 59 の範囲の整数を表すバリアント型 (内部処理形式 Integer の Variant) の値を返します。

構文

Minute( time )

time 必須;時間を表すことができる任意の バリアント、数値式、文字列式、または任意の組み合わせ。 時刻が Null の場合は、Null 値が返されます。

Month

1 年の何月かを表す 1 ～ 12 の範囲の整数をバリアント型 (内部処理形式 Integer の Variant) で返します。

構文

Month(日付)

日付 必須;時間を表すことができる任意の バリアント、数値式、文字列式、または任意の組み合わせ。 日付が Null の場合は、Null 値が返されます。

Oct

バリアント型 (内部処理形式 String の Variant) の値を返します。数値を 8 進数で示します。

構文

Oct(数値)

number 必須;任意の有効な文字列または数値式。

ProjDateConv

値を日付に変換します。

構文

ProjDateConv(式, 日付形式)

式必須;バリアント。 日付に変換する式を指定します。

DateFormat 省略可能; 長い。 既定値は pjDateDefault ですが、次のいずれかの pjDateFormat 定数に置き換えることができます (日付形式の例は 2007/09/25 午後 12:33 に対して適用されます)。

• pjDateDefault: 既定の形式です。 [オプション] ダイアログ ボックスの [表示] タブで設定します ([ツール] メニュー)。
• pjDate_mm_dd_yy_hh_mmAM: 07/09/25 午後 12:33
• pjDate_mm_dd_yy: 07/09/25
• pjDate_mm_dd_yyyy: 2007/09/25
• pjDate_mmmm_dd_yyyy_hh_mmAM: 2007 年 09 月 25 日 午後 12:33
• pjDate_mmmm_dd_yyyy: 2007 年 09 月 25 日
• pjDate_mmm_dd_hh_mmAM: 09 月 25 日 午後 12:33
• pjDate_mmm_dd_yyy: 平成 19 年 09 月 25 日
• pjDate_mmmm_dd: 09 月 25 日
• pjDate_mmm_dd: Sep 25
• pjDate_ddd_mm_dd_yy_hh_mmAM: 07/09/25 (火) 午後 12:33
• pjDate_ddd_mm_dd_yy: 07/09/25 (火)
• pjDate_ddd_mmm_dd_yyy: 平成 19 年 09 月 25 日 火曜日
• pjDate_ddd_hh_mmAM: 火曜日 午後 12:33
• pjDate_mm_dd: 09/25
• pjDate_dd: 25
• pjDate_hh_mmAM: 午後 12:33
• pjDate_ddd_mmm_dd: Sep 25 Tue
• pjDate_ddd_mm_dd: 09/25 (火)
• pjDate_ddd_dd: 25 (火)
• pjDate_Www_dd: W40/2
• pjDate_Www_dd_yy_hh_mmAM: 07/W40/2 午後 12:33

ProjDurConv

式を指定された単位の期間値に変換します。

構文

ProjDurConv(式,期間単位)

式必須;バリアント。 期間に変換する式を指定します。

durationunits 省略可能; 長い。 期間の単位を示します。 期間単位を省略した場合は、[オプション] ダイアログ ボックスの [スケジュール] タブにある [入力時の期間単位] ボックスで指定した単位が既定値として適用されます ([ツール] メニュー)。 期間単位には、次のいずれかの pjFormatUnit クラスの定数を指定できます。

• pjMinutes: pjElapsedMinutes
• pjHours: pjElapsedHours
• pjDays: pjElapsedDays
• pjWeeks: pjElapsedWeeks
• pjMonths: pjElapsedMonths
• pjMinutesEstimated: pjElapsedMinutesEstimated
• pjHoursEstimated: pjElapsedHoursEstimated
• pjDaysEstimated: pjElapsedDaysEstimated
• pjWeeksEstimated: pjElapsedWeeksEstimated
• pjMonthsEstimated: pjElapsedMonthsEstimated

Second

時刻の秒を表す 0 ～ 59 の範囲の整数をバリアント型 (内部処理形式 Integer の Variant) で返します。

構文

Second( time )

time 必須;時間を表すことができる任意の バリアント、数値式、文字列式、または任意の組み合わせ。 時刻が Null の場合は、Null 値が返されます。

Str

数を示すバリアント型 (内部処理形式 String の Variant) の値を返します。

構文

Str(数値)

number 必須;有効な数式を含む Long 長い数式。

StrConv

指定した文字列を変換して、バリアント型 (内部処理形式 String の Variant) で返します。

構文

StrConv(文字列,変換方法,LCID)

文字列 必須;変換する文字列式。

変換 必須; 整数。 変換方法を指定する値の合計を指定します。

LCID 省略可能;システム LocaleID と異なる場合は LocaleID。 (既定値はシステム LocaleID)

TimeSerial

指定した時間、分、秒に対応する時刻をバリアント型 (内部処理形式 Date の Variant) で返します。

構文

TimeSerial( hour, minute, second )

hour 必須; バリアント (整数)。 時を表す 0 (12:00 AM) ～ 23 (11:00 PM) の範囲の数値または数式を指定します。

minute 必須; バリアント (整数)。 任意の数式を指定します。

second 必須; バリアント (整数)。 任意の数式を指定します。

TimeValue

時刻を表すバリアント型 (内部処理形式 Date の Variant) の値を返します。

構文

TimeValue(時刻)

time 必須;通常、0:00:00 (午前 12:00:00) から 23:59:59 (午後 11:59:59) までの時間を表す文字列式。 ただし、時刻には、この範囲内の時刻を表す任意の式を指定することもできます。 時刻が Null の場合は、Null 値が返されます。

Val

文字列に含まれる数値を、適切なデータ型の数値で返します。

構文

Val(文字列)

文字列 必須;任意の有効な文字列式。

Weekday

何曜日であるかを表す整数をバリアント型 (内部処理形式 Integer の Variant) で返します。

構文

Weekday(日付[,週の最初の曜日])

日付 必須;日付を表すことができる、バ リアント、数値式、任意の組み合わせの文字列式。 日付が Null の場合は、Null 値が返されます。

firstdayofweek 省略可能;週の最初の曜日を指定する定数。 省略すると、日曜日を指定したものと見なされます。

Year

年を表す整数をバリアント型 (内部処理形式 Integer の Variant) で返します。

構文

Year( date )

日付 必須;日付を表すことができる任意の バリアント、数値式、文字列式、または任意の組み合わせ。 日付が Null の場合は、Null 値が返されます。

日付と時刻の関数

CDate

式を日付型 (Date) に変換します。

構文

CDate(式)

式 任意の有効な日付式。

日付

現在のシステムの日付を含むバリアント型 (内部処理形式 Date の Variant) の値を返します。

構文

日付

DateAdd

指定された時間間隔を加算した日付をバリアント型 (内部処理形式 Date の Variant) の値で返します。

構文

DateAdd(間隔,数値,日付)

interval 必須;追加する時間間隔の文字列式 ("m" や "d" など)。

number 必須;追加する間隔の数である数値式。 正の値 (将来の日付を取得する場合) または負の値 (過去の日付を取得する場合) を指定できます。

日付 必須;間隔が追加される日付を表す バリアント (Date) またはリテラル。

DateDiff

2 つの指定した日付の時間間隔を表すバリアント型 (内部処理形式 Long の Variant) の値を指定します。

構文

DateDiff(間隔,日付 1,日付 2[,週の最初の曜日[,年の最初の週]])

interval 必須; Date1 と Date2 の差分を計算するために使用する時間間隔である文字列式。

date1, date2 必須; バリアント (日付) 計算の対象となる 2 つの日付を指定します。

firstdayofweek 省略可能;週の最初の曜日を指定する定数。 省略すると、日曜日を指定したものと見なされます。

firstweekofyear 省略可能;年の最初の週を指定する定数。 省略すると、1 月 1 日を含む週が第 1 週と見なされます。

DatePart

日付の指定した部分を含むバリアント型 (内部処理形式 Integer の Variant) の値を返します。

構文

DatePart( interval, date[, firstdayofweek[, firstweekofyear]] )

interval 必須;返す時間間隔である文字列式。

日付 必須;評価する バリアント (日付) 値。

firstdayofweek 省略可能;週の最初の曜日を指定する定数。 省略すると、日曜日を指定したものと見なされます。

firstweekofyear 省略可能;年の最初の週を指定する定数。 省略すると、1 月 1 日を含む週が第 1 週と見なされます。

DateSerial

指定した年、月、日に対応するバリアント型 (内部処理形式 Date の Variant) の値を返します。

構文

DateSerial( year, month, day )

year 必須; 整数。 年を表す 100 ～ 9999 の範囲の数値または数式を指定します。

month 必須; 整数。 任意の数式を指定します。

day 必須; 整数。 任意の数式を指定します。

DateValue

日付を表すバリアント型 (内部処理形式 Date の Variant) の値を返します。

構文

DateValue(日付)

日付 必須;通常、100 年 1 月 1 日から 9999 年 12 月 31 日までの日付を表す文字列式。 また、日付には、この範囲内の日付か時刻、またはその両方を表す任意の式を指定することもできます。

Day

月の何日かを表す 1 ～ 31 の範囲の整数をバリアント型 (内部処理形式 Integer の Variant) で返します。

構文

Day(日付)

日付 必須;日付を表すことができる任意の バリアント、数値式、文字列式、または任意の組み合わせ。 日付が Null の場合は、Null 値が返されます。

Hour

1 日の時刻を表す 0 ～ 23 の範囲の整数をバリアント型 (内部処理形式 Integer の Variant) で返します。

構文

Hour( time )

time 必須;時間を表すことができる任意の バリアント、数値式、文字列式、または任意の組み合わせ。 時刻が Null の場合は、Null 値が返されます。

IsDate

式を日付に変換できるかどうかを調べ、結果をブール型 (Boolean) で返します。

構文

IsDate(式)

式 必須;日付または時刻として認識可能な日付式または文字列式を含む任意の バリアント 。

Minute

時刻の分を表す 0 ～ 59 の範囲の整数を表すバリアント型 (内部処理形式 Integer の Variant) の値を返します。

構文

Minute(時刻)

time 必須;時間を表すことができる任意の バリアント、数値式、文字列式、または任意の組み合わせ。 時刻が Null の場合は、Null 値が返されます。

Month

1 年の何月かを表す 1 ～ 12 の範囲の整数をバリアント型 (内部処理形式 Integer の Variant) で返します。

構文

Month(日付)

日付 必須;時間を表すことができる任意の バリアント、数値式、文字列式、または任意の組み合わせ。 日付が Null の場合は、Null 値が返されます。

Now

コンピューターのシステムの日付と時刻の設定に基づいて、現在の日付と時刻を表すバリアント型 (内部処理形式 Date の Variant) の値を返します。

構文

現在

ProjDateAdd

ある日付にある期間を追加して、新しい日付を返します。

構文

ProjDateAdd(日付, 期間, カレンダー)

日付必須;バリアント。 期間を追加する基点となる日付です。

duration必須;バリアント。 日付に追加する期間です。

カレンダー 省略可能; 文字列。 新しい日付の計算に使用するカレンダーを指定します。 カレンダーを省略すると、現在のリソースにはリソース カレンダーが既定のカレンダーとして適用され、現在のタスクにはタスク カレンダーか、標準カレンダー (タスク カレンダーがない場合) が既定のカレンダーとして適用されます。 Project Server の場合、カレンダーの文字列型で指定されたカレンダーに関係なく、標準カレンダーが使用されます。 Project Web App で作成された数式でこの関数を使用し、Project Professional で作成された同じ数式と比較するときは、期待どおりの結果を確実にするためにテストする必要があります。

ProjDateConv

値を日付に変換します。

構文

ProjDateConv(式, 日付形式)

式必須;バリアント。 日付に変換する式を指定します。

DateFormat 省略可能; 長い。 既定値は pjDateDefault ですが、次のいずれかの pjDateFormat 定数に置き換えることができます (日付形式の例は 2007/09/25 午後 12:33 に対して適用されます)。

• pjDateDefault: 既定の形式です。 [オプション] ダイアログ ボックスの [表示] タブで設定します ([ツール] メニュー)。
• pjDate_mm_dd_yy_hh_mmAM: 07/09/25 午後 12:33
• pjDate_mm_dd_yy: 07/09/25
• pjDate_mm_dd_yyyy: 2007/09/25
• pjDate_mmmm_dd_yyyy_hh_mmAM: 2007 年 09 月 25 日 午後 12:33
• pjDate_mmmm_dd_yyyy: 2007 年 09 月 25 日
• pjDate_mmm_dd_hh_mmAM: 09 月 25 日 午後 12:33
• pjDate_mmm_dd_yyy: 平成 19 年 09 月 25 日
• pjDate_mmmm_dd: 09 月 25 日
• pjDate_mmm_dd: Sep 25
• pjDate_ddd_mm_dd_yy_hh_mmAM: 07/09/25 (火) 午後 12:33
• pjDate_ddd_mm_dd_yy: 03/09/25 (火)
• pjDate_ddd_mmm_dd_yyy: 平成 19 年 09 月 25 日 火曜日
• pjDate_ddd_hh_mmAM: 火曜日 午後 12:33
• pjDate_mm_dd: 09/25
• pjDate_dd: 25
• pjDate_hh_mmAM: 午後 12:33
• pjDate_ddd_mmm_dd: Sep 25 Tue
• pjDate_ddd_mm_dd: 09/25 (火)
• pjDate_ddd_dd: 25 (火)
• pjDate_Www_dd: W40/2
• pjDate_Www_dd_yy_hh_mmAM: 07/W40/2 午後 12:33

ProjDateDiff

2 つの日付で指定された期間を分単位で取得します。

構文

ProjDateDiff( date1, date2, calendar )

date1必須;バリアント。 期間の開始日を指定します。

date2必須;バリアント。 ある期間の最後の日とする日付を指定します。

カレンダー 省略可能; 文字列。 期間を計算するときに使用するカレンダー。 calendar が指定されていない場合、現在のリソースの既定値はリソース カレンダーになります。また、現在のタスクの既定値はタスク カレンダー (タスク カレンダーがない場合は標準カレンダー) です。Project Server では、カレンダー文字列に指定されているカレンダーに関係なく、標準カレンダーが使用されます。 Project Web App で作成された数式でこの関数を使用し、Project Professional で作成された同じ数式と比較するときは、期待どおりの結果を確実にするためにテストする必要があります。

ProjDateSub

ある日付から、指定された期間をさかのぼった日付を返します。

構文

ProjDateSub(日付,期間,カレンダー)

日付必須;バリアント。 指定した期間をさかのぼる基点となる日付を指定します。

duration必須;バリアント。 日付に指定した日からさかのぼる期間を指定します。

カレンダー 省略可能; 文字列。 日付の差の計算に使用するカレンダーを指定します。 カレンダーを省略すると、現在のリソースにはリソース カレンダーが既定のカレンダーとして適用され、現在のタスクにはタスク カレンダーか、標準カレンダー (タスク カレンダーがない場合) が既定のカレンダーとして適用されます。 Project Server の場合、カレンダーの文字列型で指定されたカレンダーに関係なく、標準カレンダーが使用されます。 Project Web App で作成された数式でこの関数を使用し、Project Professional で作成された同じ数式と比較するときは、期待どおりの結果を確実にするためにテストする必要があります。

ProjDateValue

式で表される日付値を返します。

構文

ProjDateValue( expression )

式必須;バリアント。 日付を表す式を指定します。

ProjDurConv

式を指定された単位の期間値に変換します。

構文

ProjDurConv(式,期間単位)

式必須;バリアント。 期間に変換する式を指定します。

durationunits 省略可能; 長い。 期間の単位を示します。 期間単位を省略した場合は、[オプション] ダイアログ ボックスの [スケジュール] タブにある [入力時の期間単位] ボックスで指定した単位が既定値として適用されます ([ツール] メニュー)。 期間単位には、次のいずれかの pjFormatUnit クラスの定数を指定できます。

• pjMinutes: pjElapsedMinutes
• pjHours: pjElapsedHours
• pjDays: pjElapsedDays
• pjWeeks: pjElapsedWeeks
• pjMonths: pjElapsedMonths
• pjMinutesEstimated: pjElapsedMinutesEstimated
• pjHoursEstimated: pjElapsedHoursEstimated
• pjDaysEstimated: pjElapsedDaysEstimated
• pjWeeksEstimated: pjElapsedWeeksEstimated
• pjMonthsEstimated: pjElapsedMonthsEstimated

ProjDurValue

期間を分単位で表示します。

構文

ProjDurValue( duration )

duration必須;バリアント。 分単位で示す期間を指定します。

Second

時刻の秒を表す 0 ～ 59 の範囲の整数をバリアント型 (内部処理形式 Integer の Variant) で返します。

構文

Second( time )

time 必須;時間を表すことができる任意の バリアント、数値式、文字列式、または任意の組み合わせ。 時刻が Null の場合は、Null 値が返されます。

時間

現在のシステムの時刻をバリアント型 (内部処理形式 Date の Variant) で返します。

構文

時間

Timer

午前 0 時 (真夜中) から経過した秒数を単精度浮動小数点数型 (Single) で返します。

構文

タイマー

TimeSerial

指定した時間、分、秒に対応する時刻をバリアント型 (内部処理形式 Date の Variant) で返します。

構文

TimeSerial(時, 分, 秒)

hour 必須; バリアント (整数)。 時を表す 0 (12:00 AM) ～ 23 (11:00 PM) の範囲の数値または数式を指定します。

minute 必須; バリアント (整数)。 任意の数式を指定します。

second 必須; バリアント (整数)。 任意の数式を指定します。

TimeValue

時刻を表すバリアント型 (内部処理形式 Date の Variant) の値を返します。

構文

TimeValue(時刻)

time 必須;通常、0:00:00 (午前 12:00:00) から 23:59:59 (午後 11:59:59) までの時間を表す文字列式。 ただし、時刻には、この範囲内の時刻を表す任意の式を指定することもできます。 時刻が Null の場合は、Null 値が返されます。

Weekday

何曜日であるかを表す整数をバリアント型 (内部処理形式 Integer の Variant) で返します。

構文

Weekday(日付[,週の最初の曜日])

日付 必須;日付を表すことができる、バ リアント、数値式、任意の組み合わせの文字列式。 日付が Null の場合は、Null 値が返されます。

firstdayofweek 省略可能;週の最初の曜日を指定する定数。 省略すると、日曜日を指定したものと見なされます。

Year

年を表す整数をバリアント型 (内部処理形式 Integer の Variant) で返します。

構文

Year(日付)

日付 必須;日付を表すことができる任意の バリアント、数値式、文字列式、または任意の組み合わせ。 日付が Null の場合は、Null 値が返されます。

標準関数

選択するオプション

引数のリストから値を選択して返します。

構文

Choose(インデックス,式1,式2, ..., 式n)

index 必須;1 から使用可能な選択肢の数の間の値になる数値式またはフィールド。

選択肢 必須;可能な選択肢の 1 つを含む バリアント 式。

IIf

式の評価によって、2 つの値のいずれか 1 つを返します。

構文

IIf(式,真の値,偽の値)

expr 必須;評価する バリアント 式。

TruePart 必須;対応する式が True の場合に返される値または式。

falsepart 必須;対応する式が False の場合に返される値または式。

IsNumeric

式が数値として評価できるかどうかを調べ、結果をブール型 (Boolean) で返します。

構文

IsNumeric(式)

式 必須;数式または文字列式を含む バリアント 。

IsNull

式に無効なデータ (Null 値) が含まれているかどうかを調べ、結果をブール型 (Boolean) で返します。

構文

IsNull(式)

式 必須;数式または文字列式を含む バリアント 。

Switch

式の一覧を評価し、一覧の中で真 (True) である最初の式に関連付けられた、バリアント型 (Variant) の値または式を返します。

構文

Switch(式1,値1,式2,値2,...,式n,値n)

数値演算関数

Abs

引き渡した数値の絶対値を同じデータ型で返します。

構文

Abs(数値)

number 必須;任意の有効な数値式。 数値に Null が含まれている場合は、Null が返されます。初期化されていない変数の場合は、0 が返されます。

Atn

指定した数値のアーク タンジェントを倍精度浮動小数点数型 (Double) で返します。

構文

Atn(数値)

number 必須; 倍精度浮動小数点数 型または任意の有効な数値式。

Cos

指定した角度のコサインを倍精度浮動小数点数型 (Double) で返します。

構文

Cos(数値)

number 必須; 倍精度浮動小数点数 または角度をラジアンで表す有効な数式。

Exp

e (自然対数の底) をべき乗して倍精度浮動小数点数型 (Double) で返します。

構文

Exp(数値)

number 必須; 倍精度浮動小数点数 型または任意の有効な数値式。

Fix

数値の整数部を返します。 数値が負の値の場合、数値以上の最小の負の整数を返します。

構文

Fix(数値)

number 必須; 倍精度浮動小数点数 型または任意の有効な数値式。 数値が Null の場合は、Null 値が返されます。

Int

数値の整数部を返します。 数値が負の値の場合、数値以下の最大の負の整数を返します。

構文

Int(数値)

number 必須; 倍精度浮動小数点数 型または任意の有効な数値式。 数値が Null の場合は、Null 値が返されます。

Log

指定した数値の自然対数を、倍精度浮動小数点数型 (Double) で返します。

構文

Log(数値)

number 必須; 倍精度浮動小数点数 型または 0 より大きい有効な数式。

Rnd

乱数を含む単精度浮動小数点数型 (Single) を返します。

構文

Rnd(数値)

number 必須; 単一 または任意の有効な数値式。

Sgn

指定した数値の符号をバリアント型 (内部処理形式 Integer の Variant) で返します。

構文

Sgn(数値)

number 必須;任意の有効な数値式。

戻り値は以下のとおりです。

• 数値が 0 より大きい場合、Sgn は 1 を返します。
• 数値が 0 に等しい場合、Sgn は 0 を返します。
• 数値が 0 より小さい場合、Sgn は -1 を返します。

Sin

指定した角度のサインを倍精度浮動小数点数型 (Double) で返します。

構文

Sin(数値)

number 必須; 倍精度浮動小数点数 または角度をラジアンで表す有効な数式。

Sqr

数式の平方根を倍精度浮動小数点数型 (Double) で返します。

構文

Sqr(数値)

number 必須; 倍精度浮動小数点数 式、または 0 以上の任意の有効な数値式。

Tan

指定した角度のタンジェントを倍精度浮動小数点数型 (Double) の数値で返します。

構文

Tan(数値)

number 必須; 倍精度浮動小数点数 または角度をラジアンで表す有効な数式。

文字列操作関数

Asc

文字列内にある先頭文字に対応する文字コードを示す整数型 (Integer) の値を返します。

構文

Asc(文字列)

文字列 任意の有効な文字列式。

Chr

指定した文字コードに対応する文字を示す文字列型 (String) の値を返します。

構文

Chr(文字コード)

charcode 文字を識別する Long 。

Format

式を指定した書式に従って変換し、バリアント型 (内部処理形式 String の Variant) の値を返します。

構文

Format(式[,書式[,週の最初の曜日[,年の最初の曜日]]])

式 必須;任意の有効な式。

format 省略可能;有効な名前付き書式またはユーザー定義書式。

firstdayofweek 省略可能;週の最初の曜日を指定する 定数 。

firstweekofyear 省略可能;年の最初の週を指定する 定数 。

Instr

ある文字列の中から指定した文字列が最初に見つかった位置をバリアント型 (内部処理型 Long の Variant) で返します。

構文

Instr([開始位置,]文字列 1,文字列 2[,比較モード])

start 省略可能;各検索の開始位置を設定する数値式。 省略すると、先頭の文字から検索されます。 開始位置に Null が含まれる場合、エラーが発生します。 比較モードを指定した場合は、引数開始位置も指定します。

string1 必須;検索されている文字列式。

string2 必須;シークされた文字列式。

比較 省略可能;文字列比較のタイプを指定します。 比較モードが Null の場合、エラーが発生します。 比較を省略すると、オプションの比較設定によって比較の種類が決定されます。

LCase

アルファベットの大文字を小文字に変換して文字列型 (String) で返します。

構文

LCase(文字列)

文字列 必須;任意の有効な文字列式。 文字列が Null の場合は、Null 値が返されます。

Left

文字列の左端から指定した文字数の文字列を、バリアント型 (内部処理形式 String の Variant) で返します。

構文

Left(文字列,文字数)

文字列 必須。 文字列式の左端から指定した文字数の文字を返します。 文字列が Null の場合は、Null 値が返されます。

length 必須; バリアント (ロング)。 返す文字数を表す数式を指定します。 0 を指定した場合は、長さ 0 の文字列 ("") を返します。 文字列の文字数以上の場合は、文字列全体を返します。

Len

文字列の文字数や変数を記憶するために必要なバイト数を、長整数型 (Long) で返します。

構文

Len(文字列,変数名)

文字列 任意の有効な文字列式。 文字列が Null の場合は、Null 値が返されます。

varname 任意の有効な変数名。 varname に Null が含まれている場合は、Null が返されます。 varname が Variant の場合、Len はそれを String と同じように扱い、常に含まれている文字数を返します。

LTrim

指定した文字列から先頭のスペースを削除した文字列を、バリアント型 (内部処理形式 String の Variant) で返します。

構文

LTrim(文字列)

文字列 必須;任意の有効な文字列式。 文字列が Null の場合は、Null 値が返されます。

Mid

文字列から指定した文字数の文字列を、バリアント型 (内部処理形式 String の Variant) で返します。

構文

Mid(文字列,開始位置[,文字数])

文字列 必須;文字が返される文字列式。 文字列が Null の場合は、Null 値が返されます。

start 必須; 長い。 文字列のどの位置から文字を取り出すかを先頭からの文字数で指定します。 開始位置が文字列の文字数を超える場合、Mid 関数は長さ 0 の文字列 ("") を返します。

length 省略可能; バリアント (ロング)。 返す文字列数を指定します。 この引数が省略された場合、またはテキスト内の文字数よりも短い場合 (開始位置の文字を含め) は、開始位置から後のすべての文字列が返されます。

Right

文字列の右端から指定した文字数の文字列を、バリアント型 (内部処理形式 String の Variant) で返します。

構文

Right(文字列,文字数)

文字列 必須;右端の文字が返される文字列式。 文字列が Null の場合は、Null 値が返されます。

length 必須; バリアント (ロング)。 返す文字数を表す数式を指定します。 0 を指定した場合は、長さ 0 の文字列 ("") を返します。 文字列の文字数以上の場合は、文字列全体を返します。

RTrim

指定した文字列の末尾のスペースを削除した文字列を、バリアント型 (内部処理形式 String の Variant) で返します。

構文

RTrim(文字列)

文字列 必須;任意の有効な文字列式。 文字列が Null の場合は、Null 値が返されます。

スペース

指定した数のスペースを、バリアント型 (内部処理形式 String の Variant) で返します。

構文

Space(数値)

number 必須;文字列に必要なスペースの数。

StrComp

文字列を比較した結果を、バリアント型 (内部処理形式 Integer の Variant) で返します。

構文

StrComp(文字列 1,文字列 2[,比較モード])

string1 必須;任意の有効な文字列式。

string2 必須;任意の有効な文字列式。

比較 省略可能;文字列比較のタイプを指定します。 引数比較モードに Null が含まれる場合は、エラーが発生します。

StrConv

指定した文字列を変換して、バリアント型 (内部処理形式 String の Variant) で返します。

構文

StrConv(文字列,変換方法,LCID)

文字列 必須;変換する文字列式。

変換 必須; 整数。 変換方法を指定する値の合計を指定します。

LCID 省略可能;システム LocaleID と異なる場合は LocaleID。 (既定値はシステム LocaleID)

String

ある文字を指定した文字数だけ繰り返して、バリアント型 (内部処理形式 String の Variant) で返します。

構文

String(数値,文字)

number 必須; 長い。 返す文字列の長さを指定します。 数値が Null の場合は、Null 値が返されます。

文字必須;バリアント。 文字を指定する文字コード、または先頭文字が返す文字列を作成するために使用される文字列式を指定します。 文字が Null の場合は、Null 値が返されます。

Trim

指定した文字列の先頭または末尾のスペースを削除した文字列のコピーを、バリアント型 (内部処理形式 String の Variant) で返します。

構文

Trim(文字列)

文字列 必須;任意の有効な文字列式。 文字列が Null の場合は、Null 値が返されます。

UCase

指定したアルファベットの小文字を大文字に変換し、バリアント型 (内部処理形式 String の Variant) で返します。

構文

UCase(文字列)

文字列 必須;任意の有効な文字列式。 文字列が Null の場合は、Null 値が返されます。