エクスプレッション

整数

演算子：+, -, *, /, %

42

-17

数値

演算子：+, -, *, /, %

3.14159

-.33

ブール値

演算子：&& (and), || (or)

TRUE

FALSE

テキスト

「テキスト」

式エディターで有効な結果を得るには、開始引用符と終了引用符が必要です。

例:

「Hello」は Hello という出力を提供します

「First」は First という出力を提供します

テキストを引用符で囲んで出力するには、テキストの先頭と末尾の引用符に特殊文字 \ を使用します。

例:

"<tag key=\"Value\"/>"

出力は次のようになります。

<tag key="Value">

「テキスト値の特殊文字」を参照してください。

実行情報:

値

$executionInfo は次の 2 つの値を提供します。

• robotName

• executionID

ロボットの式で使用します。

式エディターで次のように記述します。

$executionInfo.robotName または

$executionInfo.executionID

[ロボットを呼び出す] ステップの場合は、プライマリ ロボットのロボット名と実行 ID が自動的に含まれます。

ロボットがベーシック エンジン ロボットから呼び出された場合は、呼び出し元ロボットの名前を返します。

$executionInfo (読み取り専用)

「FindJSONObject.robot」

「DesignStudio_982dbd7b00000005」

実行情報:

定数

共有定数には、式エディターで $executionInfo 定数を JSON オブジェクトとして使用してアクセスします。

ロボットの式に $executionInfo.constants が含まれている場合、ロボットは式エディター内の共有定数にアクセスします。

Management Console への接続がない場合、または Management Console に定数が定義されていない場合、JSON オブジェクトの値は空になります。

Management Console 内の定数を追加、表示、および変更するには、「定数」を参照してください。関連項目: JSON のステップ。

現在のフロー ポイントがどこであっても、実行時には定数の [完了] オプションが使用可能になります。

Management Console で定数が更新された場合は、Design Studio の Management Console を更新し、ロボットの実行を再起動してロボット内の定数を更新する必要があります。

$executionInfo.constants (読み取り専用)

定数値は常に JSON 文字列として表されます。テキスト、整数などの値を取得するには、次のような変換関数を使用します。

• .text()

• .integer()

• .boolean()

\n

改行

\r

キャリッジ リターン

\f

フォーム フィード

\"

二重引用符

\t

タブ

\b

バックスペース

\\

バックスラッシュ 1 文字になります

\uXXXX

16 進数でコード化された Unicode 文字。

例:

"\u002A" は "*" を表す別の方法です。

<

未満

<=

以下

>

より大きい

>=

以上

+

加算またはテキスト連結

1+2

"hello " + name

-

減算または否定

1-2

5-2.9

-5

*

乗算

42*2

1.0*17

/

除算

1/2

1/2.0

%

剰余演算

x % 2

2.5 % 1.0

==,!=

等しい、等しくない

true == false

x != 0

<,<=

未満、以下

0 < 1

1.0 <= 0.0

>,>=

より大きい、以上

0 > 1

1.0 >= 0.0

&&,||

論理 AND、論理 OR

true || x

false && y

!

論理 NOT

!true

_?_:_

条件付き演算子

x>0? x: 0

( )

評価の順序

1+2*3 は 7 と評価されますが、次のように丸括弧を挿入すると(1+2)*3 は、隣接する演算子の前で括弧の内容が評価されるため、結果は 9 に変わります。

abs(Integer)

整数

abs(Number)

数値

ceil(Number)

整数

ceil(2.4) は 3 を返します。

computeMD5(binary: Binary)

テキスト

バイナリ入力の MD5 チェックサムを計算します。

floor(Number)

整数

floor(8.7) は 8 を返します。

round(Number)

整数

算術規則に基づいて、指定された数値よりも大きいまたは小さい最小の整数を返します。

round(1.6) は 2 を返します。

trunc(Number)

整数

trunc(4.8732) は 4 を返します。

max(Integer, Integer)

整数

max(Number, Number)

数値

min(Integer, Integer)

整数

min(Number, Number)

数値

pow(Integer, Integer)

整数

整数 (最初のパラメータ) をべき乗 (2 番目のパラメータ) した値を返します。

pow(5, 2) は 25 を返します。

指数が負の値である場合、または最大整数値 (2147483647) より大きい場合、この関数は IncorrectValue 例外を返します。

この関数が大きな数値を計算する場合、評価に長い時間がかかることがあります。

pow(Number, Integer)

数値

数値 (最初のパラメータ) をべき乗 (2 番目のパラメータ) した値を返します。

pow(5.2, 2) は 27.04 を返します

指数が負である場合、または 999999999 より大きい場合、この関数は IncorrectValue 例外を返します。

この関数が大きな数値を計算する場合、評価に長い時間がかかることがあります。

random()

数値

random()

random(Integer, Integer)

整数

Random(5, 96)

sqrt(Integer)

数値

sqrt(64) は 8.0 を返します

整数が負である場合、この関数は IncorrectValue 例外を返します。

sqrt(Number)

数値

sqrt(64) は 8.0 を返します

整数が負である場合、この関数は IncorrectValue 例外を返します。

after(Text, Text)

テキスト

サブテキストが最初に現れた場所の後にあるテキストを返します。

"abcdbc".after("bc") は dbc を返します。

サブテキストが見つからない場合、この関数は例外を返します。

ampersandDecode(Text)

テキスト

ampersandEncode(Text)

テキスト

base64Decode(Text)

バイナリ

before(Text, Text)

テキスト

指定したサブテキストが最初に現れた場所の前にあるテキストを返します。

"abcdbc".before("bc") は a を返します。

サブテキストが見つからない場合、この関数は例外を返します。

binary(Text, Text)

バイナリ

テキスト値をバイナリに変換します。

boolean(Text)

ブール値

テキストは「true」または「false」のいずれかになります。

boolean("true") は、ブール型の「true」を返します。

capitalize(Text)

テキスト

各単語の最初の文字が大文字で、残りの文字が小文字であるテキストを返します。

capitalize("hello world") は Hello World を返します。

contains(Text, Text)

ブール値

テキストに指定したテキストが含まれていることを確認します。

endsWith(Text, Text)

ブール値

indexOf(Text, Text)

整数

integer(Text)

整数

isEmpty(Text)

ブール値

isEmpty("") は true を返します。

isEmpty("hello") は false を返します。

lastIndexOf(Text, Text)

整数

指定したサブテキストが最後に現れた位置を返します。

"abcdbc".lastIndexOf("bc") は 4 を返します。

サブテキストが見つからない場合、この関数は -1 を返します。

length(Text)

整数

記号の数を計算して、テキストの長さを返します。

matches(text: Text, regex: Text)

ブール値

テキストが正規表現に一致するかどうかをチェックします。

matches("My phone number is 123-45-678", "(.*)( \\d{3}-\\d{2}-\\d{3})") は true を返します。

最後に A を 1 つ追加すると、matches("0000000000000000000000", "(0*)*A") のようにほぼ即座に true を返します。

エクスプレッションを変更するたびに、以前の評価が取り消され (まだ実行中の場合)、新しい評価が開始されます。

number(Text)

数値

password(Text)

パスワード

テキストをパスワードに変換します。これは、ロボットの開発中にアプリケーションにログインする際にパスワードが必要な場合に役立ちます。セキュリティ上の理由から、この関数を本番環境で使用しないでください。

removeNonPrintable(Text)

テキスト

印刷不可文字を含まないテキストを返します。

removeNonPrintable("Text with non-printable characters")

replaceAll(text: Text, regex: Text, replacement: Text)*

正規表現に一致するすべてのサブテキストを、指定された置換文字に置き換えます。

正規表現は、$ を使用した複数の一致検索および参照をサポートしています。

円記号をエスケープする必要があることに注意してください。

startsWith(Text, Text)

ブール値

substring(Text, Integer)

テキスト

substring(Text, Integer, Integer)

テキスト

toJSON(Text)

テキスト

toLowerCase(Text)

テキスト

toUpperCase(Text)

テキスト

trim(Text)

テキスト

テキスト文字列の両端から、スペースと空白文字をすべて削除します。

unquote(text: Text)

テキスト

テキストから引用符を除去します。

dateTime()

DateTime

現在の日付 (年、月、日)、時刻 (時、分、秒)、オフセット、および zoneID を返します。

dateTime(date: Date, time: Time)

DateTime

指定の日付と時刻を返します。

例

dateTime(date(2022, 1, 10), time(12, 0, 5)) は、日付 (年 = 2022、月 = 1、日 = 10)、時刻 (時 = 12、分 = 0、秒 = 5、ナノ秒 = 0)、zoneID = "[DateTime のタイム ゾーン]" を返します。

dateTime(date: Date, time: Time, zone: Text)

DateTime

指定した日付、時刻、およびタイム ゾーン ID またはオフセットを返します。

例

dateTime(date(2010,11,08), time(12,44,00), zoneId(Dublin))

dateTime(text: Text, pattern: Text)

DateTime

コンピュータのデフォルトのロケールを使用して、Text 値を DateTime 値に変換します。

例

dateTime("2022-01-02 12:30", "yyyy-MM-dd HH:mm")

dateTime(text: Text, pattern: Text, locale: Text)

DateTime

パターンとロケールを使用して、テキストから DateTime 値を作成します。

例

dateTime("January 1, 2022 12:30", "MMMM d, yyyy HH:mm ", "en-US").

dateTime(text: Text, pattern: Text, defaultDate: Date)

DateTime

パターンと、テキストに日付が含まれていない場合に使用するデフォルトの日付を使用して、Text 値を DateTime 値に変換します。

例

dateTime("12:30", "HH:mm", date())

ここで、日付は現在の日付です。

dateTime(text: Text, pattern: Text, dafaultDate: Date, locale: Text)

DateTime

パターン、デフォルトの日付、およびロケールを使用して、テキストから DateTime 値を作成します。パターンによってテキストと日付が一致する場合はロケールが使用され、デフォルトの日付は使用されません。テキストに日付が含まれていない場合は、デフォルトの日付が使用されます。

例

offset(dateTime: DateTime)

テキスト

DateTime 値のオフセットを返します。

例

offset(dateTime()) は、使用しているコンピュータにおける現在の日付のオフセットを +01:00 のような形で返します。

zoneId(dateTime: DateTime)

テキスト

DateTime 値のタイム ゾーンを返します。

例

zoneId(dateTime()) は、現在の日付の zoneID の値を Europe/Paris のような形で返します。

withYears(dateTime: DateTime, years: Integer)

DateTime

年を変更した日付と時刻を新たに返します。

例

dateTime(date(2021, 7, 20), time(12, 13, 14)).withYears(2022) は、年が 2022 である DateTime 値を返します。

withMonth(dateTime: DateTime, months: Integer)

DateTime

月を変更した日付と時刻を新たに返します。例については、「withYears」を参照してください。

withDay(dateTime: DateTime, days: Integer)

DateTime

日を変更した日付と時刻を新たに返します。例については、「withYears」を参照してください。

withHour(dateTime: DateTime, hours: Integer)

DateTime

時間を変更した日付と時刻を新たに返します。例については、「withYears」を参照してください。

withMinute(dateTime: DateTime, minutes: Integer)

DateTime

分を変更した日付と時刻を新たに返します。例については、「withYears」を参照してください。

withSecond(dateTime: DateTime, seconds: Integer)

DateTime

秒を変更した日付と時刻を新たに返します。例については、「withYears」を参照してください。

withNano(dateTime: DateTime, nanos: Integer)

DateTime

ナノ秒を変更した日付と時刻を新たに返します。例については、「withYears」を参照してください。

withOffset(dateTime: DateTime, offset: Text)

DateTime

指定したオフセットの日付と時刻を新たに返します。オフセットを変更すると、オフセットとゾーン ID が互いに矛盾しないように、ゾーン ID が変更される場合があります。

例 (オフセットが +1 の場合)

withOffset(dateTime(), "+3") は、オフセットが +3 の時刻を返します。これは、時刻が現在の時刻よりも 2 時間進んでいることを意味します。また、ゾーン ID は UTC +03:00 (ヨーロッパ/モスクワ) に変更されます。

withZoneId(dateTime: DateTime, zoneID: Text)

DateTime

指定したタイム ゾーンの日付と時刻を新たに返します。ゾーン ID を変更すると、ゾーン ID とオフセットが互いに矛盾しないように、オフセットが変更される場合があります。

例

withZoneId(dateTime(), "Europe/Moscow") は、指定されたゾーン ID における現在の時刻を返します。

plusYears(dateTime: DateTime, amount: Integer)

DateTime

指定した年数を加えた日付と時刻を新たに返します。

例

dateTime(date(2021, 7, 20), time(12, 13, 14)).plusYears(1) は、ロボットが実行されるタイムゾーンにおける、日時 2022-07-22 12:13:14.0 の DateTime 値を返します。

plusMonths(dateTime: DateTime, amount: Integer)

DateTime

指定した月数を加えた日付と時刻を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

plusWeeks(dateTime: DateTime, amount: Integer)

DateTime

指定した週数を加えた日付と時刻を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

plusDays(dateTime: DateTime, amount: Integer)

DateTime

指定した日数を加えた日付と時刻を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。

plusDays(70) を使用した次の例では、3 月は 31 日、4 月は 30 日あるという前提に基づき、まず 3 月 4 日に 27 日を追加し、さらに残りの 43 日を追加して 5 月 13 日としています。

例

dateTime(date(2022, 3, 4), time(12, 13, 14)).plusDays(70) は、日付 (年 = 2022、月 = 5、日 = 13)、時刻 (時 = 12、分 = 13、秒 = 14、ナノ秒 = 0)、zoneID = "[DateTime のタイム ゾーン]" を返します。

plusHours(dateTime: DateTime, amount: Integer)

DateTime

指定した時間数を加えた日付と時刻を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

plusMinutes(dateTime: DateTime, amount: Integer)

DateTime

指定した分数を加えた日付と時刻を新たに返します。

例

dateTime(date(2022, 7, 20), time(12, 13, 14)).plusMinutes(7) は、日付 (年 = 2022、月 = 7、日 = 20)、時刻 (時間 = 12、分 = 20、秒 = 14、ナノ秒 = 0)、zoneID = "[DateTime のタイム ゾーン]" を返します

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。

plusSeconds(dateTime: DateTime, amount: Integer)

DateTime

指定した秒数を加えた日付と時刻を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

plusNanos(dateTime: DateTime, amount: Integer)

DateTime

指定したナノ秒数を加えた日付と時刻を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

minusYears(dateTime: DateTime, amount: Integer)

DateTime

指定した年数を差し引いた日付と時刻を新たに返します。

例

dateTime(date(2022, 7, 20), time(12, 13, 14)).minusYears(10) は、ロボットが実行されるタイムゾーンにおける、日時 2012-07-22 12:13:14.0 の DateTime 値を返します。

minusMonths(dateTime: DateTime, amount: Integer)

DateTime

指定した月数を差し引いた日付と時刻を新たに返します。

例

minusWeeks(dateTime: DateTime, amount: Integer)

DateTime

指定した週数を差し引いた日付と時刻を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。例については、「minusMonths」を参照してください。

minusDays(dateTime: DateTime, amount: Integer)

DateTime

指定した日数を差し引いた日付と時刻を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。minusDays(20) を使用した次の例では、3 月は 31 日、2 月は 29 日あるという前提に基づき、まず 3 月 14 日から 14 日を差し引き、さらに残りの 6 日を差し引いて 2 月 23 日としています。

例

dateTime(date(2020, 3, 14),time(12, 13, 14)).minusDays(20) は、日付 (年 = 2020、月 = 2、日 = 23)、時刻 (時間 = 12、分 = 13、秒 = 14、ナノ秒 = 0)、zoneID = "[DateTime のタイム ゾーン]" を返します。

minusHours(dateTime: DateTime, amount: Integer)

DateTime

指定した時間数を差し引いた日付と時刻を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"minusDays" を参照してください。

minusMinutes(dateTime: DateTime, amount: Integer)

DateTime

指定した分数を差し引いた日付と時刻を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"minusDays" を参照してください。

minusSeconds(dateTime: DateTime, amount: Integer)

DateTime

指定した秒数を差し引いた日付と時刻を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"minusDays" を参照してください。

minusNanos(dateTime: DateTime, amount: Integer)

DateTime

指定したナノ秒数を差し引いた日付と時刻を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"minusDays" を参照してください。

yearsUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までの年数を計算します。

例

dateTime(date(2022, 1, 20), time(12, 13, 14)).yearsUntil(dateTime(date(3785, 11, 20), time(12, 13, 14))) は 1763 を返します。

monthsUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までの月数を計算します。

例

dateTime(date(2022, 1, 20), time(12, 13, 14)).monthsUntil(dateTime(date(2022, 11, 20), time(12, 13, 14))) は 10 を返します。

daysUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までの日数を計算します。例については、「monthsUntil」を参照してください。

hoursUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までの時間数を計算します。例については、「monthsUntil」を参照してください。

minutesUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までの分数を返します。例については、「monthsUntil」を参照してください。

secondsUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までの秒数を返します。例については、「monthsUntil」を参照してください。

millisUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までのミリ秒数を返します。例については、「monthsUntil」を参照してください。

nanosUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までのナノ秒数を返します。例については、「monthsUntil」を参照してください。

dayOfYear(dateTime: DateTime)

整数

年の日にちを返します。

例

dateTime(date(2022, 3, 1), time(12, 13, 14)).dayOfYear() は日 = 60 を返します

weeksUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までの週数を返します。

例

dateTime(date(2022, 1, 20), time(12, 13, 14)).weeksUntil(dateTime(date(2025, 11, 20), time(12, 13, 14))) は 200 を返します。

text(dateTime: DateTime)

テキスト

DateTime 値をテキスト表現に変換します。

例

text(dateTime()) は、たとえば 2022-02-10T13:46:56.907958+01:00 [ヨーロッパ/パリ] のような形式で現在の日付と時刻を返します。

text(dateTime: DateTime, pattern: Text)

テキスト

DateTime 値を、指定したパターンとロケールに一致するテキスト表現に変換します。パターンは、次のようなさまざまな方法で指定できます。

• "d/M/yyyy HH:mm"

• "d-M-yyyy HH:mm:ss"

例 (DateTime が 2022-12-20T00:30:00+03:00 の場合)

text("d/M/yyyy HH:mm") は 20/12/2022 00:30 を返します。

text(dateTime: DateTime, pattern: Text, locale: Text)

テキスト

指定したパターンとロケールに一致する、DateTime の日付と時刻のテキスト表現を返します。

• パターンは、次のようなさまざまな方法で指定できます。

  • "d/M/yyyy HH:mm"

  • "d-M-yyyy HH:mm:ss"

  • "EEEE MMM d yy HH:mm" (EEEE は完全な曜日を、MMM は 3 文字に省略した月の名前を返します。その他も同様です)

• ロケールは、en-US、fr-FR、ja-JP、ru-RU のように指定します。

例 (現在の日付が 20.12.2021 00:30:00) である場合

text("EEEE MMM d yy HH:mm", "en-US") は Monday Dec 20 21 00:30 を返します。

text("EEE MMMM d yyyy HH:mm", "en-US") は Mon December 20 2021 00:30 を返します。

text("yyyy'年'MM'月'd'日' HH:mm:ss","ja-JP") は 2021年12月20日 00:30:00 を返します。

fromExcelDate(excelDate: Number)

DateTime

DateTime 値を数値として表現された Excel の日付に変換します。

例 (ExcelDate 値が 44969 の場合)

ExcelDate.fromExcelDate() は、year=2023、month=2、day=12 を返します。

toExcelDate(dateTime: DateTime)

Number

DateTime 値を数値として表現された Excel の日付に変換します。

例 (現在の日付が 08.02.2022 18:45:00 である場合)

dateTime().toExcelDate() は 44600.76050844907149439677596092224 を返します。

date()

日付

現在の日付を返します。

date(year: Integer, month: Integer, day: Integer)

日付

指定した年、月、および日の日付を返します。

date(DateTime)

日付

以前に DateTime が指定されていた場合に、DateTime の日付値を返します。

date(text: Text, pattern: Text)

日付

パターンを使用して、Text 値を Date 値に変換します。

例

date("2022-01-02", "yyyy-MM-dd")

date(text: Text, pattern: Text, locale: Text)

日付

パターンとロケールを使用して、Text 値を Date 値に変換します。

例

date("January 1, 2022", "MMMM d, yyyy", "en-US")

year(date: Date)

整数

現在の日付の年を返します。

month(date: Date)

整数

現在の日付の月 (1 ～ 12) を返します。

day(date: Date)

整数

現在の日付の日 (1 ～ 31) を返します。

withYear(date: Date, years: Integer)

日付

年を変更した日付を新たに返します。

例

date(2022, 3, 4).withYear(2037) は、year = 2037、month = 3、day = 4 を返します。

withMonth(date: Date, months: Integer)

日付

月を変更した日付を新たに返します。 date(2022, 3, 4).withMonth(5) は、year = 2022、month = 8、day = 4 を返します。

withDay(date: Date, days: Integer)

日付

日を変更した日付を新たに返します。

例

date(2022, 3, 4).withDay(10) は、year = 2022、month = 3、day = 10 を返します。

plusYears(date: Date, amount: Integer)

日付

指定した年数を加えた日付を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

plusMonths(date: Date, amount: Integer)

日付

指定した月数を加えた日付を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

plusWeeks(date: Date, amount: Integer)

日付

指定した週数を加えた日付を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

plusDays(date: Date, amount: Integer)

日付

指定した日数を加えた日付を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。plusDays(70) を使用した次の例では、3 月は 31 日、4 月は 30 日あるという前提に基づき、まず 3 月 4 日に 27 日を追加し、さらに残りの 43 日を追加して 5 月 13 日としています。

例

date(2022, 3, 4).plusDays(70) は、year = 2022、month = 5、day = 13 を返します。

minusYears(date: Date, amount: Integer)

日付

指定した年数を差し引いた日付を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。

date(2022, 3, 14).minusYears(20) は、year = 2002、month = 3、day = 14 を返します。

minusMonths(date: Date, amount: Integer)

日付

指定した月数を差し引いた日付を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"minusDays" を参照してください。

minusWeeks(date: Date, amount: Integer)

日付

指定した週数を差し引いた日付を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"minusDays" を参照してください。

minusDays(date: Date, amount: Integer)

日付

指定した日数を差し引いた日付を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。minusDays(20) を使用した次の例では、3 月は 31 日、2 月は 29 日あるという前提に基づき、まず 3 月 14 日から 14 日を差し引き、さらに残りの 6 日を差し引いて 2 月 23 日としています。

例

date(2022, 3, 14).minusDays(20) は、年 = 2022、月 = 2、日 = 23 を返します。

yearsUntil(from: Date, to: Date)

整数

最初の Date 引数から 2 番目 の Date 引数までの年数を返します。

例 (現在の年が 2022 年である場合)

date().yearsUntil(date(2023, 11, 12)) は 1 を返します。

monthsUntil(from: Date, to: Date)

整数

最初の Date 引数から 2 番目 の Date 引数までの月数を返します。例については、「yearsUntil」を参照してください。

daysUntil(from: Date, to: Date)

整数

最初の Date 引数から 2 番目 の Date 引数までの日数を返します。例については、「yearsUntil」を参照してください。

weeksUntil(from: Date, to: Date)

整数

最初の Date 引数から 2 番目 の Date 引数までの週数を返します。例については、「yearsUntil」を参照してください。

isLeapYear(date: Date)

ブール値

年がうるう年の場合は「true」を返し、そうでない場合は「false」を返します。

例

date(2020, 3, 4).isLeapYear は、2020 年がうるう年であったため、true を返します。

text(date: Date)

テキスト

Date 値をテキスト表現に変換します。

例

text(date(2000, 12, 25)) は 2000-12-25 を返します。

text(date: Date, pattern: Text)

テキスト

Date 値を、指定したパターンに一致するテキスト表現に変換します。

例

text(date(2000, 12, 25), "M/YY/d") は 12/00/25 を返します。

text(date: Date, pattern: Text, locale: Text)

テキスト

Date 値を、指定したパターンとロケールに一致するテキスト表現に変換します。

例

text(date(2023, 12, 12), "MMMM d, yyyy", "de-DE") は Dezember 12, 2023. を返します。

time()

時刻

現在の時刻を返します。

time(hours: Integer, minutes: Integer, seconds: Integer)

時刻

指定した時、分、および秒の時刻を返します。

time(hours: Integer, minutes: Integer, seconds: Integer, nanos: Integer)

時刻

指定した時、分、秒、およびナノ秒の時刻を返します。

time(dateTime: DateTime)

時刻

以前に DateTime が指定されていた場合に、DateTime の時刻値を返します。

time(text: Text, pattern: Text, locale: Text)

時刻

指定したパターンとロケールを使用して、Text 値をTime 値に変換します。

例

time("January 1, 2022 12:30", "MMMM d, yyyy hh:mm a", "en-US")

hour(time: Time)

整数

現在の時刻の時間を返します。

minute(time: Time)

整数

現在の時刻の分を返します。

second(time: Time)

整数

現在の時刻の秒を返します。

nanosecond(time: Time)

整数

現在の時刻のナノ秒を返します。

withHour(time: Time, hours: Integer)

時刻

時間を変更した時刻を新たに返します。

例

time(14, 50, 45).withHour(2) は、時 = 2、分 = 50、秒 = 45、ナノ秒 = 0 を返します。

withMinute(time: Time, minutes: Integer)

時刻

分を変更した時刻を新たに返します。例については、「withHour」を参照してください。

withSecond(time: Time, seconds: Integer)

時刻

秒を変更した時刻を新たに返します。例については、「withHour」を参照してください。

withNano(time: Time, nanos: Integer)

時刻

ナノ秒を変更した時刻を新たに返します。例については、「withHour」を参照してください。

plusHours(time: Time, amount: Integer)

時刻

指定した時間数を加えた時刻を新たに返します。

例

time(14, 50, 45).plusHours(2) は、時 = 16、分 = 50、秒 = 45、ナノ秒 = 0 を返します。

plusMinutes(time: Time, amount: Integer)

時刻

指定した分数を加えた時刻を新たに返します。例については、「plusHours」を参照してください。

plusSeconds(time: Time, amount: Integer)

時刻

指定した秒数を加えた時刻を新たに返します。例については、「plusHours」を参照してください。

plusNanos(time: Time, amount: Integer)

時刻

指定したナノ秒数を加えた時刻を新たに返します。例については、「plusHours」を参照してください。

minusHours(time: Time, amount: Integer)

時刻

指定した時間数を差し引いた時刻を新たに返します。

例

time(14, 50, 45).minusHours(2) は、時 = 12、分 = 50、秒 = 45、ナノ秒 = 0 を返します。

minusMinutes(time: Time, amount: Integer)

時刻

指定した分数を差し引いた時刻を新たに返します。例については、「minusHours」を参照してください。

minusSeconds(time: Time, amount: Integer)

時刻

指定した秒数を差し引いた時刻を新たに返します。例については、「minusHours」を参照してください。

minusNanos(time: Time, amount: Integer)

時刻

指定したナノ秒数を差し引いた時刻を新たに返します。例については、「minusHours」を参照してください。

hoursUntil(from: Time, to: Time)

整数

最初の Time 引数から 2 番目の Time 引数までの時間数を返します。

例

time(9, 41, 35).hoursUntil(time(15, 34, 12)) は 5 を返します。

minutesUntil(from: Time, to: Time)

整数

最初の Time 引数から 2 番目の Time 引数までの分数を返します。例については、「hoursUntil」を参照してください。

secondsUntil(from: Time, to: Time)

整数

最初の Time 引数から 2 番目の Time 引数までの秒数を返します。例については、「hoursUntil」を参照してください。

millisUntil(from: Time, to: Time)

整数

最初の Time 引数から 2 番目の Time 引数までのミリ秒数を返します。例については、「hoursUntil」を参照してください。

nanosUntil(from: Time, to: Time)

整数

最初の Time 引数から 2 番目の Time 引数までのナノ秒数を返します。例については、「hoursUntil」を参照してください。

toSecondsOfDay(time: Time)

整数

時刻を秒に変換します。

例

time(1, 0, 0).toSecondsOfDay() は 3600 を返します。

toNanosOfDay(time: Time)

整数

時刻をナノ秒に変換します。

例

time(1, 0, 0).toNanosOfDay() は 3600000000000 を返します。

text(time: Time)

テキスト

Time 値をテキスト表現に変換します。

例

text(time: Time, pattern: Text)

テキスト

Time 値を、指定したパターンに一致するテキスト表現に変換します。

例

text(time(10, 15, 00), "hh:m a") は 10:15 AM を返します。

text(time: Time, pattern: Text, locale: Text)

テキスト

Time 値を、指定したパターンとロケールに一致するテキスト表現に変換します。

例

text(time(10, 15, 00), "hh:m a", "de-DE") は 10:15 vorm を返します。

ampersandEncode(text: Text)

テキスト

テキストをアンバンサンド エンコードします。

例

ampersandEncode("&") は &amp; を返します。

ampersandDecode(text: Text)

テキスト

テキストをアンバンサンド デコードします。

例

ampersandDecode("&gt;") は > を返します。

base64Encode(binary: Binary)

テキスト

MIME (RFC 2045) 用の Base64 転送エンコードを使用する Base64 エンコード。

例

binary.base64Encode()。ここで、binary はバイナリ値を持つ変数です。

base64Decode(text: Text)

バイナリ

MIME (RFC 2045) 用の Base64 転送エンコードを使用する Base64 デコード。

例

base64Decode("SGVsbG8=").text("UTF8") は Hello を返します。

boolean(text: Boolean)

ブール値

テキストは「true」または「false」のいずれかに一致する必要があります。

例

boolean(false:Boolean) は false を返します。

integer(Number)

整数

数値は 1.0 などの整数値である必要があります。

integer(Text)

整数

テキストは、"42" などの整数のテキスト表現である必要があります。

number(Integer)

数値

Number(17) は 17.0 を返します。

number(Text)

数値

テキストは、"17.7" などの数字のテキスト表現である必要があります。

text(Integer)

テキスト

text(Number)

テキスト

text(Boolean)

テキスト

text(binary: Binary, charsetName: Text)

テキスト

テキストの二進表現をテキスト タイプの値に変換します。UTF8 などの文字セットを引数として指定します。

binary(text: Text, charsetName: Text)

バイナリ

テキスト値をバイナリ値に変換します。UTF8 などの文字セットを引数として指定します。

例

"Hello".binary("UTF8").text("UTF8") は Hello を返します。ここで、 "Hello".binary("UTF8") は UTF8 文字エンコードを使用してエンコードされたバイナリ値に評価されます。例のようにバイナリ値がテキストに変換される場合、バイナリ値は同じ文字エンコード (この場合は UTF8) を使用してエンコードする必要があります。

toJSON()

パスワード以外のあらゆるタイプの値を、JSON オブジェクトとしてフォーマットされたテキスト値に変換します。パスワード タイプ属性を含むレコード タイプは JSON に変換できません。

変換された値の例

• 5 は "5" となります

• 1.2 は "1.2" となります

• true は "true" となります

• "Hello" は "\"Hello\"" となります

• バイナリ値は、バイナリ値の Base 64 エンコードになります

• レコード値、R(a = 5, b = true, t = "Hello") は "{\"a\":5,\"b\":true,\"t\":\"Hello\"" となります

toJSON 関数は、[1,2,3] のような配列を生成することはありせん。ロボットで JSON 値を使用する場合は、文字列を連結することによりリストを作成できます。このようにすると、ロボットからベーシック エンジン ロボットに値を返すことができます。

詳細については、JSON の使用を参照してください。

bin は "Hello".binary("ASCII") の結果のバイナリ値を保持している変数です

• "true".boolean()
• "false".boolean()
• "False".boolean()

• Boolean true

• Boolean false

• 「true」または「false」のいずれにも一致しないため、ConversionIssue 例外をスローします

• integer(2.0) または 2.0.integer()

• integer("2") または "2".integer

• number(2) または 2.number()

• number("2") または "2".number()

ここで "Hello".binary("UTF8") は UTF8 文字エンコードを使用してエンコードされたバイナリ値と評価します。例のようにバイナリ値がテキストに変換される場合、バイナリ値は同じ文字エンコード (この場合は UTF8) を使用してエンコードする必要があります。

ここで"Company"はテキストタイプ、整数タイプ、ブールのフィールド タイプを含むレコード タイプの変数です。

次の値のテキスト値:

{"name":"Acme Corp.", "url":"www.acme-corp.com", "revenue":1000000000, "CEO":"Marvin Acme", "fictional":true}