Format 関数

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

構文

Format(expression[, format[, firstdayofweek[, firstweekofyear]]])

Format 関数の構文は、次の指定項目から構成されます。

指定項目 内容
expression 必ず指定します。任意の式を指定します。引数 expression に指定したデータは、引数 format の書式に従って変換されます。
format 省略可能です。定義済み書式または表示書式指定文字を指定します。
firstdayofweek 省略可能です。週の 1 日目を指定する定数を指定します。
firstweekofyear 省略可能です。年の第 1 週を指定する定数を指定します。

設定値

引数 firstdayofweek には、次の定数を指定します。

定数 内容
vbUseSystem 0 NLS API の設定値を使用します。
vbSunday 1 (既定値) 日曜
vbMonday 2 月曜
vbTuesday 3 火曜
vbWednesday 4 水曜
vbThursday 5 木曜
vbFriday 6 金曜
vbSaturday 7 土曜

引数 firstweekofyear には、次の定数を指定します。

定数 内容
vbUseSystem 0 NLS API の設定値を使用します。
vbFirstJan1 1 (既定値) 1 月 1 日を含む週から始まります。
vbFirstFourDays 2 年の 4 日以上が含まれる最初の週から始まります。
vbFirstFullWeek 3 年のうち、7 日が含まれる最初の週から始まります。

解説

対象形式 書式の設定方法
数値 定義済み数値書式、または数値表示書式指定文字を使用します。
日付と時刻 定義済み日付/時刻書式、または日付/時刻表示書式指定文字を使用します。
日付と時刻のシリアル値 日付や時刻の形式または数値形式を使用します。
文字列 文字列表示書式指定文字を使用します。

引数 format を省略して数値に書式を設定しようとすると、Format 関数は Str 関数を呼び出した場合と同様の結果を返します。Format 関数の返す値は国別情報に対応しています。ただし、Str 関数を使用して正の数値を文字列に変換した場合、符号用のスペースが先頭に付加されますが、Format 関数を使用した場合、このスペースは付加されません。

ローカライズされていない数値文字列を書式設定する場合、目的の書式設定を確実に行うことができるように数値表示書式指定文字を使用するようにしてください。

メモ Calendar プロパティの設定がグレゴリオ暦の場合で、引数 format で日付書式を使用するように指定した場合、引数 expression にはグレゴリオ暦で表される日付を指定する必要があります。Calendar プロパティの設定が回教暦の場合で、引数 format で日付書式を使用するように指定した場合、引数 expression には回教暦で表される日付を指定する必要があります。

Calendar プロパティの設定がグレゴリオ暦の場合、引数 format で指定する表示書式指定文字は、通常の場合と同じ意味になります。Calendar プロパティの設定が回教暦の場合、引数 format で指定する表示書式指定文字 (たとえば、ddddmmmmyyyy) は、グレゴリオ暦の場合と同じ意味になりますが、設定される対象は回教暦のカレンダーになります。また、表示書式指定文字自体は英語のままとなりますが、表示結果は表示書式指定文字に応じて適切なアラビア語が使用されます。さらに、表示書式指定文字で表される値の範囲が、次の表に示すようにグレゴリオ暦の場合と比べて変わる場合があります。

表示書式指定文字 値の範囲
d 1 〜 30
dd 1 〜 30
ww 1 〜 51
mmm 完全な月の名前を表示します。回教暦の月の名前には、省略形式がありません。
y 1 〜 355
y 100 〜 9666