Project Siena で関数を作成する

シンボル

演算子の型

構文

説明

+

算術演算子

1 + 2

加算

*

2 * 3

乗算

^

2 ^ 3

指数演算

=

比較演算子

Price = 100

等しい

>=

Price >= 100

以上

<=

Price <= 100

以下

&

文字列の連結演算子

"hello" & " " & "world"

連結

||

Price < 100 || slider!value = 20

論理和

exactin

メンバーシップの演算子

gallery!Selected exactin SavedItems

コレクションまたはテーブルに属します

in

gallery!Selected in SavedItems

コレクションまたはテーブルに属します

@

あいまいさ解消演算子

MyTable[@fieldname]

フィールドのあいまいさ解消

;

式の連鎖

Collect(T, A); Navigate(S1, "")

動作プロパティの関数の各呼び出しを区切ります

構文

Abs(Number)

Abs(ColumnExpression)

例

Abs(-55) は 55 を返します。

たとえばテーブルに Trend という名前の列が含まれている場合、Trend 列のそれぞれの数値の絶対値を戻すには、結果列で Abs(Trend) を使用できます。

構文

AddColumns(Table, Column1, Expression1[, Column2, Expression2, ...])

例

Sales テーブルがあり、そのテーブルに CostPerUnit 列と UnitsSold 列が含まれているとすると、これら 2 つの列に加えて、TotalSales という名前で、最初の 2 つの列の値の乗算結果を示す 3 番目の列が入った 2 番目のテーブルを作成できます。

AddColumns(Sales, "TotalSales", CostPerUnit * UnitsSold)

Employees テーブルがあり、そのテーブルに FirstName 列と LastName 列が含まれているとすると、これら 2 つの列に加えて、FullName という名前で、最初の 2 つの列の文字列の連結結果を示す 3 番目の列が入った 2 番目のテーブルを作成できます。

AddColumns(Employees, "FullName", FirstName & " " & LastName)

構文

And(LogicalExpression1[, LogicalExpression2, ...])

例

次の関数は、スライダーの値が 50 と 100 の間にあるかどうかを判別します。

And(Slider1!Value > 50, Slider1!Value < 100)

テーブルに Dept 列と Salary 列が含まれているとすると、結果列で次の関数を使用し、Dept 列の値が HR で、Salary 列の値が 200000 より大きいすべての行に True を示すことができます。

And(Dept = "HR", Salary > 200000)

こうした関数で && 演算子を使用しても、前の例と同じ結果が戻ります。

Slider1!Value > 50 && Slider1!Value < 100

Dept = HR && Salary > 200000

構文

Average(Table, Expression)

Average(Expression1[, Expression2, …])

例

CostPerUnit 列と UnitsSold 列が含まれている Sales テーブルがある場合、次の関数は平均売上を計算します。

Average(Sales, CostPerUnit * UnitsSold)

3 つのスライダーがある場合、次の関数はそれらの値の平均を計算します。

Average(Slider1!Value, Slider2!Value, Slider3!Value)

構文

Char(Number)

使用例

Char(65) は次を返します。

A

Char(105) は次を返します。

i

Char(35) は次を返します。

#

構文

Clear(Collection)

使用例

1. Collect 関数の最初の例で説明されているように OrderHistory コレクションを作成します。
   

2. ボタンを追加して、その Text プロパティを "Clear" に設定し、その OnSelect プロパティを以下の関数に設定します。

   Clear(OrderHistory)
   

3. F5 キーを押し、[Clear] ボタンをクリックしてから、Esc キーを押してデザイン画面に戻ります。

コレクションが空であることを確認するため、コントロールでもボタンでもない場所を右クリックし、[アプリのデータ] をクリックしてから [コレクション] をクリックします。

別の例については、「」をご覧ください。

構文

Collect(CollectionName, Item1[, Item2,...])

例

• インポートされた表からコレクションを作成するには:

  1. ボタンを 1 つ追加し、その OnSelect プロパティに次の構文に従う関数を設定します。

     Collect(CollectionName,TableName)
     

  2. F5 キーを押し、ボタンをクリックしてから、Esc キーを押してデザイン ワークスペースに戻ります。
     

• インポートされた表の列からコレクションを作成するには:

  1. ボタンを 1 つ追加し、その OnSelect プロパティに次の構文に従う関数を設定します。

     Collect(CollectionName,TableName!ColumnName)
     

  2. F5 キーを押し、ボタンをクリックしてから、Esc キーを押してデザイン ワークスペースに戻ります。
     

• 楽器の名前のような、ハードコーディングされた値の単一列コレクションを作成するには:

  1. ボタンを 1 つ追加し、その OnSelect プロパティに以下の関数を設定します。

     Collect(Products, "violins", "trombones", "bongos")
     

  2. F5 キーを押し、ボタンをクリックしてから、Esc キーを押してデザイン ワークスペースに戻ります。
     

• スライダーのような、コントロールの値から、単一列コレクションを作成するには:

  1. コントロールの OnChange プロパティを、次の構文に従う関数に設定します。

     Collect(CollectionName,ControlName!Value)
     

     たとえば、OnChange プロパティを次の関数に設定すると、SalaryPercent というスライダーの値から、Contribution401K というコレクションを作成できます。

     Collect(Contribution401K, SalaryPercent!Value)
     

  2. F5 キーを押し、スライダー ボタンを別の値にドラッグしてから、Esc キーを押します。

     注意

     スライダー ボタンをある値にドラッグしてから別の値にドラッグすると、コレクションには両方の値が含まれることになります。最新の値だけを保持する場合には、先に Collect 関数を Clear(CollectionName) と共に使用し、セミコロンでそれらの関数を分離します。

• 3 つのスライダーなど、同じ型の複数のコントロールの値から、単一列コレクションを作成するには:

  1. 複数のコントロールと 1 つのボタンを追加してから、ボタンの OnSelect プロパティを、次の構文に従う関数に設定します。

     Collect(CollectionName,ControlName1!Value,ControlName2!Value,ControlNameN!Value)
     

     たとえば、Contributions というコレクションを、Percent401K、PercentStock、PercentCharity というスライダーの値から作成できます。そのためには、ボタンの OnChange プロパティを次の関数に設定します。

     Collect(Contributions, Percent401K!Value, PercentStock!Value, PercentCharity!Value)
     

  2. F5 キーを押し、各スライダー ボタンを異なる値にドラッグし、ボタンをクリックしてから、Esc キーを押します。
     

• 手動で入力したデータから、複数の列を持つコレクションを作成するには、以下のようにします。

  1. Product と Quantity という 2 つのテキスト入力コントロールを追加します。
     

  2. ボタンを追加して、その Text プロパティを "Collect" に設定し、その OnSelect プロパティを以下の関数に設定します。

     Collect(OrderHistory, {Products:Product!Text, Quantities:Quantity!Text})
     

  3. F5 キーを押し、各テキスト入力コントロールにテキストを入力してから、[Collect] ボタンをクリックします。
     

  4. 前述のステップを 2 ～ 3 回繰り返し、その都度異なる情報を入力します。それから、Esc キーを押してデザイン画面に戻ります。
     

• コレクションが作成されたことを確認するには、Alt-F キーを押し、[アプリのデータ] をクリックしてから、[コレクション] をクリックします。
  

• コレクションをアプリに表示するには、します。
  

  

• コレクションから 1 つまたはすべての項目を削除するには、このトピックの Remove 関数と Clear 関数を参照してください。
  

• アプリを閉じた後で使えるようにコレクションを保存し、後でアプリを再び開くときにそのデータを読み込むには、このトピックの SaveData 関数と LoadData 関数を参照してください。

構文

ColorFade(Color, FadeDelta)

例

ColorFade(Color!AliceBlue, -1)

ColorFade(Color!DarkBlue, 1)

ColorFade(RGBA(255, 255, 255, 1), 1)

構文

ColorValue(ColorText)

例

ColorValue("Blue")

ColorValue("Fuschia")

構文

Concat(CollectionName, Expression)

例

1.ボタンを 1 つ追加し、その OnSelect プロパティに以下の関数を設定します。

Collect(Products, {String:"Violin", Wind:"Trombone", Percussion:"Bongos"}, {String:"Cello", Wind:"Trumpet", Percussion:"Tambourine"})

2.F5 キーを押し、ボタンをクリックしてから、Esc キーを押してデザイン ワークスペースに戻ります。

3.ラベルを追加し、その [テキスト] プロパティを以下の関数に設定します。

Concat(Products, String & " ")

ラベルは「Violin Cello」を表示します。

構文

Concatenate(Text1[, Text2, ...])

Concatenate(ColumnExpression1[, ColumnExpression2, ...])

例

AuthorName という名前の入力テキスト コントロールを作成した場合、次の関数は、ユーザーがコントロールに入力したテキストの前に "By" を付加します。

Concatenate("By ", AuthorName!Text)

FirstName 列と LastName 列が含まれている Employees テーブルがある場合、次の関数は、それらの列の各行にあるデータを連結します。

Concatenate(Employees!FirstName, " ", Employees!LastName)

構文

Count(Column)

使用例

1. Collect 関数の最初の例の説明に従ってコレクションを作成します。ただし、ボタンの OnSelect プロパティを以下の関数に設定します。

   Collect(OrderHistory, {Products:Product!Text, Quantities:Value(Quantity!Text)})

2. ユーザー設定ギャラリーの Items プロパティを OrderHistory に設定することにより、コレクションをギャラリーに表示します。

   「」を参照してください。
   

3. ギャラリーの外側にラベルを追加し、その Text プロパティを以下の関数に設定します。

   Count(Value(OrderHistory!Quantities))

構文

CountA(Column)

使用例

1. Collect 関数の最初の例で説明されているように OrderHistory コレクションを作成します。

2. ラベルを追加してから、その Text プロパティを以下の関数に設定します。

   CountA(OrderHistory!Products)

   コレクションに入っている製品の数がラベルに表示されます。

構文

CountIf(Table, Expression)

使用例

Salary という名前の列が含まれている Employees という名前のテーブルがある場合、次の関数は給与が 100,000 を超える社員の数を数えます。

CountIf(Employees, Salary > 100000)

構文

CountRows(Table)

使用例

Employees という名前のテーブルがある場合、次の関数はそのテーブル内の行数を数えます。

CountRows(Employees)

構文

Date(Year, Month, Day)

使用例

ユーザーが、HireYear という名前の入力テキスト コントロールに 1979、HireMonth という名前の入力テキスト コントロールに 3、HireDay という名前の入力テキスト コントロールに 17 を入力した場合、この関数は 3/17/1979 を返します。

Date(Value(HireYear!Text), Value(HireMonth!Text), Value(HireDay!Text))

構文

DateAdd(Date, NumberOfUnits[, Units])

例

今日の日付が 7/15/2013 の場合:

• DateAdd(Now(), 3) は 7/18/2013 を返します。

• DateAdd(Today(), 1, Days) と DateAdd(Today(), 1) は、両方とも 7/16/2013 を返します。

• DateAdd(Today(), 1, Months) は 8/15/2013 を返します。

構文

DateDiff(StartDate, EndDate[, Units])

例

今日の日付が 7/15/2013 の場合:

DateDiff(Now(), 1/1/2014) と DateDiff(Now(), 1/1/2014, Days) は、両方とも 170 日を返します。

DateDiff(Now(), 1/1/2014, Months) は 6 か月を返します。

構文

DateTimeValue(DateTimeText)

DateTimeValue (DateTimeText, "LanguageCode")

例

Start というテキスト入力コントロールに「10/11/2014 1:50:24.765 PM」と入力し、ラベルの Text プロパティを次の関数に設定した場合:

• Text(DateTimeValue(Start!Text), DateTimeFormat!LongDateTime)

  コンピューターのロケールが "en" に設定されていた場合には、ラベルは「Saturday, October 11, 2014 1:50:24 PM」を表示します。

  DateTimeFormat パラメーターでは、LongDateTime 以外にいくつかのオプションを使用できます。これらのオプションの一覧を表示するには、パラメーターの直後に感嘆符を付けて関数のボックスに入力します。
  

• Text(DateTimeValue(Start!Text, "fr"), DateTimeFormat!LongDateTime)

  ラベルは「Monday, November 10, 2014 1:50:24 PM」を表示します。
  

• Text(DateTimeValue(Start!Text), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM")

  コンピューターのロケールが "en" に設定されていた場合には、ラベルは「Saturday, October 11, 2014 01:50:24:765 PM」を表示します。

  または、hh:mm:ss.f または hh:mm:ss.ff を指定して、時刻を少数第 2 位または小数第 3 位で四捨五入することもできます。

構文

DateValue(DateText)

DateValue (DateText, "LanguageCode")

例

Startdate というテキスト入力コントロールに「10/11/2014」と入力し、ラベルの Text プロパティを次の関数に設定した場合:

• Text(DateValue(Startdate!Text), DateTimeFormat!LongDate)

  コンピューターのロケールが "en" に設定されていた場合には、ラベルは「Saturday, October 11, 2014」を表示します。

  DateTimeFormat パラメーターでは、LongDateTime 以外にいくつかのオプションを使用できます。これらのオプションの一覧を表示するには、パラメーターの直後に感嘆符を付けて関数のボックスに入力します。
  

• Text(DateValue(Startdate!Text, "fr"), DateTimeFormat!LongDate)

  ラベルは「Monday, November 10, 2014」を表示します。

2014 年 10 月 20 日に同じことをした場合:

• DateDiff(DateValue(Startdate!Text), Today())

  コンピューターが en 言語コードに設定されていた場合、ラベルは 9 を表示します。これは 10 月 11 日と 10 月 20 日の間の日数を示しています。また、DateDiff は月数、四半期数、年数で差を示すこともできます。

構文

Day(DateTime)

使用例

Text1 という名前の入力テキスト コントロールを追加した場合、ユーザーがそのコントロールに次のいずれかの文字列を入力すると、Day(DateValue(Text1!Text)) は、15 を返します。

07/15/2013

15 July 2013

July 15, 2013

構文

Disable(Signal)

使用例

Disable(Location)

構文

Distinct(Table, Expression)

使用例

Department 列が含まれている Employees テーブルがある場合、次の関数はその列にある各部門の一意の名前を一覧表示します。個々の名前がその列に出現する回数は問題ではありません。

Distinct(Employees, Department)

構文

DropColumns(Table, Column1[, Column2, …])

使用例

FirstName 列、LastName 列、および Address 列が含まれている Employees テーブルがある場合、次の関数はこれらの列を含まないという点だけが異なる同じテーブルを返します。

DropColumns(Employees, "FirstName", "LastName", "Address")

構文

Enable(Signal)

使用例

Enable(Location)

構文

EncodeUrl(Text)

使用例

EncodeUrl("'http://example/page/url.aspx") は次を返します。

%27http%3A%2F%2Fexample%2Fpage%2Furl.aspx

構文

Filter(Table, Condition1[, Condition2, ...])

使用例

Salary 列が含まれている Employees テーブルがある場合、次の関数は給与が 100,000 を超える社員を識別します。

Filter(Employees, Salary > 100000)

この関数の使用方法について詳しくは、「」をご覧ください。

構文

Find(FindText, WithinText[, StartNum])

使用例

Find("me", "time") は、"time" 内の 3 文字目から "me" が出現するため、3 を返します。

Find("my", "time") は、"time" 内のどこにも "my" が出現しないため、何も返しません。

Find("in", "Honorificabilitudinitatibus", 4) は 18 を返します。

Find("in", "Honorificabilitudinitatibus", 19) は、18 文字目より後で一致が見つからなかったため、何も返しません。

構文

First(Table)

使用例

Employees テーブルがある場合、次の関数はそのテーブルの最初の行を返します。

First(Employees)

構文

FirstN(Table[, NumRows])

使用例

Employees テーブルがある場合、この関数はそのテーブルの最初の 10 行を返します。

FirstN(Employees, 10)

構文

HashTags(Text)

使用例

1. テキスト入力コントロールを追加し、それを Tweet と名付け、次の文をそれに入力します。

   This #app is #AMAZING and can #coUnt123 or #123abc but not #1-23 or #$*(#@")

2. 縦方向のユーザー設定ギャラリーを追加し、その Items プロパティに以下の関数を設定します。

   HashTags(Tweet!Text)

3. ギャラリー テンプレートにラベルを追加します。
   

   ラベルは以下のハッシュタグを表示します。

   • #app

   • #AMAZING

   • #coUnt123

   • #123abc

   • #1

構文

Hour(DateTime)

使用例

EventTime という入力コントロールの Text プロパティを Hour(TimeValue(EventTime!Text)) に設定した場合、このコントロールに「10:20:30 PM」と入力すると、ラベルに 22 と表示されます。

構文

If(Condition1, Result1[, Condition2, Result2, ConditionN, ResultN, DefaultResult])

例

手動で入力したデータでこの関数を使用するには、以下のようにします。

1. 2 つのテキスト入力コントロールを追加し、それぞれに MyShare および YourShare という名前を付けます。
   

2. ラベルを追加し、その Text プロパティを以下の関数に設定します。

   If(MyShare!Value + YourShare!Value < 100, "Not enough", MyShare!Value + YourShare!Value > 100, "Too much", "Just right")

   自分と友人で割り勘にした場合、スライダーのパーセンテージに従って各自が支払うと、間違いなく全額支払われたかどうかがラベルに示されます。

コレクションでこの関数を使用するには、以下のようにします。

1. Collect 関数の最初の例に従ってコレクションを作成します。ただし、量が 5 未満のエントリを最低 1 つ設けます。
   

2. ユーザー設定ギャラリーの Items プロパティを OrderHistory に設定することにより、コレクションをギャラリーに表示します。

   「」を参照してください。
   

3. ギャラリー テンプレートにラベルを追加し、その Text プロパティを以下の関数に設定します。

   If(Value(ThisItem!Quantities) < 5, "Order more!")

   量が 5 未満の行だけにメッセージが表示されます。

構文

IsBlank(Expression)

使用例

オーダー フォームに Quantity というテキスト入力コントロールを作成し、ラベルを追加して Text プロパティを If(IsBlank(Quantity!Text), "Please add a quantity.") に設定すると、そのフォームで量を指定し忘れた場合に注意喚起がなされます。

構文

IsEmpty(Source)

使用例

Employees という名前のテーブルにデータが含まれている場合、IsEmpty(Employees) は false を返し、それ以外の場合、この関数は true を返します。

構文

Language()

使用例

Language() は、構成に基づいて en-US などを返します。

構文

Last(Table)

使用例

Employees という名前のテーブルがある場合、次の関数はそのテーブルの最後の行を返します。

Last(Employees)

構文

LastN(Table[, NumRows])

使用例

Employees という名前のテーブルがある場合、次の関数はそのテーブルの最後の 15 行を返します。

LastN(Employees, 15)

構文

Launch(Hyperlink)

使用例

Launch("http://www.bing.com")

別の例については、「Project Siena アプリで RSS フィードを表示する」を参照してください。

構文

Left(Text, NumChars)

Left(ColumnExpression, NumericExpression)

例

手動で入力したデータでこの関数を使用するには、以下のようにします。

1. テキスト入力コントロールを追加し、PhoneNumber という名前を付けます。
   

2. ラベルを追加し、その Text プロパティを以下の関数に設定します。

   Left(PhoneNumber!Text, 3)

   テキスト入力コントロールに 10 桁の数を入力すると、入力した数の上位 3 桁がラベルに表示されます。

コレクション内のデータでこの関数を使用するには、以下のようにします。

1. Collect 関数の最初の例に従ってコレクションを作成します。ただし、各製品名の先頭にプレフィックスを付けます。

   たとえば、楽器の在庫リストを作る場合に、STR-Violins や PER-Bongoes などの製品名を使用できます。
   

2. 「」の説明に従って、ユーザー設定ギャラリーにコレクションを表示します。
   

3. ギャラリー テンプレートでラベルを追加し、その Text プロパティを以下の関数に設定します。

   Left(ThisItem!Products, 3)

   ギャラリー テンプレートに追加したラベルには、各製品名の先頭の 3 文字が表示されます。そのラベルを使用して、楽器のタイプや量などに基づいて並べ替えができるようになります。

構文

Len(Text)

Len(ColumnExpression)

例

Password というテキスト入力コントロールに「F@V0riteBandName」と入力すると、Len(Password!Text) は 16 を返します。

構文

LoadData(Collection, Filename)

使用例

1. SaveData 関数の例に示されているステップを実行します。
   

2. 画面の OnVisible プロパティを以下の関数に設定します。

   LoadData(OrderHistory, "SavedOrders")
   

3. アプリを保存し、Project Siena を閉じてから、アプリを再び開き、データが保存されていることを確かめます。

別の例については、「」をご覧ください。

構文

LookUp(Table, Condition, Expression)

使用例

FirstName 列と LastName 列が含まれている Employees テーブルがある場合、次の関数は "John Smith" という名前の従業員の給与を返します。

LookUp(Employees, FirstName = "John" && LastName = "Smith", Salary)

構文

Lower(Text)

Lower(ColumnExpression)

例

ユーザーからのデータでこの関数を使用するには、以下のようにします。

1. テキスト入力コントロールを追加し、Poetry という名前を付けます。
   

2. ラベルを追加し、その Text プロパティを以下の関数に設定します。

   Lower(Poetry!Text)

   テキスト入力コントロールに「We Are The Best!」と入力すると、ラベルには "we are the best!" と表示されます。

コレクション内のデータでこの関数を使用するには、以下のようにします。

1. Collect 関数の最初の例に従ってコレクションを作成します。ただし、1 つの製品に Trombone という名前を付けます。
   

2. 「」の説明に従って、ユーザー設定ギャラリーにコレクションを表示します。
   

3. ギャラリー テンプレートにラベルを追加し、その Text プロパティを以下の関数に設定します。

   Lower(ThisItem!Product)

   追加したラベルにすべての製品名がすべて小文字で表示されます。前に指定したエントリも "trombone" と表示されます。

構文

Max(Table, Expression)

Max(Expression1[, Expression2, ...])

例

CostPerUnit 列と UnitsSold 列が含まれている Sales テーブルがある場合、次の関数はそのテーブルの最高売上高を計算します。

Max(Sales, CostPerUnit * UnitsSold)

この関数は 3 つのスライダーの中の最大値を計算します。

Max(Slider1!Value, Slider2!Value, Slider3!Value)

構文

Mid(Text, StartPosition, NumChars)

Mid(TextColumn, StartPositions, NumChars)

例

手動で入力したデータでこの関数を使用するには、以下のようにします。

1. テキスト入力コントロールを追加し、PhoneNumber という名前を付けます。
   

2. ラベルを追加し、その Text プロパティを以下の関数に設定します。

   Mid(PhoneNumber!Text, 3, 3)
   

3. F5 キーを押し、テキスト入力コントロールに 10 桁の数を入力します。

   ラベルには指定した電話番号のプレフィックスが表示され、そのデータを基準に並べ替えなどができます。

コレクションでこの関数を使用するには、以下のようにします。

1. Collect 関数の最初の例の説明に従ってコレクションを作成します。ただし、製品名は 7 文字以上にします。

2. ユーザー設定ギャラリーの Items プロパティを OrderHistory に設定することにより、コレクションをギャラリーに表示します。

   「」を参照してください。

3. ギャラリー テンプレートにラベルを追加し、ラベルの Text プロパティを以下の関数に設定します。

   Mid(ThisItem!Product, 4, 3)
   

   製品名の 4 文字目以降の 3 文字が切り出されて、ラベルに表示されます。

構文

Min(Table, Expression)

Min(Expression1[, Expression2, …])

例

CostPerUnit 列と UnitsSold 列が含まれている Sales テーブルがある場合、この関数はそのテーブルの最低売上高を計算します。

Min(Sales, CostPerUnit * UnitsSold)

この関数は 3 つのスライダーの中の最低値を計算します。

Min(Slider1!Value, Slider2!Value, Slider3!Value)

構文

Minute(DateTime)

使用例

EventTime という入力コントロールの Text プロパティを Minute(TimeValue(EventTime!Text)) に設定した場合、このコントロールに「10:20:30 PM」と入力すると、ラベルに 20 と表示されます。

構文

Month(DateTime)

使用例

関数 Month(DateValue("03/17/1979")) は 3 を返します。

構文

Navigate(TargetScreen, Animation[, Context])

例

DetailView 画面がある場合、次の関数はその画面にフェード インして、ソースを文字列値 "Ravens" に設定する状態を渡します。

Navigate(DetailView, ScreenTransition!Fade, {source: "Ravens"})

DetailView 画面がある場合、次の関数はその画面にフェード インします。

Navigate(DetailView, ScreenTransition!Fade)

DetailView 画面がある場合、次の関数はその画面をアニメーションなしで表示します。

Navigate(DetailView, "")

構文

Not(BooleanExpression)

使用例

次の関数はオプション ボタンが選択されていないことを確認します。

Not(RadioButton1!Selected)

構文

Now()

使用例

今日が 2014 年 10 月 11 日、午後 3:25 ちょうどであり、ラベルのテキスト プロパティを Text(Now(), "mm/dd/yyyy hh:mm:ss.fff") に設定した場合、ラベルは「10/11/2014 3:25:00:000 PM」と表示します (コンピューターが en 言語コードに設定されていた場合)。コンピューターが fr 言語コードに設定されていた場合には、ラベルは「11/10/2014 3:25:00:000 PM」と表示します。

または、hh:mm:ss.f または hh:mm:ss.ff を指定して、時刻を少数第 2 位または小数第 3 位で四捨五入することもできます。

秒の小数部がアプリで重要でない場合、DateTimeFormat パラメーターを使用して、日付、時刻、またはその両方をいくつかの組み込み形式のいずれかで指定することができます。たとえば、この例の関数を Text(Now(), DateTimeFormat!ShortDateTime) で置き換えて、同じ結果からミリ秒を除いたものを取得することができます。このパラメーターのオプションの一覧を表示するには、パラメーターの直後に感嘆符を付けて関数のボックスに入力します。

構文

Or(LogicalExpression1[, LogicalExpression2, ...])

例

次の関数を使用して、スライダーの値が 50 から 100 までの範囲外かどうかを判別できます。

Or(Slider1!Value < 50, Slider1!Value> 100)

テーブルに Dept 列と Salary 列が含まれているとすると、結果列で次の関数を使用し、Dept 列の値が HR であるか、Salary 列の値が 200000 より大きいすべての行に True を示すことができます。

Or(Dept = HR, Salary >= 200000)

代わりに || 演算子を使用して、前の関数が返すのと同じ結果を得ることもできます。

Slider1!Value < 50 || Slider1!Value> 100

Dept = "HR" || Salary > 200000

構文

PlainText(TextWithTags)

例

テキスト ギャラリーを RSS フィードにバインドしてから、そのギャラリーの中のラベルの Text プロパティ (Data カテゴリ内) を ThisItem!description に設定した場合、ラベルは次の例のように、生の HTML コードまたは XML コードを表示します。

<p>We have done an unusually&nbsp;&quot;deep&quot; globalization and localization.<p>

ラベルの Text プロパティを PlainText(ThisItem!description) に設定した場合には、次の例のようにテキストが表示されます。

We have done an unusually "deep" globalization and localization.

構文

Proper(Text)

Proper(ColumnExpression)

例

ユーザーからのデータでこの関数を使用するには、以下のようにします。

1. テキスト入力コントロールを追加し、Slogan という名前を付けます。
   

2. ラベルを追加し、その Text プロパティを以下の関数に設定します。

   Proper(Slogan!Text)

   テキスト入力コントロールに「WE ARE THE BEST!」と入力すると、ラベルには "We Are The Best!" と表示されます。

コレクション内のデータでこの関数を使用するには、以下のようにします。

1. Collect 関数の最初の例に従ってコレクションを作成します。ただし、1 つの製品に TROMBONE という名前を付けます。
   

2. 「」の説明に従って、ユーザー設定ギャラリーにコレクションを表示します。
   

3. ギャラリー テンプレートにラベルを追加し、その Text プロパティを以下の関数に設定します。

   Proper(ThisItem!Product)

   追加したラベルにすべての製品名がすべて小文字で表示されます。前に指定したエントリも "Trombone" と表示されます。

構文

Rand()

使用例

Rand() は 0.85116235、0.76728732、0.27591115 や、その他の 0 以上 1 未満の数値を返します。

構文

Refresh(ServiceDataSource)

使用例

rss_1 という名前の RSS フィードを追加した場合、Refresh(rss_1) はそのフィードを最新表示します。

構文

Remove(Collection, Record1[, Record2, ..., All])

Remove(Collection, Table[, All])

使用例

1. Collect 関数の最初の例で説明されているように OrderHistory というコレクションを作成します。
   

2. ギャラリーの Items プロパティを OrderHistory に設定することにより、OrderHistory コレクションをギャラリーに表示します。
   

   「」を参照してください。
   

3. ギャラリー内のラベルの OnSelect プロパティを以下の関数に設定します。

   Remove(OrderHistory, ThisItem)
   

4. F5 キーを押してからギャラリーの項目をクリックし、ギャラリーとコレクションからその項目を削除します。

構文

RemoveIf(Collection, Condition1[, Condition2 ...])

使用例

Price という名前のフィールドが含まれた ShoppingCart という名前のコレクションがある場合、次の関数は、価格が 200 を超えるすべての項目をコレクションから削除します。

RemoveIf(Cart, Price > 200)

構文

RenameColumns(CollectionName, "OldName", "NewName")

例

1.ボタンを 1 つ追加し、その OnSelect プロパティに以下の関数を設定します。

Collect(Products, {String:"Violin", Wind:"Trombone", Percussion:"Bongos"}, {String:"Cello", Wind:"Trumpet", Percussion:"Tambourine"})

2.F5 キーを押し、ボタンをクリックしてから、Esc キーを押してデザイン ワークスペースに戻ります。

3.ユーザー設定ギャラリーを追加し、それに TableHolder という名前を付け、[項目] プロパティを以下の関数に設定します。

RenameColumns(Products, "String", "Strings")

4.2 つ目のボタンを追加し、その OnSelect プロパティを以下の関数に設定します。

Collect(Products2, TableHolder!AllItems)

5.F5 キーを押し、作成したボタンをクリックしてから、Esc キーを押してデザイン ワークスペースに戻ります。

6.Alt を押しながら F を押し、［アプリのデータ］ をクリックし、次に [コレクション] をクリックします。

7.Products と Products2 という名前のコレクションがあり、Products に　String、Products2 に Strings という名前の列があることを確認します。

構文

Replace(Text, StartIndex, Count, NewText)

Replace(Column, StartIndex, Count, NewText)

例

Replace("ABCDEFG", 3, 2, "X") は ABXEFG を返します。

構文

RGBA(Red, Green, Blue, Alpha)

使用例

次の関数ではラベルのフォント カラーをライト オレンジに設定できます。

RGBA(255, 127, 39, 1)

構文

Right(Text, NumChars)

Right(ColumnExpression, NumericExpression)

使用例

Right("ABCDE", 4) は BCDE を返します。

構文

Round(Number, DecimalPlaces)

Round(Column, DecimalPlaces)

例

手動で入力したデータでこの関数を使用するには、以下のようにします。

1. テキスト入力コントロールを追加し、Decimal という名前を付けます。
   

2. ラベルを追加し、その Text プロパティを以下の関数に設定します。

3. Round(Value(Decimal!Text), 2)
   

4. テキスト入力コントロールに 10 進値 (.634 または .635 など) を入力し、ラベルに適切な値 (.63 または .64 など) が表示されることを確認します。

コレクションでこの関数を使用するには、以下のようにします。

1. Collect 関数の最初の例の説明に従ってコレクションを作成し、それぞれの量に .634 または .635 などの 10 進値を指定します。
   

2. ユーザー設定ギャラリーの Items プロパティを OrderHistory に設定することにより、コレクションをギャラリーに表示します。

   「」を参照してください。
   

3. ギャラリー テンプレートにラベルを追加し、ラベルの Text プロパティを以下の関数に設定します。

   Round(Value(Quantities), 2)

   追加したラベルに適切な値が表示されます。

構文

RoundDown(Number, DecimalPlaces)

RoundDown(Column, DecimalPlaces)

使用例

RoundDown(23.54, 0) は 23 を返します。

構文

RoundUp(Number, DecimalPlaces)

RoundUp(Column, DecimalPlaces)

使用例

RoundUp(23.44, 1) は 23.5 を返します。

構文

SaveData(Collection, FileName)

使用例

1. Collect 関数の最初の例で説明されているように OrderHistory コレクションを作成します。
   

2. [Collect] ボタンの OnSelect プロパティを更新し、以下の関数を含めます。

   Collect(OrderHistory, {Products:Product!Text, Quantities:Quantity!Text});SaveData(OrderHistory, "SavedOrders")
   

3. [Clear] ボタンを追加した場合、そのボタンの OnSelect プロパティを更新して、以下の関数を含めます。

   Clear(OrderHistory);SaveData(OrderHistory, "SavedOrders")
   

4. ギャラリーを追加してユーザーがコレクションから特定の項目を削除できるようにした場合は、ラベルの OnSelect プロパティを更新して、次の関数を含めます。

   Remove(OrderHistory, ThisItem);SaveData(OrderHistory, "SavedOrders")

アプリを閉じてから再び開いた後など、そのデータをコレクションにまた読み込む方法については、このトピックの前のほうに記載されている LoadData 関数を参照してください。

別の例については、「」をご覧ください。

構文

Second(DateTime)

使用例

EventTime という入力コントロールの Text プロパティを Second(TimeValue(EventTime!Text)) に設定した場合、このコントロールに「10:20:30 PM」と入力すると、ラベルに 30 と表示されます。

構文

ShowColumns(CollectionName, "Column1", "Column2"...)

例

1.ボタンを 1 つ追加し、その OnSelect プロパティに以下の関数を設定します。

Collect(Products, {String:"Violin", Wind:"Trombone", Percussion:"Bongos"}, {String:"Cello", Wind:"Trumpet", Percussion:"Tambourine"})

2.F5 キーを押し、ボタンをクリックしてから、Esc キーを押してデザイン ワークスペースに戻ります。

3.ユーザー設定ギャラリーを追加し、それに TableHolder という名前を付け、[項目] プロパティを以下の関数に設定します。

ShowColumns(Products, "String", "Wind")

4.2 つ目のボタンを追加し、その OnSelect プロパティを以下の関数に設定します。

Collect(Products2, TableHolder!AllItems)

5.F5 キーを押し、作成したボタンをクリックしてから、Esc キーを押してデザイン ワークスペースに戻ります。

6.Alt を押しながら F を押し、［アプリのデータ］ をクリックし、次に [コレクション] をクリックします。

7.Products と Products2 という名前のコレクションがあり、Products には 3 つすべての列があり、Products2 には最初の 2 列だけが含まれていることを確認します。

構文

Shuffle(Collection)

使用例

Deck という名前のコレクションにトランプの詳細を保管している場合、次の関数はそのコレクションをシャッフルします。

Shuffle(Deck)

構文

Sort(Table, Expression[, SortOrder!Descending])

使用例

Salary 列が含まれている Employees テーブルがある場合、次の関数は、給与の高い従業員を上位に、低い従業員を下位に並べて一覧表示します。

Sort(Employees, Salary, SortOrder!Descending)

構文

Sqrt(Number)

Sqrt(ColumnExpression1)

例

手動で入力したデータでこの関数を使用するには、以下のようにします。

1. テキスト入力コントロールを追加し、Source という名前を付けます。
   

2. ラベルを追加し、その Text プロパティを以下の関数に設定します。

   Sqrt(Value(Source!Text))
   

3. テキスト入力コントロールに数を入力し、入力した数の平方根がラベルに表示されることを確認します。

コレクションでこの関数を使用するには、以下のようにします。

1. Collect 関数の最初の例で説明されているようにコレクションを作成します。
   

2. ユーザー設定ギャラリーの Items プロパティを OrderHistory に設定することにより、コレクションをギャラリーに表示します。

   「」を参照してください。
   

3. ギャラリー テンプレートにラベルを追加し、ラベルの Text プロパティを以下の関数に設定します。

   Sqrt(Value(Quantities))

   追加したラベルには、Quantity 列内の値の平方根が表示されます。

構文

StdevP(Table, Expression)

StdevP(Expression1[,Expression2, ...])

例

CostPerUnit 列と UnitsSold 列が含まれるだけでなく、各地域をそれぞれ別個の行にリストしている Sales テーブルがある場合、次の関数は地域ごとの売上の標準偏差を計算します。

StdevP(Sales, CostPerUnit * UnitsSold)

1 から 7 のスライダーに設定された値の標準偏差を計算するには:

StdevP(Slider1!Value, Slider2!Value, Slider3!Value, Slider4!Value, Slider5!Value, Slider6!Value, Slider7!Value)

構文

Substitute(Text, OldText, NewText[,InstanceNum])

Substitute(TextColumn, OldTextColumn, NewTextColumn[, InstanceNumColumn])

使用例

次の関数は " & " を " and " で置き換えます。

Substitute(Text1!Text, " & ", " and ")

構文

Sum(Table, Expression)

Sum(Expression1[, Expression2, ...])

例

CostPerUnit 列と UnitsSold 列が含まれている Sales という名前のテーブルがある場合、次の関数は売上の合計を計算します。

Sum(Sales, CostPerUnit * UnitsSold)

スライダー 1、2、および 3 に設定した値の合計を計算するには:

Sum(Slider1!Value, Slider2!Value, Slider3!Value)

構文

Table({Column1:Row1, Column2:Row1...}, {Column1:Row2, Column2:Row2...})

例

• リスト ボックスを追加し、[項目] プロパティを以下の関数に設定します。

  Table({Color:"red"}, {Color:"green"}, {Color:"blue"})

• テキスト ギャラリーを追加し、その [項目] プロパティを以下の関数に設定します。

  Table({Item:"Violin123", Location:"France", Owner:"Fabrikam"}, {Item:"Violin456", Location:"Chile"})

  (省略可能) Heading1 ラベルの [テキスト] プロパティを ThisItem!Item に設定し、Subtitle1 ラベルの [テキスト] プロパティを ThisItem!Owner に設定し、Body1 ラベルの [テキスト] プロパティを ThisItem!Location に設定します。

構文

Text(Value, Format)

例

1. テキスト入力コントロールを追加し、Source という名前を付けます。

2. ラベルを追加し、その Text プロパティを以下の関数のいずれかに設定します。

   • Text(Value(Source!Text), "$#.##")

     テキスト入力コントロールに「56.75」と入力すると、ラベルには "$56.75" と表示されます。

   • Text(Value(Source!Text), "#.##%")

     テキスト入力コントロールに「56.75」と入力すると、ラベルには "56.75%" と表示されます。

   • Text(DateValue(Source!Text), "mmm dd, yyyy")

     テキスト入力コントロールに「5/18/1969」と入力すると、ラベルには "May 18, 1969" と表示されます。

     DateTimeFormat パラメーターを使用して、いくつかの組み込みの日付形式のいずれかを指定することもできます。たとえば、[テキスト] プロパティを以下の関数に設定する場合、ラベルに "Sunday, May 18, 1969" と表示できます。

     Text(DateValue(Source!Text), DateTimeFormat!LongDate)

     DateTimeFormat パラメーターの直後に感嘆符を付けて関数のボックスに入力すると、そのパラメーターのオプションの一覧を表示できます。

   • Text(TimeValue(Source!Text), "hh:mm:ss")

     コンピューターが太平洋夏時間 (Pacific Daylight Time) に設定されていて、テキスト入力コントロールに「10:20:30 PM」と入力した場合、ラベルは「2:20:30 PM」と表示します。これは、指定した時刻を PDT から協定世界時 (UTC) に変換したものです。

     時刻値にミリ秒を含むデータ ソースがある場合、そのデータの形式として "hh:mm:ss.fff" を指定することにより、それらを表示できます。hh:mm:ss.f または hh:mm:ss.ff を指定して、時刻の秒を少数第2 位または小数第 3 位で四捨五入することもできます。

構文

Time(Hour, Minute, Second)

使用例

ユーザーが BirthHour という名前の入力テキスト コントロールに 14、BirthMinute という名前の入力テキスト コントロールに 50、BirthSecond という名前の入力テキスト コントロールに 24 と入力した場合、この関数は 02:50:24 p を返します。

Text(Time(Value(BirthHour!Text), Value(BirthMinute!Text), Value(BirthSecond!Text)), "hh:mm:ss a/p")

構文

TimeValue(TimeText)

TimeValue(TimeText, "LanguageCode")

使用例

テキスト入力コントロールに FinishedAt と名付け、ラベルの Text プロパティを次のような関数に設定します。

If(TimeValue(FinishedAt!Text)<TimeValue("5:00:00.000 PM"), "You made it!", "Too late!")

• FinishedAt コントロールに「4:59:59.999 PM」と入力した場合、ラベルには "You made it!" と表示されます。

• FinishedAt コントロールに「5:00:00.000 PM」と入力した場合、ラベルには "Too late!" と表示されます。

構文

Today()

使用例

今日が 2014 年 10 月 11 日で、ラベルの[テキスト] プロパティを以下の関数に設定した場合:

• Today()

  コンピューターが en 言語コードに設定されている場合はラベルに「10/11/2014 12:00 AM」と表示され、コンピューターが fr 言語コードに設定されている場合は「11/10/2014 12:00 AM」と表示されます。

• Text(Today(), "mm/dd/yyyy")

  コンピューターに設定されている言語コードに関係なく、ラベルには「10/11/2014」と表示されます。

• Text(Today(), DateTimeFormat!ShortDate)

  コンピューターに設定されている言語コードに関係なく、ラベルには「10/11/2014」と表示されます。

  DateTimeFormat パラメーターでは、ShortDate 以外にいくつかのオプションを使用できます。これらのオプションの一覧を表示するには、パラメーターの直後に感嘆符を付けて関数のボックスに入力します。

構文

Trim(Text)

Trim(ColumnExpression)

例

Slogan というテキスト入力コントロールに「We are    the best!」と入力すると、Text プロパティが Trim(Slogan!Text) に設定されているラベルは、"We are the best!" を返します。

構文

Update(Collection, Record1, Record2[, "All"])

使用例

1. Collect 関数の最初の例で説明されているようにコレクションを作成します。ただし、Voilin という製品を最低 1 つ追加します。
   

2. ユーザー設定ギャラリーの Items プロパティを OrderHistory に設定することにより、コレクションをギャラリーに表示します。

   「」を参照してください。
   

3. 2 つのテキスト入力コントロールを追加し、それぞれに OldValue および NewValue という名前を付けます。
   

4. ボタンを 1 つ追加し、その OnSelect プロパティに以下の関数を設定します。

   Update(OrderHistory, {Products:OldValue!Text}, {Products:NewValue!Text}, All)
   

5. F5 キーを押し、OldValue には「Voilin」、NewValue には「Violin」と入力し、ボタンをクリックします。
   

6. スペルの間違ったエントリが修正されたことを確認し、Esc キーを押してデザイン画面に戻ります。

構文

UpdateContext({Name1: Expression1, Name2: Expression2, …})

使用例

UpdateContext({page: 5, displayItem: "Tablets"})

構文

UpdateIf(Collection, Condition1, {Column1: Expression1, …}[, Condition2, {Column1: Expression2, …}…])

使用例

ShoppingCart という名前のコレクションがあり、それに Price という名前のフィールドが含まれている場合、次の関数はそのコレクション内で価格が 200 を超えるすべての項目の NumItems を 0 に設定します。

UpdateIf(ShoppingCart, Price > 200, {NumItems: 0})

構文

Upper(Text)

Upper(ColumnExpression)

例

手動で入力したデータでこの関数を使用するには、以下のようにします。

1. テキスト入力コントロールを追加し、Slogan という名前を付けます。
   

2. ラベルを追加し、その Text プロパティを以下の関数に設定します。

   Upper(Slogan!Text)

   テキスト入力コントロールに「We are the best!」と入力すると、ラベルには "WE ARE THE BEST!" と表示されます。

コレクション内のデータでこの関数を使用するには、以下のようにします。

1. Collect 関数の最初の例に従ってコレクションを作成します。ただし、1 つの製品に Trombone という名前を付けます。
   

2. 「」の説明に従って、ユーザー設定ギャラリーにコレクションを表示します。
   

3. ギャラリー テンプレートにラベルを追加し、その Text プロパティを以下の関数に設定します。

   Upper(ThisItem!Product)

   追加したラベルにすべての製品名がすべて大文字で表示されます。前に指定したエントリも "TROMBONE" と表示されます。

構文

Value(Text)

使用例

Value("25") は 25 を返します。

構文

VarP(Table, Expression)

VarP(Expression1[, Expression2, ...])

例

CostPerUnit 列と UnitsSold 列が含まれるだけでなく、各地域をそれぞれ別個の行にリストしている Sales テーブルがある場合、次の関数は地域ごとの売上の分散を計算します。

VarP(Sales, CostPerUnit * UnitsSold)

1 から 7 のスライダーに設定された値の標準偏差を計算するには:

VarP(Slider1!Value, Slider2!Value, Slider3!Value, Slider4!Value, Slider5!Value, Slider6!Value, Slider7!Value)

構文

Year(DateTime)

使用例

Year(DateValue("03/17/1979")) は 1979 を返します。