FileMaker 「関数と計算式」 中級編（10章）

『Year ( 日付 )関数』

引数は1つです。
指定した「日付」の 4 桁の年を返します。
Year ( “2018/08/25” )
のようにテキストの引数で日付を入力すると「2018」と結果を返します。

Year ( 発行日 )
「発行日」フィールド(日付タイプ)があり、そのフィールド名を引数として入力すると。。。データが2018/8/25 だった場合、「2018」を返します。

Year ( Get(日付) )
Get(日付)関数を引数として入力すると、今日が2018/8/25だった場合、「2018」を返します。

『Date ( 月 ; 日 ; 年 )関数』

引数は 3 つです。
指定した「月」「日」「年」のカレンダー上の日付を返します。

Date ( 8 ; 25 ; 2018 )
のように数字で引数を入力すると「2018/8/25」と結果を返します。
数字は「”」で囲む必要 はありません。

Date ( 8+2 ; 25 ; 2018 )
のように式も含んだ引数を入力しても「2018/10/25」と結果を返します。

Date ( 1 ; 2 ; Year ( 発行日 ) )
「発行日」フィールド(日付タイプ)があり、そのフィールド名を引数として入力すると、
データが 2018/8/25 だった場合、「2018/1/2」を返します。

『Get(UUID)』
結果は 16 進数(128bit)のランダムな文字列です。
評価されるたびに新しい文字列を返します。

『Get(UUID 番号 )』
結果は 24 進数(192 ビット)のランダムな数字です。
評価されるたびに新しい数字を返します。

※データは数字の方が処理速度が早い特性があります。
状況に応じて、UUIDをテキストか番号か考える必要が出てくるでしょう。

『Round( 数値 ; 桁数 ) → 四捨五入』

Round( 123.45 ; 0 )
数字「123」が返ります。 桁数は、小数点以下を表します。
小数点以下が不要な場合は桁数を「0」で式を指定します。

『Truncate( 数値 ; 桁数 )』　指定した小数点以下の桁で切り捨て
『Ceiling( 数値 )』　少数がある場合、整数を切り上げた数値
『Floor ( 数値 )』　一番小さい整数より下を切り捨て
『Int( 数値 )』　数値の整数のみ

『Mod( 数値 ; 除数 )』
数値を除数で割った余り

Mod( 7 ; 2 )
数字「1」を返します。
7÷2=3で余り1なので、この余り部分を返します。

日付や時間の計算に使用したり、2で割った余りが 1 なら数値は奇数であると判断するために使われることがあります。

『Random』
0 以上 1 未満の乱数

.99035877187065557425
のような小数点以下の数字を返します。
評価されるたびに新しい結果を返します。

●例えば、0 から 9 の間の乱数が必要な場合
Int ( Random * 10 )
10かけるので9.9035877187065557425
Intは整数のみ表示なので、この場合9を返す。

●0 は不要で 1 から 10 の間の乱数が必要な場合は、次のような式で得られます。
Int ( Random * 10 ) + 1
10かけるので9.9035877187065557425
Intは整数のみ表示なので、この場合9。＋1なので10を返す。

『Abs( 数値 )』
数値の絶対値

Abs ( -5 )
数字「5」を返します。 正数が結果として返ります。
絶対値は「0」からの距離を捉えるのに役立ちます。

よくある使用方法としてGet(システムプラットフォーム)関数ではWindowsプラットフォームの場合「-2」 が返りますが、Abs 関数で絶対値化して取り扱うことがあります。

『Sign( 数値 )』
正か負か0か

Sign( -12345 )
数字「-1」を返します。 指定された数値が負の場合は「-1」、ゼロの場合は「0」、正の場合は「1」を返します。

請求後の入金の残高有無などを確認するために役立ちます。

『Length( テキスト )』
指定したテキストの文字数(空白や改行も数えます)

Length( “あいうえお” )
数字「5」を返します。

例「見積情報」テーブルの「件名」フィールドを 30 字までに制限する。
「計算式で制限」で、 Length( 件名 ) ≦ 30 と、設定することもできます。
この計算式は論理値(0または1)が結果として返ります。

なお、 結果の判断基準は、次のように考えています。
・30 文字までは「1」エラーではない
・31 字以上は「0」エラー

『WordCount( テキスト )』
指定したテキストの単語数

WordCount ( “あいうえお かきくけこ” )
数字「2」を返します。

WordCount ( “あい,うえお、かきく。けこ” )
数字「4」を返します。
(空白や改行と記号(, 、 。)などが単語の区切りになります)

『ValueCount( テキスト )』
改行区切りの値数(行数)

ValueCount( “カレー ¶ハンバーグ¶オムライス¶ナポリタン” )
数字「4」が返ります。

関数を組み合わせて値一覧の行数を求めることも可能です。
ValueCount ( ValueListItems ( “10_見積作成管理” ; “見積状況” ) ) は、
「10_ 見積作成管理 .fmp12」の「見積状況」値一覧の行数の数字「3」が返ります。
（ValueListItems ⇨値一覧の情報を返す）

Trim( テキスト )
文字列の前後にあるスペースを削除

TrimAll( テキスト ; 全角詰め ; タイプ )
→ 文字列にあるスペースを削除する

●全角詰め
全角スペースを取り除くには、全角詰めを真 (1) に設定します。
全角スペースを削除しない場合は、全角詰めを偽 (0) に設定

●タイプ（0〜3）
0　:ローマ字以外の文字とローマ字の間のすべてのスペース
(ローマ字の間には常にスペースが 1 つになるようにする)
1　:ローマ字以外の文字とローマ字の間に常に半角スペース
(ローマ字の間には常にスペースが 1 つになるようにする)
2　:ローマ字以外の文字の間のスペース
(ローマ字の間に複数スペースがある場合にスペースが 1 つになるようにする)
3　:すべてのスペース

『Left( テキスト ; 文字数 )』
左から指定した文字数を取り出す

Left( “あいうえお” ; 2 )
テキスト「あい」が返ります。

『Right( テキスト ; 文字数 ) 』　右から指定した文字数を取り出す
『Middle( テキスト ; 先頭文字位置 ; 文字数 ) 』　指定した位置から文字数を取り出す

『LeftWords( テキスト ; 単語数 ) 』　 左から指定した単語数を取り出す 『RightWords( テキスト ; 単語数 ) 』　 右から指定した単語数を取り出す 『MiddleWords( テキスト ; 先頭単語位置 ; 単語数 ) 』　 指定した位置から単語数を取り出す

『Filter( フィルタするテキスト ; フィルタテキスト )』
指定したテキストを取り出す

例えば、数字文字列だけを取り出したいときは

Filter( “(03)-1234-56789” ; “0123456789” ) → テキスト「03123456789」が返ります。

『GetValue( 値一覧 ; 値番号 )』
値番号の1行を取り出す(末尾に改行なし)

GetValue( “カレー ¶ハンバーグ¶オムライス¶ナポリタン” ; 2 )
テキスト「ハンバーグ」が返ります。

『LeftValues( テキスト ; 値数 )』
上から指定した数の行を取り出す(末尾に改行あり)

LeftValues( “カレー ¶ハンバーグ¶オムライス¶ナポリタン” ; 2 )
テキスト「カレー ¶ ハンバーグ ¶」が返ります。

『RightValues( テキスト ; 値数 )』
下から指定した数の行を取り出す(末尾に改行あり)

『MiddleValues( テキスト ; 値開始位置 ; 値数 ) 』
指定した開始位置からの数の行を取り出す(末尾に改行あり)

『FilterValues( フィルタするテキスト ; フィルタ値 )』
指定したテキスト行を取り出す(末尾に改行あり)

「カレー ¶ ハンバーグ ¶ オムライス ¶ ナポリタン」の改行区切りテキストから「カレー」 と「オムライス」を取り出したいときは、
FilterValues( “カレー ¶ハンバーグ¶オムライス¶ナポリタン” ; “カレー ¶オムライス” )
テキスト「カレー ¶ オムライス ¶」が返ります。

『Hiragana( テキスト )』　指定したテキストの半角全角カタカナをひらがなにする
『KanaHankaku( テキスト )』　指定したテキストの全角カタカナを半角にする
『KanaZenkaku( テキスト )』　指定したテキストの半角カタカナを全角にする
『KanjiNumeral( テキスト )』　指定したアラビア数字を漢数字にする
『Katakana( テキスト )』　指定したテキストのひらがなを全角カタカナにする
『RomanHankaku ( テキスト )』　指定したテキストの全角の英数字と記号を半角の英数字と記号にする

『Furigana( テキスト{ ; オプション } ) 』
指定したテキストのふりがなを指定したオプションの文字種類のふりがなにする (思ったようなふりがなが結果として返らない場合もあります)

1 とオプション指定なし　:ひらがな
2　:全角カタカナ
3　:全角ローマ字
4　:半角カタカナ
5　:半角ローマ字

Furigana( “山田太郎” ; 5 )
テキスト「yamadatarou」が返ります。

『Exact ( テキスト ; 比較テキスト ) 』
指定したテキストと比較テキストの比較結果「一致しているかどうか」を数字で返す。
結果は論理値(0/1)
・一致する 「1(真 = True )」
・一致していない「0(偽 = False)」

※「一致」は大文字、小文字も同じである必要があります。
※比較対象がオブジェクトタイプフィールドの場合、同じ設定で格納(埋め込みまたは参照で保存)されている必要があります。

『Get ( ウインドウモード )』
現在のウインドウモードを評価した値を返します。

0　：ブラウズモード
1　：検索モード
2　：プレビュー　
3　：印刷中
4　：レイアウトモード(データビューアで確認するときに使います)

『GetAsDate( テキスト )』
テキストに含まれる日付を返す

テキストタイプフィールドに “2018/1/1” と入力されている場合、
計算式で日付として取り扱うには G e t A s D a t e 関数を使います 。

1( 0 0 0 1 / 1 / 1 )か ら 1 4 6 0 9 7 0( 4 0 0 0 / 1 2 / 3 1 ) までの日付を表す数字を
日付に変換することが可能です。

GetAsDate(“2018/1/1”)
テキスト「2018/01/01」が返ります。

GetAsDate(789012)
テキスト「2161/03/29」が返ります。
これらの特性を利用して、経過日数を計算することも可能です

『GetAsNumber( テキスト )』
テキストに含まれる数字を返す

GetAsNumber(” あ 1 い 2 う 3″)
数字「123」が返ります。

『Quote( テキスト )』
指定されたテキストを「”(ダブルクォーテーションマーク)」で囲むことで、そのテキストが そのままテキスト形式で返ります。
Evaluate関数などで評価されないように利用できます。

Quote ( 2+2 )
テキスト「4」が返ります。

Quote (“2+2”)
テキスト「2+2」が返ります。 → 「”」で囲んだためです。

『Substitute ( テキスト ; 検索テキスト ; 置換テキスト )』
指定したテキストを検索して置換

※大文字と小文字を区別します。
アルファベットを含む文字列を置換する場合には注意が必要です。

Substitute ( “ファイトメーカー” ; “ト” ; “ル” )
テキスト「ファイルメーカー」が返ります。

Substitute (“fileMaker pro” ;[“f” ; “F”] ; [“p” ; “P”] ; [“Pro” ; “Pro 19”] )

Substitute (
“fileMaker pro” ;
[“f” ; “F”] ; //この時点では「FileMaker pro」
[“p” ; “P”] ; // この時点では「FileMaker Pro」
[“Pro” ; “Pro 19”] // →「FileMaker Pro 19」 )
テキスト「FileMaker Pro 19」が返ります。

『Year( 日付 )』 　 指定した日付の4桁の年
『Month( 日付 )』 指定した日付の月(1から12の数字)
『 Day( 日付 )』　指定した日付の日(1から31の数字)

『WeekOfYear( 日付 )』　指定した日付の年の1/1からの経過週数

『YearName( 日付 ; 形式 )』　指定した日付の和暦年(指定した形式)
(「令和」では 0は「令和」、1は「(令)」、2は「R」と表示
なお「1」年は「元」年表示)

『MonthName( 日付 )』 　指定した日付の月(8月などの名前)

『DayOfYear( 日付 )』　指定した日付の年の1/1からの経過日数
『DayOfWeek( 日付 )』　指定した日付の曜日（1〜7の数字）
(1 は「日曜日」から 7 は「土曜日」)
『DayName( 日付 ) 』　 指定した日付の曜日(「日曜日」などの名前)

『Date( 月 ; 日 ; 年 ) 』　 指定した月、日、年のカレンダー上の日付

Date( 2 ; 31 ; 2020 )
2020/03/02 が返ります
Date( 15 ; 1 ; 2018 )
2019/03/01 が返ります
※15月は1年3ヶ月だから。。。2018＋1　で　2019/03/01

※存在しない日付は、カレンダーにある日付として結果を返します。

Date(Month(Get( 日付 )) ; 1 ; Year(Get( 日付 ))) 　今月1日
日だけが1日と初めから設定されている
Date(Month(Get( 日付 )) ; 1 ; Year(Get( 日付 )))-1 　先月末日
今月の1日から1日引くので先月末

『Hour( 時刻 )』　指定した時刻の時（0〜23）
『Minute( 時刻 )』　指定した時刻の分（0〜59）
『Seconds( 時刻 )』　指定指定した時刻の秒（0〜59）
『Time ( 時 ; 分 ; 秒 )』　指定した時、分、秒の値から計算した時刻

Time(Hour(Get( 時刻 )) ; 1 ; 1 ) 　現在時の1分1秒
Time(Hour(Get( 時刻 )) ; 1 ; 1)+3600 現在時1時間後の1分1秒

※日付関数と取得関数を組み合わせて使用できます。1時間は3600秒で取り扱います。

『Timestamp ( 日付 ; 時刻 )』　 指定した日付と時刻のタイムスタンプ
『Get ( タイムスタンプ )』　 現在のタイムスタンプ
『Get ( ホストのタイムスタンプ )』 　 現在のホストのタイムスタンプ

『GetAsDate ( テキスト ) 』　 指定したテキストの日付
『GetAsTime ( テキスト ) 』　 指定したテキストの時刻
『GetAsTimestamp ( テキスト )』 　指定したテキストのタイムスタンプ

GetAsDate ( Get( タイムスタンプ ) )
今日の日付を返します。

『Get( 現在の時刻 UTC ミリ秒 )』
現在の協定世界時刻 (UTC) にミリ秒単位で適合させた近似値

ミリ秒単位の結果、例えば「63601728323332」を返します。スクリプトで処理時間を計るときなどに便利です。

『If ( 条件 ; 結果 1 { ; 結果 2} )』
条件が1(真 = True )なら結果1、0(偽 = False)なら結果2

※If 関数は、2 つの結果を指定できます。
2 つ以上の結果が必要なら Case 関数を使用します。

『Case ( 条件1 ; 結果1 {;条件2 ; 結果2 ; … ; デフォルト値} ) 』
それぞれの条件を順に評価し1(真 = True )の条件が見つかったらその条件の結果
(どの条件も真でなければデフォルト値)

例　「消費税額」フィールドの端数処理の方法を、「端数処理」フィールドに1, 2, 3のいずれかの数値指定する場合は、次のようにします(「端数処理」フィールドに1、2、3 外の数値が入力されているか、空欄だと端数処理されません)。

Case (
端数処理 = 1 ; Round( 消費税額 ; 0 ) ;　　　//四捨五入
端数処理 = 2 ; Truncate( 消費税額 ; 0 ) ; 　//切り捨て
端数処理 = 3 ; Ceiling( 消費税額) ; 　　　　//切り捨て
消費税額 )

※Case関数では記述された順番に条件を評価します。

数値や日付の範囲が条件だったら、条件を大きい順あるいは小さい順に並べることで単純に記述できます。

例　「金額」フィールド(数字)に入力される数値で、割引率を結果として出す計算式は、次のように記述します。

Case (
金額 < 1000 ; “” ; 　　　// 割引なし
金額 < 2000 ; “.01” ; 　// 1%割引
金額 < 3000 ; “.02” ; 　// 2%割引
“.05”)　　　　　　　　//5%割引

『Choose ( 条件 ; 結果0 { ; 結果1 ; 結果2…} ) 』
条件の整数値に従った 1 つの結果
※Choose関数ではCase関数のように複数の条件を指定しません。

例　「評価」 フィールドに文字列を入力するためには、以下のように計算式を作成します。「評価レベル」フィー ルドに0/1/2/3 のいずれかの数値で指定する形です。

Choose (
評価レベル ; 　　//条件
“評価なし” ; 　　//結果0または空欄
“不可” ;　　　　//結果1
“可” ;　　　　　//結果2
“良” ;　　　　　//結果3
)

『IsEmpty ( フィールド )』
数字が返ります。 指定したフィールドが空欄か他のエラーが発生したら「1(真 = True )」 それ以外の場合は「0(偽 = False)」

『IsValid ( フィールド )』
数字が返ります。 指定したフィールドが無効なら「0(偽 = False)」 それ以外の場合は「1(真 = True )」

『GetAsBoolean ( データ )』
数字が返ります。
・指定したデータがゼロ以外の数値なら
「1(真 = True )」それ以外は「0(偽 = False)」
・指定したデータがオブジェクトタイプフィールドでデータが含まれている場合は 「1(真 = True )」それ以外は「0(偽 = False)」

IsEmpty 関数や IsValid 関数は、フィールドのデータを評価するだけではなく、関連レコードの有無や関連、関連ファイルがあるかどうかを判断することに使用できます。

例 　「顧客管理」TO と関連している「顧客管理 _ 見積」TO があり、関連レコードがある かどうかを確認するには次のように判断できます。

IsEmpty ( 顧客管理_見積::顧客外部キー )
関連レコードがなければ「1」、あれば「0」が返ります。

IsValid ( 顧客管理_見積::顧客外部キー )
関連レコードがなければ「0」、あれば「1」が返ります。

例　「顧客管理」TO の取引状態にデータが入力されているかどうかを確認する

GetAsBoolean ( 顧客管理::取引状態 )
「1」が入力されていれば「1」、空欄あるいは「0」が入力されていれば「0」

指定した式を計算式として評価します。

『Evaluate( 式 {;[ フィールド1; フィールド2; フィールド3;…]}) 』
「式 ; 」のあとの「フィールド」が変更されると計算式が再評価されて結果が更新されます。

Evaluate ( 2+2 )
「4」
Evaluate ( Quote ( “2+2” ))
「2+2」
Evaluate ( GetField ( “2＋2” ) )
「4」

●サーバーサイドで実行するスクリプトの注意

Evaluate 関数をサーバーサイドで実行するスクリプトで利用する場合には、評価する関数名は英語でなければいけません。
スクリプトの作成時や後述するカスタム関数の作成時に注意してください！

変数を取り扱う関数です。変数はいくつでも指定できます。

『Let ( {[} 変数1 = 式1 { ; 変数2 = 式2…]} ; 計算 )』

Let (
変数を指定する ;
指定した変数を使用した計算式
)

『GetFieldName ( フィールド名 )』
指定したフィールドの完全修飾名

『ExecuteSQL (SQLクエリー; フィールド区切り ; 行区切り { ; 引数…} ) 』
フィールド区切り：　結果のフィールドの区切り
行区切り：　結果が複数レコードの時の区切り文字
引数：　SQLクエリー内に「?」を記述してその代入のデータを設定するダイナミック引数

SQL クエリー：　FileMaker Pro の関数とは別の命令語、構文、文法が定められています。この定めに従って記述される命令文のことを「ステートメント」と呼びます。

ExecuteSQL (
“SELECT *
FROM \”見積管理\”
WHERE \”発行日\” = ‘2020-08-04’ ” ; “” ;”” )
※赤線部分がSQLクエリーの部分

『GetContainerAttribute( ソースフィールド ; 属性名 ) 』
指定したフィールドの、指定した属性名のメタデータ

『GetHeight ( ソースフィールド ) 』
イメージの高さ(ピクセル)
『GetWidth ( ソースフィールド )』
イメージの幅(ピクセル)

『GetThumbnail ( ソースフィールド ; 幅に合わせる ; 高さに合わせる ) 』
(ソースフィールドはオブジェクトタイプフィールドか、サムネールを取得したいイメージへのファイルパスを指定)

『VerifyContainer ( ソースフィールド )』
オブジェクトデータが FileMaker 以外を使用して変更または削除された場合 「0(偽 = False)」、それ以外の場合は「1(真 = True )」

『Base64Encode ( ソースフィールド )』
指定したフィールドに格納されているイメージを Base64 フォーマットのテキスト に変換
『Base64Decode ( テキスト {; 拡張子を含むファイル名} )』
Base64 フォーマットでエンコードされたテキストからオブジェクトに変換

『Sum ( フィールド {; フィールド…} ) 』
指定したフィールド内の空白を除いた値すべての合計

『Average ( フィールド {; フィールド…} )』
指定したフィールドの空白を除く有効な値すべての平均
『Count ( フィールド {; フィールド…} ) 』
指定したフィールドの空白を除く有効な値の数
※関連レコード数を数えるためにCount 関数を使用する場合は、主キーのような空欄不可のフィー ルドを指定します。
『Max ( フィールド {; フィールド…} ) 』
指定したフィールドの最大値
『Min ( フィールド {; フィールド…} ) 』
指定したフィールドの最小値

『List ( フィールド {; フィールド…} ) 』
フィールド内の空白を除く値の改行リスト

『While([初期変数]; 条件 ;[ロジック]; 結果 )』
条件が真(1)の間、[ロジック]を繰り返してから、結果を返します。

→ 次のように動作します。
1 初期変数引数を評価します。
2 条件引数を評価します。
3 条件が:
真(0 以外の数値結果)の場合、ロジックを評価してから 2 番目のステップを繰り返す 偽(0)の場合、繰り返しを停止して結果を返す

●条件
条件が正しく評価されることに注意します。なんらかにより停止条件が偽(0)にならない場合、規定数まで処理を繰り返して「?」を返して再帰を強制終了します。
●繰り返し回数は 50000 回
While 関数の繰り返しは 50000 回までに制限されています。または SetRecursion 関数で最大繰り返し数を設定することもできます。

『SetRecursion (式 ; 最大繰り返し) )』
式の再帰とループの最大繰り返し数を設定します。
式が最大繰り返しを超えると「?」を返します。